Graphics ::GetClipBounds(RectF*), méthode (gdiplusgraphics.h)

Article
02/26/2024

La méthode Graphics ::GetClipBounds obtient un rectangle qui entoure la zone de découpage de cet objet Graphics .

Syntaxe

Status GetClipBounds(
  RectF *rect
);

Paramètres

rect

Pointeur vers un objet RectF qui reçoit le rectangle qui entoure la zone de découpage.

Valeur retournée

Si la méthode réussit, elle retourne Ok, qui est un élément de l’énumération Status .

Si la méthode échoue, elle retourne l’un des autres éléments de l’énumération Status .

Remarques

La transformation du monde est appliquée à la région de découpage, puis le rectangle englobant est calculé.

Si vous ne définissez pas explicitement la zone de découpage d’un objet Graphics , sa zone de découpage est infinie. Lorsque la zone de découpage est infinie, Graphics ::GetClipBounds retourne un grand rectangle. Les membres de données X et Y de ce rectangle sont de grands nombres négatifs, et les membres de données Width et Height sont de grands nombres positifs.

Exemples

L’exemple suivant définit une zone de découpage, obtient le rectangle qui entoure la région de découpage, puis remplit le rectangle.

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);}