ID2D1GradientStopCollection-Schnittstelle (d2d1.h)

Artikel
08/22/2023

Stellt eine Auflistung von D2D1_GRADIENT_STOP -Objekten für lineare und radiale Farbverlaufspinsel dar.

Vererbung

Die ID2D1GradientStopCollection-Schnittstelle erbt von ID2D1Resource. ID2D1GradientStopCollection verfügt auch über folgende Membertypen:

Methoden

Methoden

Die ID2D1GradientStopCollection-Schnittstelle verfügt über diese Methoden.


ID2D1GradientStopCollection::GetColorInterpolationGamma Gibt den Gammabereich an, in dem die Farbverlaufsstopps interpoliert werden.
ID2D1GradientStopCollection::GetExtendMode Gibt das Verhalten des Farbverlaufs außerhalb des normalisierten Farbverlaufsbereichs an.
ID2D1GradientStopCollection::GetGradientStopCount Ruft die Anzahl der Farbverlaufsstopps in der Auflistung ab.
ID2D1GradientStopCollection::GetGradientStops Kopiert die Farbverlaufsstopps aus der Auflistung in ein Array von D2D1_GRADIENT_STOP Strukturen.

Hinweise

Erstellen von ID2D1GradientStopCollection-Objekten

Verwenden Sie zum Erstellen einer ID2D1GradientStopCollection die ID2D1RenderTarget::CreateGradientStopCollection-Methode .

Eine Farbverlaufsstoppsammlung ist eine geräteabhängige Ressource: Ihre Anwendung sollte Farbverlaufsstoppsammlungen erstellen, nachdem sie das Renderziel initialisiert hat, mit dem die Farbverlaufsstoppsammlung verwendet wird, und die Farbverlaufsstoppsammlung neu erstellen, wenn das Renderziel neu erstellt werden muss. (Weitere Informationen zu Ressourcen finden Sie unter Übersicht über Ressourcen.)

Beispiele

Im folgenden Beispiel wird ein Array von Farbverlaufsstopps erstellt und dann verwendet, um eine ID2D1GradientStopCollection zu erstellen.

// Create an array of gradient stops to put in the gradient stop
// collection that will be used in the gradient brush.
ID2D1GradientStopCollection *pGradientStops = NULL;

D2D1_GRADIENT_STOP gradientStops[2];
gradientStops[0].color = D2D1::ColorF(D2D1::ColorF::Yellow, 1);
gradientStops[0].position = 0.0f;
gradientStops[1].color = D2D1::ColorF(D2D1::ColorF::ForestGreen, 1);
gradientStops[1].position = 1.0f;
// Create the ID2D1GradientStopCollection from a previously
// declared array of D2D1_GRADIENT_STOP structs.
hr = m_pRenderTarget->CreateGradientStopCollection(
    gradientStops,
    2,
    D2D1_GAMMA_2_2,
    D2D1_EXTEND_MODE_CLAMP,
    &pGradientStops
    );

Im nächsten Codebeispiel wird die ID2D1GradientStopCollection verwendet, um einen ID2D1LinearGradientBrush zu erstellen.

// The line that determines the direction of the gradient starts at
// the upper-left corner of the square and ends at the lower-right corner.

if (SUCCEEDED(hr))
{
    hr = m_pRenderTarget->CreateLinearGradientBrush(
        D2D1::LinearGradientBrushProperties(
            D2D1::Point2F(0, 0),
            D2D1::Point2F(150, 150)),
        pGradientStops,
        &m_pLinearGradientBrush
        );
}

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

Weitere Informationen

ID2D1Resource

Freigeben über