Méthode IXpsOMDocument ::GetPageReferences (xpsobjectmodel.h)

Article
03/13/2024

Obtient l’interface IXpsOMPageReferenceCollection du document, qui permet un accès virtualisé à ses pages.

Syntaxe

HRESULT GetPageReferences(
  [out, retval] IXpsOMPageReferenceCollection **pageReferences
);

Paramètres

[out, retval] pageReferences

Pointeur vers l’interface IXpsOMPageReferenceCollection qui contient une collection de références de page pour chaque page du document. S’il n’y a pas de références de page, l’IXpsOMPageReferenceCollection retourné dans pageReferences sera vide et n’aura aucun élément.

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	S_OK
E_POINTER	pageReferences a la valeur NULL.

Remarques

Pour obtenir les pages d’un document, commencez par obtenir la liste des interfaces IXpsOMPageReference en appelant GetPageReferences. Ensuite, pour chaque interface IXpsOMPageReference , chargez une page en appelant GetPage.

Si le document n’a pas de pages, la collection de références de page retournée dans pageReferences est vide. Pour obtenir le nombre de références de page dans la collection, appelez sa méthode GetCount .

Pour obtenir un exemple de la façon dont cette méthode peut être utilisée dans un programme, consultez Naviguer dans le modèle d’interface utilisateur XPS.

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 Platform Update pour Windows Server 2008 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	xpsobjectmodel.h