SelectClipRgn, fonction (wingdi.h)

La fonction SelectClipRgn sélectionne une région comme région de découpage actuelle pour le contexte d’appareil spécifié.

Syntaxe

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

Paramètres

[in] hdc

Handle vers le contexte de l’appareil.

[in] hrgn

Handle vers la région à sélectionner.

Valeur retournée

La valeur de retour spécifie la complexité de la région et peut être l’une des valeurs suivantes.

Code de retour	Description
NULLREGION	La région est vide.
SIMPLEREGION	La région est un rectangle unique.
COMPLEXREGION	La région est plusieurs rectangles.
ERROR	Une erreur est survenue. (La région de découpage précédente n’est pas affectée.)

Remarques

Seule une copie de la région sélectionnée est utilisée. La région elle-même peut être sélectionnée pour n’importe quel nombre d’autres contextes d’appareil ou peut être supprimée.

La fonction SelectClipRgn part du principe que les coordonnées d’une région sont spécifiées dans les unités d’appareil.

Pour supprimer la région de découpage d’un contexte d’appareil, spécifiez un handle de région NULL .

Exemples

Pour obtenir un exemple, consultez Sortie de découpage.

Configuration requise

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 (include Windows.h)
Bibliothèque	Gdi32.lib
DLL	Gdi32.dll

Voir aussi

Fonctions de découpage

Vue d’ensemble du découpage

ExtSelectClipRgn