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

Artículo
12/22/2023

Obtiene la interfaz IXpsOMPageReferenceCollection del documento, que permite el acceso virtualizado a sus páginas.

Sintaxis

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

Parámetros

[out, retval] pageReferences

Puntero a la interfaz IXpsOMPageReferenceCollection que contiene una colección de referencias de página para cada página del documento. Si no hay referencias a páginas, IXpsOMPageReferenceCollection devuelta en pageReferences estará vacía y no tendrá elementos.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen, entre otros, los de la tabla siguiente. Para obtener información sobre los valores devueltos de la API de documentos XPS que no aparecen en esta tabla, vea Errores del documento XPS.

Código devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.
E_POINTER	pageReferences es NULL.

Comentarios

Para obtener las páginas de un documento, primero obtenga la lista de interfaces IXpsOMPageReference mediante una llamada a GetPageReferences. A continuación, para cada interfaz IXpsOMPageReference , cargue una página llamando a GetPage.

Si el documento no tiene páginas, la colección de referencias de página devuelta en pageReferences estará vacía. Para obtener el número de referencias de página en la colección, llame a su método GetCount .

Para obtener un ejemplo de cómo se puede usar este método en un programa, vea Navigate the XPS OM.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7, Windows Vista con SP2 y Platform Update para Windows Vista [aplicaciones de escritorio \| Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 R2, Windows Server 2008 con SP2 y Actualización de plataforma para Windows Server 2008 [aplicaciones de escritorio \| Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	xpsobjectmodel.h