Metodo Graphics::GetClipBounds(Rect*) (gdiplusgraphics.h)

Articolo
02/26/2024

Il metodo Graphics::GetClipBounds ottiene un rettangolo che racchiude l'area di ritaglio di questo oggetto Graphics .

Sintassi

Status GetClipBounds(
  [out] Rect *rect
);

Parametri

[out] rect

Tipo: Rect*

Puntatore a un oggetto Rect che riceve il rettangolo che racchiude l'area di ritaglio.

Valore restituito

Tipo: Stato

Se il metodo ha esito positivo, restituisce Ok, che è un elemento dell'enumerazione Status .

Se il metodo ha esito negativo, restituisce uno degli altri elementi dell'enumerazione Status .

Commenti

La trasformazione globale viene applicata all'area di ritaglio e quindi viene calcolato il rettangolo di inclusione.

Se non si imposta in modo esplicito l'area di ritaglio di un oggetto Graphics , l'area di ritaglio è infinita. Quando l'area di ritaglio è infinita, Graphics::GetClipBounds restituisce un rettangolo grande. I membri dati X e Y di tale rettangolo sono numeri negativi di grandi dimensioni e i membri dati Width e Height sono numeri positivi di grandi dimensioni.

Esempio

L'esempio seguente imposta un'area di ritaglio, ottiene il rettangolo che racchiude l'area di ritaglio e quindi riempie il rettangolo.

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP, Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	gdiplusgraphics.h (include Gdiplus.h)
Libreria	Gdiplus.lib
DLL	Gdiplus.dll