Graphics::GetClipBounds(Rect*)-Methode (gdiplusgraphics.h)

Artikel
02/26/2024

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