ID2D1GradientStopCollection1::GetGradientStops1-Methode (d2d1_1.h)

Kopiert die Farbverlaufsstopps aus der Sammlung in den Arbeitsspeicher.

Syntax

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

Parameter

[out] gradientStops

Typ: D2D1_GRADIENT_STOP*

Wenn diese Methode zurückgibt, enthält einen Zeiger auf ein eindimensionales Array von D2D1_GRADIENT_STOP Strukturen.

gradientStopsCount

Typ: UINT

Die Anzahl der zu kopierenden Farbverlaufsstopps.

Rückgabewert

Keine

Bemerkungen

Wenn ID2D1DeviceContext::CreateGradientStopCollection zurückgegeben wird, gibt diese Methode die gleichen Werte zurück, die in der Erstellungsmethode angegeben sind. Wenn das ID2D1GradientStopCollection1-Objekt mithilfe von ID2D1RenderTarget::CreateGradientStopCollection erstellt wurde, werden die hier zurückgegebenen Stopps zuerst in den vom parameter colorInterpolationGamma angegebenen Gammabereich transformiert. Weitere Informationen zu Farbraum und Gammabereich finden Sie in der ID2D1DeviceContext::CreateGradientStopCollection-Methode .

Wenn gradientStopsCount kleiner als die Anzahl der Farbverlaufsstopps in der Auflistung ist, werden die verbleibenden Farbverlaufsstopps weggelassen. Wenn gradientStopsCount 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.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 8 und Plattformupdate für Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 und Plattformupdate für Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	d2d1_1.h
DLL	D2d1.dll

Weitere Informationen

ID2D1DeviceContext::CreateEffect

ID2D1DeviceContext::CreateGradientStopCollection

ID2D1GradientStopCollection1

ID2D1RenderTarget::CreateGradientStopCollection