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

Artikel
02/29/2024

Die Graphics::GetClipBounds-Methode ruft ein Rechteck ab, das den Clippingbereich dieses Graphics-Objekts umschließt.

Syntax

Status GetClipBounds(
  RectF *rect
);

Parameter

rect

Zeiger auf ein RectF-Objekt , das das Rechteck empfängt, das den Clippingbereich umschließt.

Rückgabewert

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_GetClipBounds2(HDC hdc)
{
   Graphics graphics(hdc);

   Region   myRegion(RectF(25.0f, 25.0f, 100.0f, 50.0f));
   RectF    rect(40.0f, 60.0f, 100.0f, 50.0f);
   Region   gRegion;
   RectF    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);}