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

2023-08-24

Die Graphics::SetClip-Methode aktualisiert den Beschneidungsbereich dieses Grafikobjekts in einen Bereich, der die Kombination aus sich selbst und einem GDI-Bereich (Windows Graphics Device Interface) darstellt.

Syntax

Status SetClip(
  [in] HRGN        hRgn,
  [in] CombineMode combineMode
);

Parameter

[in] hRgn

Typ: HRGN

Handle für einen GDI-Bereich, der mit dem Beschneidungsbereich dieses Graphics-Objekts kombiniert werden soll. Dies wird für Legacycode bereitgestellt. Neue Anwendungen sollten ein Region-Objekt als ersten Parameter übergeben.

[in] combineMode

Typ: CombineMode

Optional. Element der CombineMode-Enumeration , das angibt, wie der GDI-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.

Hinweise

Bei dieser Methode wird davon ausgegangen, dass sich der von hRgn angegebene GDI-Bereich bereits in Geräteeinheiten befindet, sodass die Koordinaten der GDI-Region nicht transformiert werden.

Beispiele

Im folgenden Beispiel wird eine GDI-Region verwendet, um den Beschneidungsbereich zu aktualisieren.

VOID Example_SetClip2(HDC hdc)
{
   Graphics graphics(hdc);

   // Create a Region object, and get its handle.
   Region region(Rect(0, 0, 100, 100));
   HRGN hRegion = region.GetHRGN(&graphics);

   // Set the clipping region with hRegion.
   graphics.SetClip(hRegion);

   // Fill a rectangle to demonstrate the clipping region.
   graphics.FillRectangle(&SolidBrush(Color(255, 0, 0, 0)), 0, 0, 500, 500);
}

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