Compartilhar via


Método IXpsOMPageReference::GetPage (xpsobjectmodel.h)

Obtém um ponteiro para a interface IXpsOMPage que contém a página.

Sintaxe

HRESULT GetPage(
  [out, retval] IXpsOMPage **page
);

Parâmetros

[out, retval] page

Um ponteiro para a interface IXpsOMPage da página. Se uma página não tiver sido definida, um ponteiro NULL será retornado.

Retornar valor

O método retorna um HRESULT. Os valores possíveis incluem, mas não se limitam a, 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
o documento é NULL.
 

Esse método chama a API de Empacotamento . Para obter informações sobre os valores retornados da API de Empacotamento, consulte Erros de empacotamento.

Comentários

Se uma página não tiver sido definida, mas a interface IXpsOMPackage que contém a referência da página tiver sido carregada de um pacote XPS, esse método carregará e retornará a página. Se uma página não tiver sido definida e a interface IXpsOMPackage que contém essa referência de página não tiver sido carregada de um pacote XPS, um ponteiro NULL será retornado.

Dependendo do conteúdo da página, essa chamada pode levar algum tempo para ser retornada e também pode causar alterações inesperadas em outros objetos na árvore de documentos. Por exemplo, se a página tiver referências de dicionário de recursos remotos, o dicionário de recursos remotos poderá ser modificado.

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 Atualização de Plataforma para Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho xpsobjectmodel.h

Confira também

IXpsOMPageReference

IXpsOMPageReference::D iscardPage

IXpsOMPageReference::SetPage

Erros de empacotamento

Especificação de Papel XML

Erros de documento XPS