Méthode IXpsOMDictionary ::InsertAt (xpsobjectmodel.h)

Insère une interface IXpsOMShareable à un emplacement spécifié dans le dictionnaire et définit la clé pour identifier l’interface.

Syntaxe

HRESULT InsertAt(
  [in] UINT32          index,
  [in] LPCWSTR         key,
  [in] IXpsOMShareable *entry
);

Paramètres

[in] index

Index de base zéro dans le dictionnaire dans lequel l’interface IXpsOMShareable doit être insérée.

[in] key

Clé à utiliser pour identifier l’interface IXpsOMShareable dans le dictionnaire.

La chaîne référencée par clé doit être unique dans le dictionnaire.

[in] entry

Pointeur d’interface IXpsOMShareable à insérer à l’emplacement spécifié par l’index.

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 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	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 le dictionnaire sont généralement des pointeurs 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 .

À l’emplacement spécifié par l’index, cette méthode insère le pointeur d’interface IXpsOMShareable et définit la clé ; le pointeur d’interface et la clé sont passés respectivement en valeur et clé. Avant l’insertion de la valeur et de la clé , le pointeur d’interface et la clé à cet emplacement et à tous les emplacements suivants sont déplacés vers le haut par un index.

La figure qui suit illustre la façon dont le dictionnaire est modifié par la méthode InsertAt .

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

IXpsOMShareable

XML Paper Specification

Erreurs de document XPS