Método IXpsOMVisual::SetClipGeometryLookup (xpsobjectmodel.h)

Establece el nombre de clave de búsqueda de una geometría de clip compartido en un diccionario de recursos.

Sintaxis

HRESULT SetClipGeometryLookup(
  [in] LPCWSTR key
);

Parámetros

[in] key

Nombre de clave de búsqueda de la geometría del clip en el diccionario. Un puntero NULL borra el nombre de clave asignado previamente.

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 SetClipGeometryLookup, se libera la geometría del clip local y GetClipGeometryLocal devuelve un puntero NULL en el parámetro clipGeometry . 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 clipGeometry por GetClipGeometry	Objeto devuelto en clipGeometry por GetClipGeometryLocal	Cadena devuelta en clave por GetClipGeometryLookup
SetClipGeometryLocal	Geometría de clip local establecida por SetClipGeometryLocal.	Geometría de clip local establecida por SetClipGeometryLocal.	Puntero NULL.
SetClipGeometryLookup (este método)	Geometría del clip compartido que se recupera, con una clave de búsqueda que coincide con la clave establecida por SetClipGeometryLookup, desde el directorio de recursos.	Puntero NULL.	La clave de búsqueda establecida por SetClipGeometryLookup.
Aún no se ha llamado a SetClipGeometryLookup ni SetClipGeometryLocal .	Puntero NULL.	Puntero NULL.	Puntero NULL.

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

IXpsOMVisual

XML Paper Specification

Errores del documento XPS