Share via

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

  • Article

Définit le pointeur d’interface du visuel local non partagé utilisé comme source pour le pinceau.

Syntaxe

HRESULT SetVisualLocal(
  [in] IXpsOMVisual *visual
);

Paramètres

[in] visual

Pointeur vers l’interface IXpsOMVisual à définir comme visuel pour le pinceau. Si un visuel local a été défini, le passage d’un pointeur NULL le libère.

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
XPS_E_NO_CUSTOM_OBJECTS
 visual ne pointe pas vers une implémentation d’interface reconnue. L’implémentation personnalisée des interfaces d’API document XPS n’est pas prise en charge.

Remarques

Après avoir appelé SetVisualLocal, la clé de recherche visuelle est libérée et GetVisualLookup retourne un pointeur NULL dans le paramètre de recherche . Le tableau suivant explique la relation entre les valeurs locales et de recherche de cette propriété.

Méthode la plus récente appelée Objet retourné dans le visuel par GetVisual Objet retourné dans le visuel par GetVisualLocal Chaîne retournée dans la recherche par GetVisualLookup
SetVisualLocal (cette méthode). Visuel défini par SetVisualLocal. Visuel défini par SetVisualLocal. Pointeur NULL .

SetVisualLookup

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

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

IXpsOMVisual

IXpsOMVisualBrush

XML Paper Specification

Erreurs de document XPS