Interface IXpsOMPageReference (xpsobjectmodel.h)

Artigo
08/28/2023

Habilita a virtualização de páginas em um documento XPS.

Uma referência de página adia o carregamento do modelo de objeto completo de uma página até que a página seja solicitada. Se a página não tiver sido alterada, ela também poderá ser descarregada na solicitação.

Herança

A interface IXpsOMPageReference herda da interface IUnknown . IXpsOMPageReference também tem estes tipos de membros:

Métodos

A interface IXpsOMPageReference tem esses métodos.


IXpsOMPageReference::Clone Faz uma cópia profunda da interface. (IXpsOMPageReference.Clone)
IXpsOMPageReference::CollectLinkTargets Obtém uma interface IXpsOMNameCollection que contém os nomes de todos os objetos de subárvore do documento cuja propriedade IsHyperlinkTarget está definida como TRUE.
IXpsOMPageReference::CollectPartResources Cria uma lista de todos os recursos baseados em parte associados à página.
IXpsOMPageReference::D iscardPage Descarta a página da memória.
IXpsOMPageReference::GetAdvisoryPageDimensions Obtém as dimensões sugeridas da página.
IXpsOMPageReference::GetOwner Obtém um ponteiro para a interface IXpsOMDocument que contém a referência de página.
IXpsOMPageReference::GetPage Obtém um ponteiro para a interface IXpsOMPage que contém a página.
IXpsOMPageReference::GetPrintTicketResource Obtém um ponteiro para a interface IXpsOMPrintTicketResource do recurso de tíquete de impressão no nível da página associado à página.
IXpsOMPageReference::GetStoryFragmentsResource Obtém um ponteiro para a interface IXpsOMStoryFragmentsResource do recurso de parte StoryFragments associado à página.
IXpsOMPageReference::GetThumbnailResource Obtém um ponteiro para a interface IXpsOMImageResource do recurso de imagem em miniatura associado à página.
IXpsOMPageReference::HasRestrictedFonts Obtém um valor booliano que indica se a subárvore do documento da página referenciada inclui qualquer Glyphs que tenha um recurso de fonte cuja propriedade EmbeddingOption está definida como XPS_FONT_EMBEDDING_RESTRICTED.
IXpsOMPageReference::IsPageLoaded Obtém a página referenciada status, que indica se a página é carregada.
IXpsOMPageReference::SetAdvisoryPageDimensions Define as dimensões sugeridas da página.
IXpsOMPageReference::SetPage Define a interface IXpsOMPage da referência de página.
IXpsOMPageReference::SetPrintTicketResource Define o ponteiro da interface IXpsOMPrintTicketResource do recurso de tíquete de impressão no nível da página que deve ser atribuído à página.
IXpsOMPageReference::SetStoryFragmentsResource Define o ponteiro da interface IXpsOMStoryFragmentsResource do recurso StoryFragments a ser atribuído à página.
IXpsOMPageReference::SetThumbnailResource Define o ponteiro para a interface IXpsOMImageResource do recurso de imagem em miniatura a ser atribuído à página.

Comentários

O exemplo de código a seguir ilustra como criar uma instância dessa interface.


IXpsOMPageReference    *newInterface;
// The following value is defined outside of 
// this example.
XPS_SIZE        advisoryPageDimensions;

// Note the implicit requirement that CoInitializeEx 
//  has previously been called from this thread.

hr = CoCreateInstance(
    __uuidof(XpsOMObjectFactory),
    NULL,
    CLSCTX_INPROC_SERVER,
    _uuidof(IXpsOMObjectFactory),
    reinterpret_cast<LPVOID*>(&xpsFactory)
    );

if (SUCCEEDED(hr))
{
    hr = xpsFactory->CreatePageReference (
        &advisoryPageDimensions,
        &newInterface);

    if (SUCCEEDED(hr))
    {
        // use newInterface

        newInterface->Release();
    }
    xpsFactory->Release();
}
else
{
    // evaluate HRESULT error returned in hr
}

Para obter informações sobre como usar essa interface em um programa, consulte Criar um OM XPS em branco e Navegar no OM XPS.

Requisitos


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