IXpsOMDocument::GetPageReferences-Methode (xpsobjectmodel.h)
Ruft die IXpsOMPageReferenceCollection-Schnittstelle des Dokuments ab, die den virtualisierten Zugriff auf seine Seiten ermöglicht.
Syntax
HRESULT GetPageReferences(
[out, retval] IXpsOMPageReferenceCollection **pageReferences
);
Parameter
[out, retval] pageReferences
Ein Zeiger auf die IXpsOMPageReferenceCollection-Schnittstelle , die eine Sammlung von Seitenverweise für jede Seite des Dokuments enthält. Wenn keine Seitenverweise vorhanden sind, ist die in pageReferences zurückgegebene IXpsOMPageReferenceCollection leer und enthält keine Elemente.
Rückgabewert
Die Methode gibt ein HRESULT zurück. Mögliche Werte sind unter anderem die Werte in der folgenden Tabelle. Informationen zu XPS-Dokument-API-Rückgabewerten, die in dieser Tabelle nicht aufgeführt sind, finden Sie unter XPS-Dokumentfehler.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
pageReferences ist NULL. |
Hinweise
Um die Seiten eines Dokuments abzurufen, rufen Sie zuerst die Liste der IXpsOMPageReference-Schnittstellen ab, indem Sie GetPageReferences aufrufen. Laden Sie dann für jede IXpsOMPageReference-Schnittstelle eine Seite, indem Sie GetPage aufrufen.
Wenn das Dokument keine Seiten enthält, ist die in pageReferences zurückgegebene Seitenverweisauflistung leer. Rufen Sie die GetCount-Methode auf, um die Anzahl der Seitenverweise in der Auflistung abzurufen.
Ein Beispiel dafür, wie diese Methode in einem Programm verwendet werden kann, finden Sie unter Navigieren im XPS-OM.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | xpsobjectmodel.h |