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

Article
03/09/2024

Définit le pointeur d’interface IXpsOMDictionary de la ressource de dictionnaire local de la page.

Syntaxe

HRESULT SetDictionaryLocal(
  [in] IXpsOMDictionary *resourceDictionary
);

Paramètres

[in] resourceDictionary

Pointeur d’interface IXpsOMDictionary à définir pour la page. Un pointeur NULL libère tout dictionnaire local précédemment affecté.

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	resourceDictionary 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é SetDictionaryLocal, la ressource de dictionnaire distant est libérée et GetDictionaryResource retourne un pointeur NULL dans le paramètre remoteDictionaryResource . Le tableau suivant explique la relation entre les valeurs locales et distantes de cette propriété.

Méthode la plus récente appelée	Objet retourné dans resourceDictionary par GetDictionary	Objet retourné dans resourceDictionary par GetDictionaryLocal	Objet retourné dans remoteDictionaryResource par GetDictionaryResource
SetDictionaryLocal (cette méthode)	Ressource de dictionnaire local définie par SetDictionaryLocal.	Ressource de dictionnaire local définie par SetDictionaryLocal.	Pointeur NULL .
SetDictionaryResource	Dictionnaire partagé dans la ressource de dictionnaire définie par SetDictionaryResource.	Pointeur NULL .	Ressource de dictionnaire distant définie par SetDictionaryResource.
Ni SetDictionaryLocal ni SetDictionaryResource 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

IXpsOMDictionary

IXpsOMPage

XML Paper Specification

Erreurs de document XPS

Partager via