Interfaz IXpsOMLinearGradientBrush (xpsobjectmodel.h)

Artículo
03/15/2023

Especifica un degradado lineal, que es el degradado de color a lo largo de un vector.

Herencia

La interfaz IXpsOMLinearGradientBrush hereda de IXpsOMGradientBrush. IXpsOMLinearGradientBrush también tiene estos tipos de miembros:

Métodos

La interfaz IXpsOMLinearGradientBrush tiene estos métodos.


IXpsOMLinearGradientBrush::Clone Realiza una copia profunda de la interfaz. (IXpsOMLinearGradientBrush.Clone)
IXpsOMLinearGradientBrush::GetEndPoint Obtiene el punto final del degradado.
IXpsOMLinearGradientBrush::GetStartPoint Obtiene el punto inicial del degradado.
IXpsOMLinearGradientBrush::SetEndPoint Establece el punto final del degradado.
IXpsOMLinearGradientBrush::SetStartPoint Establece el punto inicial del degradado.

Comentarios

En la ilustración siguiente, los puntos inicial y final de un degradado lineal también son los puntos inicial y final del trazado de degradado, que es la línea recta que conecta esos puntos.

La región de degradado de un degradado lineal es el área entre los puntos inicial y final, y se extiende en ambas direcciones en un ángulo derecho al trazado de degradado. El área de propagación es el área de la geometría que se encuentra fuera de la región degradada.

Los delimitadores de degradado se usan para definir el color en ubicaciones específicas a lo largo del trazado de degradado. En la ilustración, la parada de degradado 0 se encuentra en el punto inicial de la ruta de degradado y la parada de degradado 1 se encuentra en el punto final. El método de propagación XPS_SPREAD_METHOD_PAD se usa para rellenar el área de propagación.

Ilustración que muestra los términos usados en un degradado lineal

En el ejemplo de código siguiente se muestra cómo crear una instancia de esta interfaz.


IXpsOMLinearGradientBrush    *newInterface;
// The following values are defined outside of 
// this example.
//  IXpsOMGradientStop       *gradStop1, *gradStop2;
//  XPS_POINT                startPoint, endPoint;

// Note the implicit requirement that CoInitializeEx 
//  has previously been called from this thread.

hr = CoCreateInstance(
    __uuidof(XpsOMObjectFactory),
    NULL,
    CLSCTX_INPROC_SERVER,
    _uuidof(IXpsOMObjectFactory),
    reinterpret_cast<LPVOID*>(&xpsFactory)
    );

if (SUCCEEDED(hr))
{
    hr = xpsFactory->CreateLinearGradientBrush (
        gradStop1,
        gradStop2,
        &startPoint,
        &endPoint,
        &newInterface);

    if (SUCCEEDED(hr))
    {
        // use newInterface

        newInterface->Release();
    }
    xpsFactory->Release();
}
else
{
    // evaluate HRESULT error returned in hr
}

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	xpsobjectmodel.h