Interfaccia ID2D1GradientStopCollection (d2d1.h)

Articolo
08/22/2023

Rappresenta una raccolta di oggetti D2D1_GRADIENT_STOP per pennelli lineari e radiali.

Ereditarietà

L'interfaccia ID2D1GradientStopCollection eredita da ID2D1Resource. ID2D1GradientStopCollection include anche questi tipi di membri:

Metodi

Metodi

L'interfaccia ID2D1GradientStopCollection include questi metodi.


ID2D1GradientStopCollection::GetColorInterpolationGamma Indica lo spazio gamma in cui vengono interpolate le interruzioni sfumature.
ID2D1GradientStopCollection::GetExtendMode Indica il comportamento della sfumatura all'esterno dell'intervallo di sfumatura normalizzato.
ID2D1GradientStopCollection::GetGradientStopCount Recupera il numero di arresti sfumature nella raccolta.
ID2D1GradientStopCollection::GetGradientStops Copia la sfumatura dalla raccolta in una matrice di strutture D2D1_GRADIENT_STOP.

Commenti

Creazione di oggetti ID2D1GradientStopCollection

Per creare un id2D1GradientStopCollection, usare il metodo ID2D1RenderTarget::CreateGradientStopCollection .

Una raccolta di interruzioni sfumatura è una risorsa dipendente dal dispositivo: l'applicazione deve creare raccolte di interruzioni sfumature dopo aver inizializzato la destinazione di rendering con cui verrà usata la raccolta di interruzioni sfumatura e ricreare la raccolta di arresto sfumatura ogni volta che la destinazione di rendering deve essere ricreata. Per altre informazioni sulle risorse, vedere Panoramica delle risorse.

Esempio

Nell'esempio seguente viene creata una matrice di arresti sfumature, quindi li usa per creare un ID2D1GradientStopCollection.

// 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
    );

L'esempio di codice successivo usa l'ID2D1GradientStopCollection per creare un ID2D1LinearGradientBrush.

// 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
        );
}

Requisiti


Client minimo supportato	Windows 7, Windows Vista con SP2 e Aggiornamento della piattaforma per Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 R2, Windows Server 2008 con SP2 e Platform Update per Windows Server 2008 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	d2d1.h

Vedi anche

ID2D1Resource

Condividi tramite