Estrutura CLIPOBJ (winddi.h)

  • Artigo

A estrutura CLIPOBJ descreve a região de clipe usada ao desenhar.

Sintaxe

typedef struct _CLIPOBJ {
  ULONG iUniq;
  RECTL rclBounds;
  BYTE  iDComplexity;
  BYTE  iFComplexity;
  BYTE  iMode;
  BYTE  fjOptions;
} CLIPOBJ;

Membros

iUniq

Especifica um valor que identifica exclusivamente a região do clipe. Se iUniq não for zero, o driver o usará como um identificador de cache. Isso permite que o driver reconheça uma região depois de baixá-la e em cache. Se o valor for zero, o driver não deverá armazenar em cache a região porque a região não será usada novamente.

rclBounds

Especifica uma estrutura RECTL que vincula a parte da região que cruza o desenho. Se iDComplexity for DC_RECT, esse será o retângulo de recorte a ser considerado.

iDComplexity

Especifica a complexidade da parte da região que se cruza com o desenho. Esse membro deve ser um dos seguintes valores:

Valor Significado
DC_COMPLEX A região do clipe deve ser enumerada.
DC_RECT Recortar para um único retângulo.
DC_TRIVIAL O recorte não precisa ser considerado; desenhar a figura inteira.

iFComplexity

Especifica a complexidade de toda a região. Esse valor é usado pelo driver para decidir se deseja armazenar em cache a região. CLIPOBJ_cEnumStart pode ser chamado para determinar o número exato de retângulos na região. Esse membro pode ser um dos seguintes valores:

Valor Significado
FC_COMPLEX A região consiste em mais de quatro retângulos.
FC_RECT A região é um único retângulo.
FC_RECT4 A região consiste, no máximo, em quatro retângulos.

iMode

Especifica como a região é armazenada pelo GDI. Isso pode ajudar o driver a determinar como enumerar a região. Esse membro pode ser um dos seguintes valores:

Valor Significado
TC_PATHOBJ A região é armazenada como um caminho.
TC_RECTANGLES A região é armazenada como retângulos.

fjOptions

Especifica as opções de recorte. Esse membro pode ser o seguinte valor:

Valor Significado
OC_BANK_CLIP Obsoleto. Indica um retorno de chamada do mecanismo para um dispositivo bancário.

Comentários

A região, descrita por CLIPOBJ, pode ser enumerada como uma série de retângulos.

Requisitos

   
Cabeçalho winddi.h (inclua Winddi.h)

Confira também

CLIPOBJ_bEnum

CLIPOBJ_cEnumStart

RECTL