Compartir a través de

Método IXpsOMGradientStop::SetColor (xpsobjectmodel.h)

  • Artículo

Establece el valor de color y el perfil de color de la parada de degradado.

Sintaxis

HRESULT SetColor(
  [in] const XPS_COLOR            *color,
  [in] IXpsOMColorProfileResource *colorProfile
);

Parámetros

[in] color

Valor de color que se va a establecer en la parada de degradado.

Si el valor del campo colorType de la estructura XPS_COLOR que se pasa en este parámetro es XPS_COLOR_TYPE_CONTEXT, se debe proporcionar un perfil de color válido en el parámetro colorProfile .

[in] colorProfile

Perfil de color que se va a usar con color.

Se requiere un perfil de color cuando se XPS_COLOR_TYPE_CONTEXT el valor del campo colorType de la estructura XPS_COLOR que se pasa en el parámetro color. Si el valor del campo colorType no está XPS_COLOR_TYPE_CONTEXT, este parámetro debe establecerse en NULL.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen, entre otros, los de la tabla siguiente. Para obtener información sobre los valores devueltos de la API de documentos XPS que no aparecen en esta tabla, vea Errores del documento XPS.

Código devuelto Descripción
S_OK
 El método se ha llevado a cabo de forma correcta.
E_POINTER
 el color es NULL.
XPS_E_MISSING_COLORPROFILE
 colorProfile es NULL cuando se esperaba un perfil de color. Se requiere un perfil de color cuando se XPS_COLOR_TYPE_CONTEXT el tipo de color.
XPS_E_NO_CUSTOM_OBJECTS
 colorProfile no apunta a una implementación de interfaz reconocida. No se admite la implementación personalizada de interfaces de LA API de documentos XPS.
XPS_E_UNEXPECTED_COLORPROFILE
 colorProfile contenía un perfil de color cuando no se esperaba uno. Solo se permite un perfil de color cuando se XPS_COLOR_TYPE_CONTEXT el tipo de color.

Comentarios

Solo se requiere un perfil de color cuando se XPS_COLOR_TYPE_CONTEXT el tipo de color.

Requisitos

Requisito Value
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

IXpsOMColorProfileResource

IXpsOMGradientStop

XML Paper Specification

Errores del documento XPS

XPS_COLOR