Region::GetBounds(RectF*,constGraphics*)-Methode (gdiplusheaders.h)
Die Region::GetBounds-Methode ruft ein Rechteck ab, das diesen Bereich umschließt.
Syntax
Status GetBounds(
[out] RectF *rect,
[in] const Graphics *g
);
Parameter
[out] rect
Typ: RectF*
Zeiger auf ein RectF-Objekt , das das einschließende Rechteck empfängt.
[in] g
Typ: const Graphics*
Zeiger auf ein Graphics-Objekt , das die Welt- und Seitentransformationen enthält, die zum Berechnen der Gerätekoordinaten dieses Bereichs und des Rechtecks erforderlich sind.
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
Die aktuellen Welt- und Seitentransformationen des Grafikobjekts werden verwendet, um den Bereich und das Rechteck zu berechnen, während sie auf dem Anzeigegerät gezeichnet werden. Das von Region::GetBounds zurückgegebene Rechteck ist nicht immer das kleinste mögliche Rechteck.
Beispiele
Im folgenden Beispiel wird eine Region aus einem Pfad erstellt, das umschließende Rechteck der Region abgerufen und dann beides angezeigt.
VOID Example_GetBoundsRectF(HDC hdc)
{
Graphics graphics(hdc);
Point points[] = {
Point(110, 20),
Point(120, 30),
Point(100, 60),
Point(120, 70),
Point(150, 60),
Point(140, 10)};
GraphicsPath path;
SolidBrush solidBrush(Color(255, 255, 0, 0));
Pen pen(Color(255, 0, 0, 0));
RectF rect;
path.AddClosedCurve(points, 6);
// Create a region from a path.
Region pathRegion(&path);
// Get the region's enclosing rectangle.
pathRegion.GetBounds(&rect, &graphics);
// Show the region and the enclosing rectangle.
graphics.FillRegion(&solidBrush, &pathRegion);
graphics.DrawRectangle(&pen, rect);
}
Anforderungen
| Anforderung | Wert |
|---|---|
| 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 | gdiplusheaders.h (include Gdiplus.h) |
| Bibliothek | Gdiplus.lib |
| DLL | Gdiplus.dll |