Partager via

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

  • Article

Définit le nom de la clé de recherche du visuel partagé, qui est stocké dans un dictionnaire de ressources, à utiliser comme source pour le pinceau.

Syntaxe

HRESULT SetVisualLookup(
  [in] LPCWSTR lookup
);

Paramètres

[in] lookup

Nom de la clé de recherche du visuel partagé à utiliser comme source du pinceau. Si une clé de recherche a déjà été définie, un pointeur NULL l’efface.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles incluent, sans s’y limiter, celles du tableau 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_INVALID_RESOURCE_KEY
 Selon la spécification du papier XML, la valeur de la recherche n’est pas une chaîne de clé de recherche valide.
XPS_E_INVALID_LOOKUP_TYPE
 Le nom de la clé de recherche dans key fait référence à un objet qui n’est pas une géométrie.
XPS_E_LOOKUP_NOT_FOUND
 Aucun objet n’a pu être trouvé avec un nom de clé correspondant à la valeur passée dans la clé.

Remarques

Après avoir appelé SetVisualLookup, le visuel local est libéré et GetVisualLocal retourne un pointeur NULL dans le paramètre visuel . Le tableau suivant explique la relation entre les valeurs locales et les valeurs 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

 Visuel défini par SetVisualLocal. Visuel défini par SetVisualLocal. Pointeur NULL .
SetVisualLookup (cette méthode). 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

   
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 Platform Update pour Windows Server 2008 [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête xpsobjectmodel.h

Voir aussi

IXpsOMVisualBrush

XML Paper Specification

Erreurs de document XPS