PathGradientBrush::SetInterpolationColors-Methode (gdipluspath.h)

Artikel
08/24/2023

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