GraphicsPath::GetBounds(Rect*,constMatrix*,constPen*)-Methode (gdipluspath.h)
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 |