Метод IXpsOMDocument::GetPageReferences (xpsobjectmodel.h)

Статья
08/28/2023

Возвращает интерфейс IXpsOMPageReferenceCollection документа, который обеспечивает виртуализированный доступ к его страницам.

Синтаксис

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

Параметры

[out, retval] pageReferences

Указатель на интерфейс IXpsOMPageReferenceCollection , содержащий коллекцию ссылок на страницы для каждой страницы документа. Если нет ссылок на страницу, объект IXpsOMPageReferenceCollection , возвращаемый в pageReferences , будет пустым и не будет содержать элементов.

Возвращаемое значение

Метод возвращает HRESULT. Возможные значения включают, помимо прочего, значения в следующей таблице. Сведения о возвращаемых значениях API документов XPS, не перечисленных в этой таблице, см. в статье Ошибки документа XPS.

Код возврата	Описание
S_OK	Метод выполнен успешно.
E_POINTER	pageReferences имеет значение NULL.

Чтобы получить страницы документа, сначала получите список интерфейсов IXpsOMPageReference , вызвав Метод GetPageReferences. Затем для каждого интерфейса IXpsOMPageReference загрузите страницу, вызвав Метод GetPage.

Если в документе нет страниц, коллекция ссылок на страницу, возвращаемая в pageReferences , будет пустой. Чтобы получить количество ссылок на страницы в коллекции, вызовите ее метод GetCount .

Пример использования этого метода в программе см. в статье Навигация по модели XPS.

Требования

Требование	Значение
Минимальная версия клиента	Windows 7, Windows Vista с пакетом обновления 2 (SP2) и обновлением платформы для Windows Vista [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2) и Обновление платформы для Windows Server 2008 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	xpsobjectmodel.h