Interfaccia IXpsOMPageReference (xpsobjectmodel.h)

Articolo
12/22/2023

Abilita la virtualizzazione delle pagine in un documento XPS.

Un riferimento di pagina rinvia il caricamento del modello a oggetti completo di una pagina fino a quando non viene richiesta la pagina. Se la pagina non è stata modificata, può anche essere scaricata su richiesta.

Ereditarietà

L'interfaccia IXpsOMPageReference eredita dall'interfaccia IUnknown . IXpsOMPageReference include anche questi tipi di membri:

Metodi

L'interfaccia IXpsOMPageReference include questi metodi.


IXpsOMPageReference::Clone Crea una copia completa dell'interfaccia. (IXpsOMPageReference.Clone)
IXpsOMPageReference::CollectLinkTargets Ottiene un'interfaccia IXpsOMNameCollection che contiene i nomi di tutti gli oggetti sottoalbero del documento la cui proprietà IsHyperlinkTarget è impostata su TRUE.
IXpsOMPageReference::CollectPartResources Crea un elenco di tutte le risorse basate su parti associate alla pagina.
IXpsOMPageReference::D iscardPage Rimuove la pagina dalla memoria.
IXpsOMPageReference::GetAdvisoryPageDimensions Ottiene le dimensioni suggerite della pagina.
IXpsOMPageReference::GetOwner Ottiene un puntatore all'interfaccia IXpsOMDocument che contiene il riferimento alla pagina.
IXpsOMPageReference::GetPage Ottiene un puntatore all'interfaccia IXpsOMPage che contiene la pagina.
IXpsOMPageReference::GetPrintTicketResource Ottiene un puntatore all'interfaccia IXpsOMPrintTicketResource della risorsa ticket di stampa a livello di pagina associata alla pagina.
IXpsOMPageReference::GetStoryFragmentsResource Ottiene un puntatore all'interfaccia IXpsOMStoryFragmentsResource della risorsa della parte StoryFragments associata alla pagina.
IXpsOMPageReference::GetThumbnailResource Ottiene un puntatore all'interfaccia IXpsOMImageResource della risorsa immagine di anteprima associata alla pagina.
IXpsOMPageReference::HasRestrictedFonts Ottiene un valore booleano che indica se il sottoalbero del documento della pagina a cui si fa riferimento include eventuali glifi con una risorsa del tipo di carattere la cui proprietà EmbeddingOption è impostata su XPS_FONT_EMBEDDING_RESTRICTED.
IXpsOMPageReference::IsPageLoaded Ottiene lo stato della pagina a cui si fa riferimento, che indica se la pagina viene caricata.
IXpsOMPageReference::SetAdvisoryPageDimensions Imposta le dimensioni suggerite della pagina.
IXpsOMPageReference::SetPage Imposta l'interfaccia IXpsOMPage del riferimento alla pagina.
IXpsOMPageReference::SetPrintTicketResource Imposta il puntatore all'interfaccia IXpsOMPrintTicketResource della risorsa ticket di stampa a livello di pagina da assegnare alla pagina.
IXpsOMPageReference::SetStoryFragmentsResource Imposta il puntatore all'interfaccia IXpsOMStoryFragmentsResource della risorsa StoryFragments da assegnare alla pagina.
IXpsOMPageReference::SetThumbnailResource Imposta il puntatore sull'interfaccia IXpsOMImageResource della risorsa immagine di anteprima da assegnare alla pagina.

Commenti

L'esempio di codice seguente illustra come creare un'istanza di questa interfaccia.


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
}

Per informazioni sull'uso di questa interfaccia in un programma, vedere Create a Blank XPS OM and Navigate the XPS OM.For information about using this interface in a program, see Create a Blank XPS OM and Navigate the XPS OM.

Requisiti


Client minimo supportato	Windows 7, Windows Vista con SP2 e Aggiornamento della piattaforma per Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 R2, Windows Server 2008 con SP2 e Platform Update per Windows Server 2008 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	xpsobjectmodel.h