Graphics::SetClip(constRect&,CombineMode)-Methode (gdiplusgraphics.h)

Die Graphics::SetClip-Methode aktualisiert den Clippingbereich dieses Graphics-Objekts in einen Bereich, der die Kombination aus sich selbst und einem Rechteck darstellt.

Syntax

Status SetClip(
  [in, ref]      const Rect & rect,
  [in, optional] CombineMode  combineMode
);

Parameter

[in, ref] rect

Typ: const Rect

Verweis auf ein Rechteck, das mit dem Beschneidungsbereich dieses Graphics-Objekts kombiniert werden soll.

[in, optional] combineMode

Typ: CombineMode

Element der CombineMode-Enumeration , das angibt, wie das angegebene Rechteck 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

   
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

Rect

TranslateClip-Methoden