Graphics::SetClip(HRGN,CombineMode)-Methode (gdiplusgraphics.h)
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 |