LinearGradientBrush::GetRectangle(Rect*)-Methode (gdiplusbrush.h)

Artikel
08/23/2023

Die LinearGradientBrush::GetRectangle-Methode ruft das Rechteck ab, das die Grenzen des Farbverlaufs definiert.

Syntax

Status GetRectangle(
  [out] Rect *rect
);

Parameter

[out] rect

Typ: Rect*

Zeiger auf ein Rect-Objekt , das das Rechteck empfängt, das die Grenzen des Farbverlaufs definiert. Wenn beispielsweise ein linearer Farbverlaufpinsel mit einem Startpunkt bei (20, 50) und einem Endpunkt bei (60, 110) erstellt wird, hat das definierende Rechteck seinen oberen linken Punkt bei (20, 50), einer Breite von 40 und einer Höhe von 60.

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

Das Rechteck definiert die Grenzen des Farbverlaufs auf folgende Weise: Die rechte und linke Seite des Rechtecks bilden die Grenzen eines horizontalen Farbverlaufs. Die obere und die untere Seite bilden die Grenzen eines vertikalen Farbverlaufs. Zwei der diagonal gegenüberliegenden Ecken liegen an den Grenzen eines diagonalen Farbverlaufs. In jedem dieser Fälle kann sich jede Seite/Ecke an der Anfangsgrenze befinden, je nachdem, wie die Anfangs- und Endpunkte an den Konstruktor übergeben werden.

Beispiele

Im folgenden Beispiel wird ein linearer Farbverlaufpinsel erstellt. Anschließend ruft der Code das Rechteck des Pinsels ab und zeichnet es.

VOID Example_GetRect(HDC hdc)
{
   Graphics myGraphics(hdc);

   // Create a linear gradient brush.
   LinearGradientBrush linGrBrush( 
      Point(20, 10),
      Point(60, 110),
      Color(255, 0, 0, 0),     // black
      Color(255, 0, 0, 255));  // blue

   // Obtain information about the linear gradient brush.
   Rect rect;
   linGrBrush.GetRectangle(&rect);

   // Draw the retrieved rectangle.
   Pen myPen(Color(255, 0, 0, 0));
   myGraphics.DrawRectangle(&myPen, rect);
}

Anforderungen


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	gdiplusbrush.h (include Gdiplus.h)
Bibliothek	Gdiplus.lib
DLL	Gdiplus.dll