ID2D1GradientStopCollection::GetGradientStops-Methode (d2d1.h)

Kopiert die Farbverlaufsstopps aus der Auflistung in ein Array von D2D1_GRADIENT_STOP Strukturen.

Syntax

void GetGradientStops(
  [out] D2D1_GRADIENT_STOP *gradientStops,
        UINT32             gradientStopsCount
);

Parameter

[out] gradientStops

Typ: D2D1_GRADIENT_STOP*

Ein Zeiger auf ein eindimensionales Array von D2D1_GRADIENT_STOP Strukturen. Wenn diese Methode zurückgibt, enthält das Array Kopien der Farbverlaufsstopps der Auflistung. Sie müssen den Arbeitsspeicher für dieses Array zuordnen.

gradientStopsCount

Typ: UINT

Ein -Wert, der die Anzahl der zu kopierenden Farbverlaufsstopps angibt. Wenn der Wert kleiner als die Anzahl der Farbverlaufsstopps in der Auflistung ist, werden die verbleibenden Farbverlaufsstopps weggelassen. Wenn der Wert größer als die Anzahl der Farbverlaufsstopps in der Auflistung ist, werden die zusätzlichen Farbverlaufsstopps auf NULL festgelegt. Verwenden Sie die GetGradientStopCount-Methode , um die Anzahl der Farbverlaufsstopps in der Auflistung abzurufen.

Rückgabewert

Keine

Bemerkungen

Farbverlaufsstopps werden in der Reihenfolge der Position kopiert, beginnend mit dem Farbverlaufsstopp mit dem kleinsten Positionswert und dem Fortschrittsstopp mit dem größten Positionswert.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	d2d1.h
Bibliothek	D2d1.lib
DLL	D2d1.dll

Weitere Informationen

ID2D1GradientStopCollection