Interfaz ID2D1GradientStopCollection (d2d1.h)

Representa una colección de objetos D2D1_GRADIENT_STOP para pinceles de degradado lineal y radial.

Herencia

La interfaz ID2D1GradientStopCollection hereda de ID2D1Resource. ID2D1GradientStopCollection también tiene estos tipos de miembros:

Métodos

La interfaz ID2D1GradientStopCollection tiene estos métodos.

 
ID2D1GradientStopCollection::GetColorInterpolationGamma

Indica el espacio gamma en el que se interpolan los delimitadores de degradado.
ID2D1GradientStopCollection::GetExtendMode

Indica el comportamiento del degradado fuera del intervalo de degradado normalizado.
ID2D1GradientStopCollection::GetGradientStopCount

Recupera el número de paradas de degradado de la colección.
ID2D1GradientStopCollection::GetGradientStops

Copia el degradado de la colección en una matriz de estructuras de D2D1_GRADIENT_STOP.

Comentarios

Crear objetos ID2D1GradientStopCollection

Para crear una colección ID2D1GradientStopCollection, use el método ID2D1RenderTarget::CreateGradientStopCollection .

Una colección de detención de degradado es un recurso dependiente del dispositivo: la aplicación debe crear colecciones de detención de degradado después de inicializar el destino de representación con el que se usará la colección de detención de degradado y volver a crear la colección de detención de degradado cada vez que se necesite volver a crear el destino de representación. (Para obtener más información sobre los recursos, consulte Información general sobre recursos).

Ejemplos

En el ejemplo siguiente se crea una matriz de paradas de degradado y, a continuación, se usan para crear una colección 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
    );

En el ejemplo de código siguiente se usa id2D1GradientStopCollection para crear 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
        );
}

Requisitos

   
Cliente mínimo compatible Windows 7, Windows Vista con SP2 y Platform Update para Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 R2, Windows Server 2008 con SP2 y Actualización de plataforma para Windows Server 2008 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado d2d1.h

Consulte también

ID2D1Resource