Compartir a través de

Método IXpsOMGradientBrush::SetTransformLookup (xpsobjectmodel.h)

  • Artículo

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

El nombre de clave identifica un recurso compartido en un diccionario de recursos.

Sintaxis

HRESULT SetTransformLookup(
  [in] LPCWSTR key
);

Parámetros

[in] key

Nombre de la clave de búsqueda de la transformación de matriz que se va a usar para el pincel.

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.
XPS_E_INVALID_RESOURCE_KEY
 Según la especificación de papel XML, el valor de la búsqueda no es una cadena de clave de búsqueda válida.
XPS_E_INVALID_LOOKUP_TYPE
 El nombre de la clave de búsqueda en la clave hace referencia a un objeto que no es una geometría.
XPS_E_LOOKUP_NOT_FOUND
 No se encontró ningún objeto con un nombre de clave que coincida con el valor pasado en la clave.

Comentarios

Después de llamar a SetTransformLookup, se libera la transformación local y GetTransformLocal devuelve un puntero NULL en el parámetro transform . En la tabla siguiente se explica la relación entre los valores locales y de búsqueda de esta propiedad.

Método más reciente llamado Objeto devuelto en transformación por GetTransform Objeto devuelto en transformación por GetTransformLocal Objeto devuelto en clave por GetTransformLookup

SetTransformLocal

 Transformación local establecida por SetTransformLocal. Transformación local establecida por SetTransformLocal. Puntero NULL.
SetTransformLookup (este método) La transformación compartida recuperada, con una clave de búsqueda que coincide con la clave establecida por SetTransformLookup, desde el directorio de recursos. Puntero NULL. Clave de búsqueda establecida por SetTransformLookup.
Todavía no se ha llamado a SetTransformLocal ni SetTransformLookup . Puntero NULL. Puntero NULL. Puntero NULL.
 

La transformación a la que hace referencia la clave determina cómo se transforma el degradado. 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.

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

IXpsOMGradientBrush

XML Paper Specification

Errores del documento XPS