SelectClipPath, fonction (wingdi.h)

La fonction SelectClipPath sélectionne le chemin d’accès actuel en tant que région de découpage pour un contexte d’appareil, en combinant la nouvelle région avec n’importe quelle région de découpage existante à l’aide du mode spécifié.

Syntaxe

BOOL SelectClipPath(
  [in] HDC hdc,
  [in] int mode
);

Paramètres

[in] hdc

Handle du contexte d’appareil du chemin d’accès.

[in] mode

La façon d’utiliser le chemin d’accès. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
RGN_AND	La nouvelle zone de découpage comprend l’intersection (zones qui se chevauchent) de la zone de découpage actuelle et le chemin d’accès actuel.
RGN_COPY	La nouvelle zone de découpage est le chemin d’accès actuel.
RGN_DIFF	La nouvelle zone de découpage inclut les zones de la zone de découpage actuelle avec celles du chemin d’accès actuel exclues.
RGN_OR	La nouvelle région de découpage inclut l’union (zones combinées) de la région de découpage actuelle et le chemin d’accès actuel.
RGN_XOR	La nouvelle région de découpage inclut l’union de la région de découpage actuelle et du chemin actuel, mais sans les zones qui se chevauchent.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro.

Remarques

Le contexte de l’appareil identifié par le paramètre hdc doit contenir un chemin fermé.

Exemples

Pour obtenir un exemple, consultez Utilisation de la découpage.

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

BeginPath

Fonctions de découpage

Vue d’ensemble du découpage

EndPath