Interfaz IXpsOMGradientBrush (xpsobjectmodel.h)

Esta interfaz describe un degradado que se compone de paradas de degradado. Las clases que heredan de IXpsOMGradientBrush especifican diferentes formas de interpretar las paradas de degradado.

IXpsOMGradientBrush es la interfaz base de las interfaces IXpsOMLinearGradientBrush e IXpsOMRadialGradientBrush .

Herencia

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

Métodos

La interfaz IXpsOMGradientBrush tiene estos métodos.

 
IXpsOMGradientBrush::GetColorInterpolationMode

Obtiene la función gamma que se va a usar para la interpolación de colores.
IXpsOMGradientBrush::GetGradientStops

Obtiene un puntero a una interfaz IXpsOMGradientStopCollection que contiene la colección de interfaces IXpsOMGradientStop que definen el degradado.
IXpsOMGradientBrush::GetSpreadMethod

Obtiene el valor XPS_SPREAD_METHOD, que describe cómo se representará el área fuera de la región degradada.
IXpsOMGradientBrush::GetTransform

Obtiene un puntero a la interfaz IXpsOMMatrixTransform que contiene la transformación de matriz resuelta para el pincel. (IXpsOMGradientBrush.GetTransform)
IXpsOMGradientBrush::GetTransformLocal

Obtiene un puntero a la interfaz IXpsOMMatrixTransform que contiene la transformación de matriz local, no compartida y resuelta para el pincel.
IXpsOMGradientBrush::GetTransformLookup

Obtiene el nombre de la clave de búsqueda de la interfaz de transformación de matriz compartida que se va a usar para el pincel.
IXpsOMGradientBrush::SetColorInterpolationMode

Establece el valor XPS_COLOR_INTERPOLATION, que describe la función gamma que se va a usar para la interpolación de colores.
IXpsOMGradientBrush::SetSpreadMethod

Establece el valor XPS_SPREAD_METHOD, que describe cómo se representa el área fuera de la región degradada.
IXpsOMGradientBrush::SetTransformLocal

Establece el puntero de interfaz IXpsOMMatrixTransform en una transformación de matriz local y no compartida que se va a usar para el pincel.
IXpsOMGradientBrush::SetTransformLookup

Establece el nombre de la clave de búsqueda de una transformación de matriz compartida que se va a usar para el pincel.

Comentarios

Los métodos de esta interfaz definen los parámetros básicos de un degradado. El tipo de degradado, que puede ser lineal o radial, determina cómo se aplican estos parámetros.

Como se muestra en la ilustración siguiente, los puntos inicial y final de un degradado lineal marcan los puntos finales de la ruta de degradado. La ruta de degradado es la línea recta que conecta los puntos inicial y final. La región degradada de un degradado lineal consta del área entre los puntos inicial y final, incluidos esos puntos, y se extiende en ambas direcciones en un ángulo derecho al trazado de degradado. El área de propagación es el área fuera de la región degradada.

Los delimitadores de degradado definen el color en ubicaciones específicas a lo largo del trazado de degradado; el color se interpola a lo largo del trazado de degradado entre los delimitadores de degradado, como se muestra en la ilustración siguiente.

Ilustración que muestra los términos usados en un degradado lineal Como se muestra en la ilustración siguiente, la región degradada de un degradado radial es el área entre la elipse descrita por el punto central y los radios x e y que se extienden desde el punto central. El área de propagación es el área fuera de esa elipse. El trazado de degradado es una línea radial que barre toda la región de degradado desde el origen del degradado hasta la elipse que enlaza la región de degradado. En la ilustración siguiente, no se muestra la ruta de degradado. Ilustración que muestra los términos usados en un degradado radial El método spread describe cómo se rellena el área de propagación. La implementación del método de propagación depende del tipo de degradado (lineal o radial). En la ilustración siguiente se muestran varios ejemplos de cómo se puede rellenar el área de propagación. Para obtener información sobre los diferentes métodos de propagación, consulte XPS_SPREAD_METHOD. Ilustración en la que se muestran ejemplos del método spread La transformación determina cómo se transforma el degradado resultante. La parte visible del degradado que se representa en última instancia en la imagen viene determinada por la ruta de acceso, el trazo o el glifo que usa el pincel de degradado.

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

Consulte también

IXpsOMBrush

IXpsOMLinearGradientBrush

IXpsOMRadialGradientBrush

Interfaces

XML Paper Specification