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

Artikel
02/29/2024

Erstellt ein LinearGradientBrush::LinearGradientBrush-Objekt aus einem Rechteck und einem Richtungswinkel.

Syntax

void LinearGradientBrush(
  [in, ref] const Rect &  rect,
  [in, ref] const Color & color1,
  [in, ref] const Color & color2,
  [in]      REAL          angle,
  [in]      BOOL          isAngleScalable
);

Parameter

[in, ref] rect

Typ: const Rect

Verweis auf ein Rechteck, das den Anfangs- und Endpunkt des Farbverlaufs angibt. Die obere linke Ecke des Rechtecks ist der Ausgangspunkt. Die untere rechte Ecke ist der Endpunkt.

[in, ref] color1

Typ: const Color

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

[in, ref] color2

Typ: const Color

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

[in] angle

Typ: REAL

Reelle Zahl, die, wenn isAngleScalableTRUE ist, den Basiswinkel angibt, aus dem der Winkel der Richtungslinie berechnet wird, oder dass, wenn isAngleScalableFALSE ist, den Winkel der Richtungslinie angibt. Der Winkel wird vom oberen Rand des Rechtecks gemessen, das durch Rechteck angegeben wird und in Grad sein muss. Der Farbverlauf folgt der Richtungslinie.

[in] isAngleScalable

Typ: BOOL

Boolescher Wert, der angibt, ob der Winkel skalierbar ist. Wenn isAngleScalableTRUE ist, ist der Winkel der Richtungslinie skalierbar. Andernfalls ist der Winkel nicht skalierbar.

Rückgabewert

Keine

Bemerkungen

Die "Richtungslinie", eine imaginäre gerade Linie, wird durch den Startpunkt (obere linke Ecke des Rechtecks) und den Winkelwinkel definiert. Die Anfangsgrenze des Farbverlaufs ist eine gerade Linie, die senkrecht zur Richtungslinie steht und den Ausgangspunkt durchläuft. Die Endgrenze des Farbverlaufs ist eine gerade Linie, die parallel zur Anfangsbegrenzungslinie verläuft und den Endpunkt (untere rechte Ecke des Rechtecks) durchläuft. Die Farbverlaufsfarbe ist entlang von Linien konstant, die parallel zu den Begrenzungslinien sind. Der Farbverlauf wechselt allmählich von der Startfarbe zur Endfarbe entlang der Richtungslinie.

Wenn isAngleScalableTRUE ist, wird der Basiswinkel skaliert, um den Winkel der Richtungslinie zu erzeugen:

ß = arctan( (width / height) tan(ø) )

wobei ß der neue Winkel der Richtungslinie ist; Breite und Höhe sind die Abmessungen des Rechtecks; und ø ist der Basiswinkelwinkel. Diese Beziehung ist nur gültig, wenn der Winkel kleiner als 90 Grad ist.

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

Weitere Informationen

LinearGradientBrush