LinearGradientBrush::SetInterpolationColors-Methode (gdiplusbrush.h)

Die LinearGradientBrush::SetInterpolationColors-Methode legt die Farben fest, die für diesen linearen Farbverlaufspinsel interpoliert werden sollen, und die entsprechenden Mischpositionen.

Syntax

Status SetInterpolationColors(
  [in] const Color *presetColors,
  [in] const REAL  *blendPositions,
  [in] INT         count
);

Parameter

[in] presetColors

Typ: const Color*

Zeiger auf ein Array von Color-Objekten , die die Farben angeben, die für diesen linearen Farbverlaufspinsel interpoliert werden sollen. Eine Farbe eines bestimmten Indexes im PresetColors-Array entspricht der Mischposition desselben Indexes im Array blendPositions .

[in] blendPositions

Typ: const REAL*

Zeiger auf ein Array von reellen Zahlen, die die Mischpositionen angeben. Jede Zahl im Array gibt einen Prozentsatz des Abstands zwischen der Startgrenze und der Endgrenze an und liegt im Bereich von 0,0 bis 1,0, wobei 0,0 die Anfangsgrenze des Farbverlaufs und 1,0 die Endgrenze angibt. Es müssen mindestens zwei Positionen angegeben werden: die erste Position, die immer 0,0f ist, und die letzte Position, die immer 1,0f ist. Andernfalls ist das Verhalten nicht definiert. Eine Mischposition zwischen 0,0 und 1,0 gibt die Linie parallel zu den Begrenzungslinien an, d. h. ein bestimmter Bruchteil des Abstands von der Startgrenze bis zur Endgrenze. Beispielsweise gibt eine Mischposition von 0,7 die Linie an, die 70 Prozent des Abstands von der Startgrenze bis zur Endgrenze beträgt. Die Farbe ist konstant für Linien, die parallel zu den Begrenzungslinien sind.

[in] count

Typ: INT

Ganzzahl, die die Anzahl der Elemente im Array presetColors angibt. Dies entspricht der Anzahl der Elemente im Array blendPositions .

Rückgabewert

Typ: Status

Wenn die Methode erfolgreich ist, gibt sie OK zurück, ein Element der Status-Enumeration .

Wenn die Methode fehlschlägt, gibt sie eines der anderen Elemente der Status-Enumeration zurück.

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

Pinsel und gefüllte Formen

Farbe

Erstellen eines linearen Farbverlaufs

Füllen einer Form mit einem Farbverlauf

LinearGradientBrush

LinearGradientBrush::GetInterpolationColors