Partager via


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
);

Paramètres

[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.

Valeur retournée

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.

Remarques

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.

Configuration requise

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

Voir aussi

Fonctions de découpage

Vue d’ensemble du découpage

SélectionnerClipRgn