Estrutura CLIPOBJ (winddi.h)
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) |