Méthode IXpsOMPage ::GetDictionary (xpsobjectmodel.h)

Obtient un pointeur vers l’interface IXpsOMDictionary résolue associée à cette page.

Syntaxe

HRESULT GetDictionary(
  [out, retval] IXpsOMDictionary **resourceDictionary
);

Paramètres

[out, retval] resourceDictionary

Pointeur vers l’interface IXpsOMDictionary résolue associée à cette page.

La valeur retournée dans ce paramètre dépend de la méthode la plus récente appelée pour définir le dictionnaire.

Méthode la plus récente appelée	Objet retourné dans resourceDictionary
SetDictionaryLocal	Ressource de dictionnaire local définie par SetDictionaryLocal.
SetDictionaryResource	Dictionnaire partagé dans la ressource de dictionnaire définie par SetDictionaryResource.
Ni SetDictionaryLocal ni SetDictionaryResource 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 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
E_POINTER	resourceDictionary 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 pu être trouvé avec un nom de clé correspondant à la valeur de recherche. Aucun objet n’a pu être trouvé avec un nom de clé correspondant à la valeur passée dans la recherche.

Remarques

Que le dictionnaire soit local ou contenu dans une ressource de dictionnaire distante, cette méthode retourne un pointeur d’interface IXpsOMDictionary . GetOwner détermine si le dictionnaire est distant.

Si une page contient un dictionnaire distant, GetDictionary désérialise le dictionnaire. Si la page contient un dictionnaire distant qui n’est pas valide, GetDictionary peut retourner un code d’erreur de désérialisation.

Après le chargement et l’analyse de la ressource dans le modèle modèle XPS, cette méthode peut retourner une erreur qui s’applique à une autre ressource. Cela se produit parce que toutes les relations sont analysées lorsqu’une ressource est chargée.

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

Voir aussi

IXpsOMDictionary

IXpsOMPage

XML Paper Specification

Erreurs de document XPS