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 |
|---|---|
| Ressource de dictionnaire local définie par SetDictionaryLocal. | |
| 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 |
|
resourceDictionary a la valeur NULL. |
|
Le nom de la clé de recherche défini par SetStrokeBrushLookup fait référence à un objet qui n’est pas un pinceau. |
|
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 |