Méthode IXpsOMDictionary ::Append (xpsobjectmodel.h)
Ajoute une interface IXpsOMShareable avec sa clé à la fin du dictionnaire.
Syntaxe
HRESULT Append(
[in] LPCWSTR key,
[in] IXpsOMShareable *entry
);
Paramètres
[in] key
Clé à utiliser pour cette entrée.
La chaîne référencée par clé doit être unique dans le dictionnaire.
[in] entry
Pointeur vers l’interface IXpsOMShareable qui doit être ajoutée au dictionnaire.
Un dictionnaire ne peut pas contenir de pointeurs d’interface en double. Ce paramètre doit contenir un pointeur d’interface qui n’est pas déjà dans le dictionnaire.
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 |
|
l’entrée 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
Les pointeurs d’interface stockés dans un dictionnaire pointent généralement vers des interfaces, telles que IXpsOMBrush et IXpsOMVisual, qui sont dérivées de l’interface IXpsOMShareable . Pour déterminer le type d’interface, appelez la méthode IXpsOMShareable ::GetType .
La figure qui suit illustre la façon dont le dictionnaire est modifié par la méthode Append .
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 |