Structure CLIPOBJ (winddi.h)

Article
08/27/2023

La structure CLIPOBJ décrit la région de clip utilisée lors du dessin.

Syntaxe

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

Membres

iUniq

Spécifie une valeur qui identifie de manière unique la région de clip. Si iUniq est différent de zéro, le pilote l’utilise comme identificateur de cache. Cela permet au pilote de reconnaître une région après son téléchargement et sa mise en cache. Si la valeur est zéro, le pilote ne doit pas mettre en cache la région, car la région ne sera pas réutilisée.

rclBounds

Spécifie une structure RECTL qui limite la partie de la région qui croise le dessin. Si iDComplexity est DC_RECT, il s’agit du rectangle de découpage à prendre en compte.

iDComplexity

Spécifie la complexité de la partie de la région qui croise le dessin. Ce membre doit être l’une des valeurs suivantes :

Valeur	Signification
DC_COMPLEX	La région de clip doit être énumérée.
DC_RECT	Découpez dans un rectangle unique.
DC_TRIVIAL	Le découpage n’a pas besoin d’être pris en compte; dessiner la figure entière.

iFComplexity

Spécifie la complexité de l’ensemble de la région. Cette valeur est utilisée par le pilote pour décider s’il faut mettre en cache la région. CLIPOBJ_cEnumStart pouvez être appelé pour déterminer le nombre exact de rectangles dans la région. Ce membre peut être l’une des valeurs suivantes :

Valeur	Signification
FC_COMPLEX	La région se compose de plus de quatre rectangles.
FC_RECT	La région est un rectangle unique.
FC_RECT4	La région se compose, au maximum, de quatre rectangles.

iMode

Spécifie la façon dont la région est stockée par GDI. Cela peut aider le pilote à déterminer comment énumérer la région. Ce membre peut être l’une des valeurs suivantes :

Valeur	Signification
TC_PATHOBJ	La région est stockée en tant que chemin d’accès.
TC_RECTANGLES	La région est stockée sous forme de rectangles.

fjOptions

Spécifie les options de découpage. Ce membre peut être la valeur suivante :

Valeur	Signification
OC_BANK_CLIP	Obsolète. Indique un rappel de moteur pour un appareil bancaire.

Remarques

La région, décrite par CLIPOBJ, peut être énumérée sous la forme d’une série de rectangles.

Configuration requise


En-tête	winddi.h (inclure Winddi.h)

Voir aussi

CLIPOBJ_bEnum

CLIPOBJ_cEnumStart

RECTL

Partager via