Compartilhar via


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

Obtém a interface IXpsOMPageReferenceCollection do documento, que permite o acesso virtualizado às suas páginas.

Sintaxe

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

Parâmetros

[out, retval] pageReferences

Um ponteiro para a interface IXpsOMPageReferenceCollection que contém uma coleção de referências de página para cada página do documento. Se não houver referências de página, o IXpsOMPageReferenceCollection retornado em pageReferences estará vazio e não terá elementos.

Retornar valor

O método retorna um HRESULT. Os valores possíveis incluem, mas não se limitam, aqueles na tabela a seguir. Para obter informações sobre valores retornados da API de documento XPS que não estão listados nesta tabela, consulte Erros de documento XPS.

Código de retorno Descrição
S_OK
O método foi bem-sucedido.
E_POINTER
pageReferences é NULL.

Comentários

Para obter as páginas de um documento, primeiro obtenha a lista de interfaces IXpsOMPageReference chamando GetPageReferences. Em seguida, para cada interface IXpsOMPageReference , carregue uma página chamando GetPage.

Se o documento não tiver páginas, a coleção de referência de página retornada em pageReferences estará vazia. Para obter o número de referências de página na coleção, chame seu método GetCount .

Para obter um exemplo de como esse método pode ser usado em um programa, consulte Navegar no OM XPS.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 R2, Windows Server 2008 com SP2 e Platform Update para Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho xpsobjectmodel.h

Confira também

IXpsOMDocument

IXpsOMPageReference

IXpsOMPageReferenceCollection

Navegar pelo OM do XPS

Especificação de Papel XML

Erros de documento XPS