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

Obtient le pointeur d’interface IXpsOMShareable de l’entrée qui contient la clé spécifiée.

Syntaxe

HRESULT GetByKey(
  [in]          LPCWSTR         key,
  [in]          IXpsOMShareable *beforeEntry,
  [out, retval] IXpsOMShareable **entry
);

Paramètres

[in] key

Clé de l’entrée à trouver dans le dictionnaire.

[in] beforeEntry

Pointeur d’interface IXpsOMShareable vers la dernière entrée du dictionnaire à rechercher pour la clé. Si beforeEntry a la valeur NULL ou est un pointeur d’interface vers une entrée qui n’est pas dans le dictionnaire, l’ensemble du dictionnaire fait l’objet d’une recherche.

[out, retval] entry

Pointeur d’interface vers l’entrée du dictionnaire dont la clé correspond à la clé.

Valeur retournée

Si la méthode réussit, elle retourne S_OK ; sinon, il 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 .

Configuration requise

Voir aussi

IXpsOMDictionary

IXpsOMShareable

XML Paper Specification