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

Obtient le pointeur d’interface IXpsOMShareable et la chaîne de nom de clé de l’entrée à un index spécifié dans le dictionnaire.

Syntaxe

HRESULT GetAt(
  [in]          UINT32          index,
  [out]         LPWSTR          *key,
  [out, retval] IXpsOMShareable **entry
);

Paramètres

[in] index

Index de base zéro de l’entrée de dictionnaire à obtenir.

[out] key

Chaîne de clé qui se trouve à l’emplacement spécifié par l’index.

[out, retval] entry

Pointeur d’interface IXpsOMShareable qui se trouve à l’emplacement spécifié par l’index.

Valeur retournée

Si la méthode réussit, elle retourne S_OK ; sinon, elle retourne un code d’erreur HRESULT .

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 .

Cette méthode alloue la mémoire utilisée par la chaîne retournée dans la clé. Si la clé n’est pas NULL, utilisez la fonction CoTaskMemFree pour libérer la mémoire.

Configuration requise

Voir aussi

IXpsOMBrush

IXpsOMDictionary

IXpsOMShareable

IXpsOMVisual

XML Paper Specification