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

Article
03/02/2024

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

Syntaxe

Status GetClipBounds(
  [out] Rect *rect
);

Paramètres

[out] rect

Type : Rect*

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

Valeur retournée

Type : État

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 zone 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 zone de découpage, puis remplit le rectangle.

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP, Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	gdiplusgraphics.h (include Gdiplus.h)
Bibliothèque	Gdiplus.lib
DLL	Gdiplus.dll