Graphics::GetClipBounds(Rect*)-Methode (gdiplusgraphics.h)
Die Graphics::GetClipBounds-Methode ruft ein Rechteck ab, das den Clippingbereich dieses Graphics-Objekts umschließt.
Syntax
Status GetClipBounds(
[out] Rect *rect
);
Parameter
[out] rect
Typ: Rect*
Zeiger auf ein Rect-Objekt , das das Rechteck empfängt, das den Clippingbereich umschließt.
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
Die Welttransformation wird auf den Clippingbereich angewendet, und dann wird das einschließende Rechteck berechnet.
Wenn Sie den Beschneidungsbereich eines Graphics-Objekts nicht explizit festlegen, ist dessen Beschneidungsbereich unendlich. Wenn der Clippingbereich unendlich ist, gibt Graphics::GetClipBounds ein großes Rechteck zurück. Die X - und Y-Datenmember dieses Rechtecks sind große negative Zahlen, und die Datenmember Width und Height sind große positive Zahlen.
Beispiele
Im folgenden Beispiel wird ein Beschneidungsbereich festgelegt, das Rechteck abgerufen, das den Clippingbereich umschließt, und dann das Rechteck ausgefüllt.
VOID Example_GetClipBounds(HDC hdc)
{
Graphics graphics(hdc);
Region myRegion(Rect(25, 25, 100, 50));
Rect rect(40, 60, 100, 50);
Region gRegion;
Rect enclosingRect;
SolidBrush blueBrush(Color(100, 0, 0, 255));
Pen greenPen(Color(255, 0, 255, 0), 1.5f);
// Modify the region by using a rectangle.
myRegion.Union(rect);
// Set the clipping region of the graphics object.
graphics.SetClip(&myRegion);
// Now, get the clipping region, and fill it.
graphics.GetClip(&gRegion);
graphics.FillRegion(&blueBrush, &gRegion);
// Get a rectangle that encloses the clipping region, and draw the enclosing
// rectangle.
graphics.GetClipBounds(&enclosingRect);
graphics.ResetClip();
graphics.DrawRectangle(&greenPen, enclosingRect);}
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 |