Partager via


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

Obtient un pointeur vers l’interface du visuel résolu à utiliser comme source pour le pinceau.

Syntaxe

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

Paramètres

[out, retval] visual

Pointeur vers l’interface IXpsOMVisual de l’objet visuel résolu utilisé comme source pour le pinceau. Si aucun visuel n’a été défini, un pointeur NULL est retourné.

La valeur retournée dans ce paramètre dépend de la méthode la plus récemment appelée pour définir l’objet visuel.

Méthode la plus récente appelée Objet retourné dans le visuel

SetVisualLocal

Visuel défini par SetVisualLocal.

SetVisualLookup

Visuel récupéré, avec une clé de recherche qui correspond à la clé définie par SetVisualLookup, à partir du répertoire de ressources.
Ni SetVisualLocal ni SetVisualLookup n’ont encore été appelés. Pointeur NULL .

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles incluent, sans s’y limiter, celles de la table qui suit. Pour plus d’informations sur les valeurs de retour de l’API de document XPS qui ne sont pas répertoriées dans ce tableau, consultez Erreurs de document XPS.

Code de retour Description
S_OK
S_OK
E_POINTER
le visuel a la valeur NULL.
XPS_E_LOOKUP_INVALID_TYPE
Le nom de la clé de recherche défini par SetStrokeBrushLookup fait référence à un objet qui n’est pas un pinceau.
XPS_E_LOOKUP_NOT_FOUND
Aucun objet n’a été trouvé avec un nom de clé correspondant à la valeur de recherche.

Remarques

Cette méthode retourne un pointeur d’interface IXpsOMVisual . Toutefois, l'applet de commande
l’interface retournée peut être n’importe quelle interface qui hérite d’IXpsOMVisual, comme IXpsOMCanvas, IXpsOMPath et IXpsOMGlyphes.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 7, Windows Vista avec SP2 et Mise à jour de plateforme pour Windows Vista [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2008 R2, Windows Server 2008 avec SP2 et Mise à jour de plateforme pour Windows Server 2008 [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête xpsobjectmodel.h

Voir aussi

IXpsOMCanvas

IXpsOMGlyphes

IXpsOMPath

IXpsOMVisual

IXpsOMVisualBrush

XML Paper Specification

Erreurs de document XPS