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
Erstellen eines linearen Farbverlaufs