Método IXpsOMVisualBrush::GetVisual (xpsobjectmodel.h)

Artículo
12/22/2023

Obtiene un puntero a la interfaz del objeto visual resuelto que se usará como origen para el pincel.

Sintaxis

HRESULT GetVisual(
  [out, retval] IXpsOMVisual **visual
);

Parámetros

[out, retval] visual

Puntero a la interfaz IXpsOMVisual del objeto visual resuelto que se usa como origen para el pincel. Si no se ha establecido un objeto visual, se devuelve un puntero NULL .

El valor que se devuelve en este parámetro depende del método al que se ha llamado más recientemente para establecer el objeto visual.

Método más reciente llamado	Objeto que se devuelve en el objeto visual
SetVisualLocal	Objeto visual que establece SetVisualLocal.
SetVisualLookup	Objeto visual que se recupera, con una clave de búsqueda que coincide con la clave establecida por SetVisualLookup, desde el directorio de recursos.
Todavía no se ha llamado a SetVisualLocal ni SetVisualLookup .	Puntero 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 objeto visual es NULL.
XPS_E_LOOKUP_INVALID_TYPE	El nombre de la clave de búsqueda establecido por SetStrokeBrushLookup hace referencia a un objeto que no es un pincel.
XPS_E_LOOKUP_NOT_FOUND	No se encontró ningún objeto con un nombre de clave que coincida con el valor de búsqueda.

Comentarios

Este método devuelve un puntero de interfaz IXpsOMVisual . Sin embargo, el cmdlet
la interfaz que se devuelve puede ser cualquier interfaz que herede de IXpsOMVisual, como IXpsOMCanvas, IXpsOMPath e IXpsOMGlyphs.

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