Interfaz IXpsOMLinearGradientBrush (xpsobjectmodel.h)
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.
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 |