GraphicsPath::GetBounds(Rect,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(
  [out] Rect         *bounds,
  [in]  const Matrix *matrix,
  [in]  const Pen    *pen
);

Parameter

[out] bounds

Typ: Rect*

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

[in] matrix

Typ: const 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.

[in] pen

Typ: const Pen*

Optional. Zeiger auf ein Pen-Objekt , das die Größe des umgebenden Rechtecks beeinflusst. Das in Begrenzungen empfangene begrenzungsfähige 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, gibt sie eines der anderen Elemente der Status-Enumeration zurück.

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

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

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP, Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	gdipluspath.h (include Gdiplus.h)
Bibliothek	Gdiplus.lib
DLL	Gdiplus.dll