PathGradientBrush::SetInterpolationColors-Methode (gdipluspath.h)
Die PathGradientBrush::SetInterpolationColors-Methode legt die voreingestellten Farben und die Mischpositionen dieses Pfadverlaufspinsels fest.
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 , das die Interpolationsfarben für den Farbverlauf angibt. Eine Farbe eines bestimmten Indexes im PresetColors-Array entspricht der Mischposition desselben Indexes im BlendPositions-Array .
[in] blendPositions
Typ: REAL*
Zeiger auf ein Array, das die Mischpositionen angibt. Jede Mischposition ist eine Zahl von 0 bis 1, wobei 0 die Grenze des Farbverlaufs und 1 den Mittelpunkt angibt. Eine Mischposition zwischen 0 und 1 gibt den Satz aller Punkte an, die einen bestimmten Bruchteil des Abstands von der Grenze zum Mittelpunkt aufweisen. Beispielsweise gibt eine Mischposition von 0,7 den Satz aller Punkte an, die 70 Prozent des Weges von der Grenze zum Mittelpunkt aufweisen.
[in] count
Typ: INT
Eine ganze Zahl, die die Anzahl der Color-Objekte im PresetColors-Array angibt. Dies entspricht der Anzahl der Elemente im BlendPositions-Array .
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
Ein einfacher Pfadfarbverlaufpinsel hat zwei Farben: eine Begrenzungsfarbe und eine mittlere Farbe. Wenn Sie mit einem solchen Pinsel malen, ändert sich die Farbe allmählich von der Begrenzungsfarbe zur Mittleren Farbe, während Sie vom Begrenzungspfad zum Mittelpunkt wechseln. Sie können einen komplexeren Farbverlauf erstellen, indem Sie ein Array von voreingestellten Farben und ein Array von Mischpositionen angeben.
Beispiele
Im folgenden Beispiel wird ein PathGradientBrush-Objekt basierend auf einem dreieckigen Pfad erstellt. Die PathGradientBrush::SetInterpolationColors-Methode legt die voreingestellten Farben des Pinsels auf Rot, Blau und Aqua und die Mischpositionen auf 0, 0, 4 und 1 fest. Die Graphics::FillRectangle-Methode verwendet den Pfadfarbverlaufpinsel, um ein Rechteck zu zeichnen, das den dreieckigen Pfad enthält.
VOID Example_SetInterpColors(HDC hdc)
{
Graphics graphics(hdc);
Point points[] = {Point(100, 0), Point(200, 200), Point(0, 200)};
PathGradientBrush pthGrBrush(points, 3);
Color col[] = {
Color(255, 255, 0, 0), // red
Color(255, 0, 0, 255), // blue
Color(255, 0, 255, 255)}; // aqua
REAL pos[] = {
0.0f, // red at the boundary
0.4f, // blue 40 percent of the way from the boundary to the center
1.0f}; // aqua at the center
pthGrBrush.SetInterpolationColors(col, pos, 3);
graphics.FillRectangle(&pthGrBrush, 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 | gdipluspath.h (include Gdiplus.h) |
| Bibliothek | Gdiplus.lib |
| DLL | Gdiplus.dll |