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

Weitere Informationen

Graphicspath

Region