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

Artikel
08/24/2023

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

Optional. 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 nur vorübergehend transformiert. Die Transformation wird lediglich während der Berechnung des umschließenden Rechtecks verwendet. Der Standardwert ist NULL.

pen

Optional. Zeiger auf ein Pen-Objekt , das die Größe des umgebenden Rechtecks beeinflusst. Das in Begrenzungen empfangene begrenzungsgebundene Rechteck ist groß genug, um diesen Pfad einzuschließen, wenn der Pfad mit dem von diesem Parameter angegebenen Stift gezeichnet wird. Dadurch wird sichergestellt, dass der Pfad vom umgebenden 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, gibt sie OK zurück, ein Element der Status-Enumeration .

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

Hinweise

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 Gehrungsgrenze des Stifts an scharfen Ecken 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)