ID2D1GradientStopCollection-Schnittstelle (d2d1.h)

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.

Hinweise

Erstellen von ID2D1GradientStopCollection-Objekten

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

Weitere Informationen

ID2D1Resource