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 |