SelectClipPath-Funktion (wingdi.h)

Artikel
03/09/2024

Die SelectClipPath-Funktion wählt den aktuellen Pfad als Beschneidungsbereich für einen Gerätekontext aus und kombiniert den neuen Bereich mit einem vorhandenen Clippingbereich im angegebenen Modus.

Syntax

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

Parameter

[in] hdc

Ein Handle für den Gerätekontext des Pfads.

[in] mode

Die Art der Verwendung des Pfads. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
RGN_AND	Der neue Beschneidungsbereich umfasst die Schnittmenge (überlappende Bereiche) des aktuellen Beschneidungsbereichs und den aktuellen Pfad.
RGN_COPY	Der neue Clippingbereich ist der aktuelle Pfad.
RGN_DIFF	Der neue Beschneidungsbereich umfasst die Bereiche des aktuellen Beschneidungsbereichs, wobei die Bereiche des aktuellen Pfads ausgeschlossen sind.
RGN_OR	Der neue Beschneidungsbereich umfasst die Union (kombinierte Bereiche) des aktuellen Beschneidungsbereichs und den aktuellen Pfad.
RGN_XOR	Der neue Beschneidungsbereich umfasst die Vereinigung des aktuellen Beschneidungsbereichs und des aktuellen Pfads, jedoch ohne die überlappenden Bereiche.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.

Hinweise

Der durch den hdc-Parameter identifizierte Gerätekontext muss einen geschlossenen Pfad enthalten.

Beispiele

Ein Beispiel finden Sie unter Verwenden von Clipping.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wingdi.h (windows.h einschließen)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll