LinearGradientBrush::GetInterpolationColors-Methode (gdiplusbrush.h)

Artikel
08/23/2023

Die LinearGradientBrush::GetInterpolationColors-Methode ruft die Farben ab, die derzeit für diesen linearen Farbverlaufpinsel und die entsprechenden Mischpositionen interpoliert werden sollen.

Syntax

Status GetInterpolationColors(
  [out] Color *presetColors,
  [out] REAL  *blendPositions,
  [in]  INT   count
);

Parameter

[out] presetColors

Typ: Farbe*

Zeiger auf ein Array, das die Farben empfängt. Eine Farbe eines bestimmten Indexes im PresetColors-Array entspricht der Mischposition desselben Indexes im BlendPositions-Array .

[out] blendPositions

Typ: REAL*

Zeiger auf ein Array, das die Mischpositionen empfängt. Jede Zahl im Array gibt einen Prozentsatz des Abstands zwischen der Anfangsgrenze 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. Eine Mischposition zwischen 0,0 und 1,0 gibt eine Linie parallel zu den Begrenzungslinien an, die einen bestimmten Bruchteil des Abstands von der Startgrenze zur Endgrenze darstellt. Beispielsweise gibt eine Mischposition von 0,7 die Linie an, die 70 Prozent des Abstands von der Startgrenze 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 PresetColors-Array angibt. Dies entspricht der Anzahl der Elemente im BlendPositions-Array . Rufen Sie vor dem Aufrufen der LinearGradientBrush::GetInterpolationColors-Methode eines LinearGradientBrush-Objekts die LinearGradientBrush::GetInterpolationColorCount-Methode desselben LinearGradientBrush-Objekts auf, um die aktuelle Anzahl von Farben zu bestimmen. Die Anzahl der abgerufenen Mischpositionen entspricht der Anzahl der abgerufenen Farben.

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.

Anforderungen


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