Fonction ExtSelectClipRgn (wingdi.h)

La fonction ExtSelectClipRgn combine la région spécifiée avec la région de découpage actuelle à l’aide du mode spécifié.

Syntaxe

int ExtSelectClipRgn(
  [in] HDC  hdc,
  [in] HRGN hrgn,
  [in] int  mode
);

[in] hdc

Handle pour le contexte de l’appareil.

[in] hrgn

Handle de la région à sélectionner. Ce handle ne doit pas être NULL , sauf si le mode RGN_COPY est spécifié.

[in] mode

Opération à effectuer. Il doit s’agir de l’une des valeurs suivantes.

Valeur	Signification
RGN_AND	La nouvelle région de découpage combine les zones qui se chevauchent de la région de découpage actuelle et de la région identifiée par hrgn.
RGN_COPY	La nouvelle région de découpage est une copie de la région identifiée par hrgn. Ceci est identique à SelectClipRgn. Si la région identifiée par hrgn est NULL, la nouvelle région de découpage est la région de découpage par défaut (la région de découpage par défaut est une région Null).
RGN_DIFF	La nouvelle région de découpage combine les zones de la région de découpage actuelle avec les zones exclues de la région identifiée par hrgn.
RGN_OR	La nouvelle région de découpage combine la région de découpage actuelle et la région identifiée par hrgn.
RGN_XOR	La nouvelle région de découpage combine la région de découpage actuelle et la région identifiée par hrgn , mais exclut les zones qui se chevauchent.

La valeur de retour spécifie la complexité de la nouvelle région de découpage ; il peut s’agir de l’une des valeurs suivantes.

Code de retour	Description
NULLREGION	La région est vide.
SIMPLEREGION	Region est un rectangle unique.
COMPLEXREGION	La région est plusieurs rectangles.
ERROR	Une erreur est survenue.

Si une erreur se produit lorsque cette fonction est appelée, la zone de découpage précédente pour le contexte d’appareil spécifié n’est pas affectée.

La fonction ExtSelectClipRgn suppose que les coordonnées de la région spécifiée sont spécifiées en unités d’appareil.

Seule une copie de la région identifiée par le paramètre hrgn est utilisée. La région elle-même peut être réutilisée après cet appel ou supprimée.

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wingdi.h (inclure Windows.h)
Bibliothèque	Gdi32.lib
DLL	Gdi32.dll