LinearGradientBrush::LinearGradientBrush(constRect&,constColor&,constColor&,LinearGradientMode)-Methode (gdiplusbrush.h)

Artikel
01/10/2024

Erstellt ein LinearGradientBrush::LinearGradientBrush-Objekt basierend auf einem Rechteck und dem Richtungsmodus.

Syntax

void LinearGradientBrush(
  [in, ref] const Rect &       rect,
  [in, ref] const Color &      color1,
  [in, ref] const Color &      color2,
  [in]      LinearGradientMode mode
);

Parameter

[in, ref] rect

Typ: const Rect

Verweis auf ein Rechteck, das die Anfangs- und Endpunkte des Farbverlaufs angibt. Die Richtung des Farbverlaufs, die durch den Modus angegeben wird, wirkt sich darauf aus, wie diese Punkte definiert werden. Die Abmessungen des Rechtecks wirken sich auf die Richtung des Farbverlaufs für den vorwärts-diagonalen Modus und den rückwärts-diagonalen Modus aus.

[in, ref] color1

Typ: const Color

Verweis auf ein Color-Objekt , das die Farbe an der Anfangsbegrenzungslinie dieses linearen Farbverlaufs-Pinsels angibt.

[in, ref] color2

Typ: const Color

Verweis auf ein Color-Objekt , das die Farbe an der endenden Begrenzungslinie dieses linearen Farbverlaufspinsels angibt.

[in] mode

Typ: LinearGradientMode

Element der LinearGradientMode-Enumeration , die die Richtung des Farbverlaufs angibt.

Rückgabewert

Keine

Bemerkungen

Die Anfangsgrenze des Farbverlaufs ist eine gerade Linie, die entweder den Startpunkt durchläuft oder das Rechteck umgrenzt. Die Endgrenze des Farbverlaufs ist eine gerade Linie, die parallel zur Anfangsgrenze verläuft und entweder den Endpunkt durchläuft oder das Rechteck umgrenzt. Die "Richtungslinie", eine imaginäre gerade Linie, ist senkrecht zu den Begrenzungslinien. Die Farbverlaufsfarbe ist konstant entlang von Linien, die parallel zu den Begrenzungslinien sind. Der Farbverlauf ändert sich schrittweise von der Anfangsfarbe zur Endfarbe entlang der Richtungslinie.

Der Modus wirkt sich auf die Grenzen des Farbverlaufs aus:

Vertikaler Modus Die Begrenzungslinien sind parallel zum oberen (und unteren) Des Rechtecks. Die anfangs und endenden Begrenzungslinien sind die obere bzw. untere Grenze des Rechtecks.
Horizontaler Modus Die Begrenzungslinien sind parallel zur linken (und rechten) Des Rechtecks. Die Anfangs- und endenden Begrenzungslinien sind die linke bzw. rechte Linie des Rechtecks.
Diagonaler Vorwärtsmodus Die Begrenzungslinien sind parallel zur diagonalen Linie, die durch die obere rechte Ecke und die linke untere Ecke des Rechtecks definiert wird. Die Startgrenze durchläuft den Startpunkt (obere linke Ecke des Rechtecks). Die endende Begrenzungslinie durchläuft den Endpunkt (untere rechte Ecke des Rechtecks). Beachten Sie, dass Start- und Endpunkte Gegensätze zu den Anfangs- und Endpunkten des rückwärts diagonalen Modus sind.
Rückwärts diagonaler Modus Die Begrenzungslinien sind parallel zur diagonalen Linie, die durch die obere linke Ecke und die untere rechte Ecke des Rechtecks definiert wird. Die startende Begrenzungslinie durchläuft den Startpunkt (obere rechte Ecke des Rechtecks). Die endende Begrenzungslinie durchläuft den Endpunkt (untere linke Ecke des Rechtecks). Beachten Sie, dass Start- und Endpunkte Gegensätze zu den Anfangs- und Endpunkten des diagonalen Vorwärtsmodus sind.

Beispiele

Im folgenden Beispiel wird ein linearer Farbverlaufspinsel mit LinearGradientModeVertical für die Moduseinstellung erstellt.

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

   LinearGradientBrush linGrBrush(
      Rect(20, 10, 200, 100),
      Color(255, 255, 0, 0),   // red
      Color(255, 0, 0, 255),   // blue
      LinearGradientModeVertical);
   myGraphics.FillRectangle(&linGrBrush, 0, 0, 300, 300); 
}

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