Interface ID2D1GradientStopCollection (d2d1.h)

Representa uma coleção de objetos D2D1_GRADIENT_STOP para pincéis de gradiente linear e radial.

Herança

A interface ID2D1GradientStopCollection herda de ID2D1Resource. ID2D1GradientStopCollection também tem estes tipos de membros:

• Métodos

Métodos

A interface ID2D1GradientStopCollection tem esses métodos.

ID2D1GradientStopCollection::GetColorInterpolationGamma Indica o espaço gama no qual as paradas de gradiente são interpoladas.
ID2D1GradientStopCollection::GetExtendMode Indica o comportamento do gradiente fora do intervalo de gradiente normalizado.
ID2D1GradientStopCollection::GetGradientStopCount Recupera o número de paradas de gradiente na coleção.
ID2D1GradientStopCollection::GetGradientStops Copia as paradas de gradiente da coleção em uma matriz de estruturas D2D1_GRADIENT_STOP.

Comentários

Criando objetos ID2D1GradientStopCollection

Para criar um método ID2D1GradientStopCollection, use o método ID2D1RenderTarget::CreateGradientStopCollection .

Uma coleção de palavras irrelevantes de gradiente é um recurso dependente do dispositivo: seu aplicativo deve criar coleções de parada de gradiente depois de inicializar o destino de renderização com o qual a coleção de parada de gradiente será usada e recriar a coleção de palavras irrelevantes de gradiente sempre que o destino de renderização precisar ser recriado. (Para obter mais informações sobre recursos, consulte Visão geral de recursos.)

Exemplos

O exemplo a seguir cria uma matriz de paradas de gradiente e as usa para criar uma 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
    );

O próximo exemplo de código usa o ID2D1GradientStopCollection para criar um 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
        );
}

Requisitos

Cliente mínimo com suporte	Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2008 R2, Windows Server 2008 com SP2 e Platform Update para Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	d2d1.h

Confira também

ID2D1Resource