GraphicsPath::GetBounds(RectF,constMatrix,constPen*) -Methode (gdipluspath.h)

Artikel
07/16/2024

Die GraphicsPath::GetBounds--Methode ruft ein umgebendes Rechteck für diesen Pfad ab.

Syntax

Status GetBounds(
  RectF        *bounds,
  const Matrix *matrix,
  const Pen    *pen
);

Parameter

bounds

Zeiger auf ein RectF--Objekt, das das umgebende Rechteck empfängt.

matrix

Wahlfrei. Zeiger auf ein Matrix--Objekt, das eine Transformation angibt, die auf diesen Pfad angewendet werden soll, bevor das umgebende Rechteck berechnet wird. Dieser Pfad wird nicht dauerhaft transformiert; die Transformation wird nur während des Prozesses der Berechnung des umgebenden Rechtecks verwendet. Der Standardwert ist NULL-.

pen

Wahlfrei. Zeigen Sie auf ein Pen--Objekt, das die Größe des umgebenden Rechtecks beeinflusst. Das umgebende Rechteck, das in Grenzen empfangen wird, ist groß genug, um diesen Pfad einzuschließen, wenn der Pfad mit dem durch diesen Parameter angegebenen Stift gezeichnet wird. Dadurch wird sichergestellt, dass der Pfad durch das umgebende Rechteck eingeschlossen wird, auch wenn der Pfad mit einem breiten Stift gezeichnet wird. Der Standardwert ist NULL-.

Rückgabewert

Typ:Status

Wenn die Methode erfolgreich ist, wird Ok zurückgegeben, bei dem es sich um ein Element der Status Enumeration handelt.

Wenn die Methode fehlschlägt, wird eines der anderen Elemente der Status Enumeration zurückgegeben.

Bemerkungen

Das von dieser Methode zurückgegebene Rechteck ist möglicherweise größer als erforderlich, um den Pfad wie vom angegebenen Stift gezeichnet einzuschließen. Das Rechteck wird berechnet, um die Mitergrenze des Stifts an scharfen Ecken zuzulassen und die Endkappen des Stifts zuzulassen.

Beispiele

Im folgenden Beispiel wird ein Pfad mit einer Kurve und einer Ellipse erstellt. Der Code zeichnet den Pfad mit einem dicken gelben Stift und einem dünnen schwarzen Stift. Die GraphicsPath::GetBounds--Methode empfängt die Adresse des dicken gelben Stifts und berechnet ein umgebendes Rechteck für den Pfad. Anschließend zeichnet der Code das umgebende Rechteck.


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.
   RectF rect;
   path.GetBounds(&rect, NULL, &yellowPen);
   graphics.DrawRectangle(&redPen, rect);  
}

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