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 |