Partager via


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