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

Artikel
07/16/2024

Die PathGradientBrush::GetRectangle Methode ruft das kleinste Rechteck ab, das den Begrenzungspfad dieses Pfadverlaufspinsels einschließ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, wird Ok zurückgegeben, bei dem es sich um ein Element der Status Enumeration handelt.

Wenn die Methode fehlschlägt, wird eines der anderen Elemente der Status Enumeration zurückgegeben.

Bemerkungen

Beispiele

Im folgenden Beispiel wird ein PathGradientBrush--Objekt erstellt, das auf einem Polygon basiert, 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 einschließ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, das sich innerhalb des Begrenzungspfads des Pinsels befindet. Schließlich zeichnet der Code die Kontur 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);
}