Metodo Graphics::GetClipBounds(RectF*) (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(
  RectF *rect
);

Parametri

rect

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

Valore restituito

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

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

Commenti

La trasformazione mondiale 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 di grandi dimensioni. I membri dati X e Y di tale rettangolo sono numeri negativi di grandi dimensioni e i membri dei dati Width e Height sono numeri positivi di grandi dimensioni.

Esempio

Nell'esempio seguente viene impostata un'area di ritaglio, ottiene il rettangolo che racchiude l'area di ritaglio e quindi riempie il rettangolo.

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