SelectClipPath-Funktion (wingdi.h)

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

Weitere Informationen

BeginPath

Beschneidungsfunktionen

Übersicht über clipping

EndPath