Metodo GraphicsPath::GetBounds(Rect,constMatrix,constPen*) (gdipluspath.h)

Articolo
08/24/2023

Il metodo GraphicsPath::GetBounds ottiene un rettangolo di selezione per questo percorso.

Sintassi

Status GetBounds(
  [out] Rect         *bounds,
  [in]  const Matrix *matrix,
  [in]  const Pen    *pen
);

Parametri

[out] bounds

Tipo: Rect*

Puntatore a un oggetto Rect che riceve il rettangolo di selezione.

[in] matrix

Tipo: matrice* const

Facoltativa. Puntatore a un oggetto Matrix che specifica una trasformazione da applicare a questo percorso prima che venga calcolato il rettangolo di selezione. Questo percorso non viene trasformato in maniera permanente e la trasformazione viene utilizzata solo durante il processo di calcolo del rettangolo di delimitazione. Il valore predefinito è NULL.

[in] pen

Tipo: penna const *

Facoltativa. Puntatore a un oggetto Pen che influenza le dimensioni del rettangolo di selezione. Il rettangolo di delimitazione ricevuto nei limiti sarà sufficiente per racchiudere questo percorso quando il percorso viene disegnato con la penna specificata da questo parametro. Ciò garantisce che il percorso sia racchiuso nel rettangolo di delimitamento anche se il percorso viene disegnato con una penna ampia. Il valore predefinito è NULL.

Valore restituito

Tipo: Stato

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

Il rettangolo restituito da questo metodo potrebbe essere maggiore del necessario per racchiudere il percorso come disegnato dalla penna specificata. Il rettangolo viene calcolato per consentire il limite di miter della penna in angoli nitidi e per consentire il limite finale della penna.

Esempio

Nell'esempio seguente viene creato un percorso con una curva e un'ellisse. Il codice disegna il percorso con una penna gialla spessa e una penna nera sottile. Il metodo GraphicsPath::GetBounds riceve l'indirizzo della penna gialla spessa e calcola un rettangolo di selezione per il percorso. Il codice disegna quindi il rettangolo di selezione.

VOID GetBoundsExample(HDC hdc)
{
   Graphics graphics(hdc);
   Pen blackPen(Color(255, 0, 0, 0), 1);
   Pen yellowPen(Color(255, 255, 255, 0), 10);
   Pen redPen(Color(255, 255, 0, 0), 1);

   Point pts[] = {Point(120,120), 
                  Point(200,130), 
                  Point(150,200), 
                  Point(130,180)};

   // Create a path that has one curve and one ellipse.
   GraphicsPath path;
   path.AddClosedCurve(pts, 4);
   path.AddEllipse(120, 220, 100, 40);

   // Draw the path with a thick yellow pen and a thin black pen.
   graphics.DrawPath(&yellowPen, &path);
   graphics.DrawPath(&blackPen, &path);
 
   // Get the path's bounding rectangle.
   Rect rect;
   path.GetBounds(&rect, NULL, &yellowPen);
   graphics.DrawRectangle(&redPen, rect);  
}

Color(255, 0, 0, 0)Color(255, 255, 0,  0)

Requisiti


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	gdipluspath.h (include Gdiplus.h)
Libreria	Gdiplus.lib
DLL	Gdiplus.dll