Graphics::SetClip(constRegion*,CombineMode)-Methode (gdiplusgraphics.h)

Die Graphics::SetClip-Methode aktualisiert den Beschneidungsbereich dieses Graphics-Objekts in einen Bereich, der die Kombination aus sich selbst und dem durch ein Region-Objekt angegebenen Bereich darstellt.

Syntax

Status SetClip(
  [in] const Region *region,
  [in] CombineMode  combineMode
);

Parameter

[in] region

Typ: const Region*

Zeiger auf ein Region-Objekt , das den Bereich angibt, der mit dem Beschneidungsbereich dieses Graphics-Objekts kombiniert werden soll.

[in] combineMode

Typ: CombineMode

Optional. Element der CombineMode-Enumeration , das angibt, wie der angegebene Bereich mit dem Clippingbereich dieses Graphics-Objekts kombiniert wird. Der Standardwert ist CombineModeReplace.

Rückgabewert

Typ: Status

Wenn die Methode erfolgreich ist, gibt sie OK zurück, ein Element der Status-Enumeration .

Wenn die Methode fehlschlägt, wird eines der anderen Elemente der Status-Enumeration zurückgegeben.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP, Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile gdiplusgraphics.h (include Gdiplus.h)
Bibliothek Gdiplus.lib
DLL Gdiplus.dll

Weitere Informationen

Freistellen

Beschneiden mit einer Region

Combinemode

GetClipBounds-Methoden

Grafiken

Graphics::GetClip

Graphics::IsClipEmpty

Graphics::ResetClip

IntersectClip-Methoden

Region

TranslateClip-Methoden