Region::GetBounds(Rect*,constGraphics*)-Methode (gdiplusheaders.h)

Die Region::GetBounds-Methode ruft ein Rechteck ab, das diesen Bereich umschließt.

Syntax

Status GetBounds(
  Rect           *rect,
  const Graphics *g
);

Parameter

rect

Zeiger auf ein Rect-Objekt , das das einschließende Rechteck empfängt.

g

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_GetBoundsRect(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));
    Rect 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);
}

Requirements (Anforderungen)

Kopfzeile	gdiplusheaders.h

Weitere Informationen

Region

Graphicspath

Rect

Status