Partager via


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

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

Voir aussi

Découpage

Découpage avec une région

Méthodes GetVisibleClipBounds

Graphismes

Graphics ::GetClip

Rect

SetClip, méthodes

État