PathGradientBrush::GetRectangle(RectF*)-Methode (gdipluspath.h)

Artikel
02/29/2024

Die PathGradientBrush::GetRectangle-Methode ruft das kleinste Rechteck ab, das den Begrenzungspfad dieses Pfadverlaufspinsels umschließt.

Syntax

Status GetRectangle(
  RectF *rect
);

Parameter

rect

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

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.

Bemerkungen

Beispiele

Im folgenden Beispiel wird ein PathGradientBrush-Objekt basierend auf einem Polygon erstellt, das durch vier Punkte definiert ist. Der Code ruft die PathGradientBrush::GetRectangle-Methode des PathGradientBrush-Objekts auf, um das kleinste Rechteck abzurufen, das den Begrenzungspfad des Pinsels umschließt. Der Code ruft die Graphics::FillRectangle-Methode eines Graphics-Objekts auf und übergibt die Adresse des PathGradientBrush-Objekts und einen Verweis auf das umgebende Rechteck des Pinsels. Dieser Aufruf füllt nur den Teil des umgebenden Rechtecks aus, der sich innerhalb des Begrenzungspfads des Pinsels befindet. Schließlich zeichnet der Code den Umriss des umgebenden Rechtecks.

VOID Example_GetRect(HDC hdc)
{
   Graphics graphics(hdc);
   Pen pen(Color(255, 0, 0, 0));

   // Create a path gradient brush based on an array of points.
   Point points[] = {
      Point(30, 20),
      Point(150, 40),
      Point(100, 100),
      Point(60, 200) };

   PathGradientBrush pthGrBrush(points, 4);

   // Obtain information about the path gradient brush.
   RectF rect;
   pthGrBrush.GetRectangle(&rect);

   graphics.FillRectangle(&pthGrBrush, rect);
   graphics.DrawRectangle(&pen, rect);
}