Interface IXpsOMPageReference (xpsobjectmodel.h)

Article
12/22/2023

Active la virtualisation des pages dans un document XPS.

Une référence de page reporte le chargement du modèle objet complet d’une page jusqu’à ce que la page soit demandée. Si la page n’a pas été modifiée, elle peut également être déchargée sur demande.

Héritage

L’interface IXpsOMPageReference hérite de l’interface IUnknown. IXpsOMPageReference a également les types de membres suivants :

Méthodes

L’interface IXpsOMPageReference a ces méthodes.


IXpsOMPageReference ::Clone Effectue une copie complète de l’interface. (IXpsOMPageReference.Clone)
IXpsOMPageReference ::CollectLinkTargets Obtient une interface IXpsOMNameCollection qui contient les noms de tous les objets de sous-arborescence de document dont la propriété IsHyperlinkTarget a la valeur TRUE.
IXpsOMPageReference ::CollectPartResources Crée une liste de toutes les ressources basées sur des parties qui sont associées à la page.
IXpsOMPageReference ::D iscardPage Supprime la page de la mémoire.
IXpsOMPageReference ::GetAdvisoryPageDimensions Obtient les dimensions suggérées de la page.
IXpsOMPageReference ::GetOwner Obtient un pointeur vers l’interface IXpsOMDocument qui contient la référence de page.
IXpsOMPageReference ::GetPage Obtient un pointeur vers l’interface IXpsOMPage qui contient la page.
IXpsOMPageReference ::GetPrintTicketResource Obtient un pointeur vers l’interface IXpsOMPrintTicketResource de la ressource de ticket d’impression au niveau de la page associée à la page.
IXpsOMPageReference ::GetStoryFragmentsResource Obtient un pointeur vers l’interface IXpsOMStoryFragmentsResource de la ressource de composant StoryFragments associée à la page.
IXpsOMPageReference ::GetThumbnailResource Obtient un pointeur vers l’interface IXpsOMImageResource de la ressource d’image miniature associée à la page.
IXpsOMPageReference ::HasRestrictedFonts Obtient une valeur booléenne qui indique si la sous-arborescence de document de la page référencée inclut des Glyphes qui ont une ressource de police dont la propriété EmbeddingOption est définie sur XPS_FONT_EMBEDDING_RESTRICTED.
IXpsOMPageReference ::IsPageLoaded Obtient la page référencée status, qui indique si la page est chargée.
IXpsOMPageReference ::SetAdvisoryPageDimensions Définit les dimensions suggérées de la page.
IXpsOMPageReference ::SetPage Définit l’interface IXpsOMPage de la référence de page.
IXpsOMPageReference ::SetPrintTicketResource Définit le pointeur d’interface IXpsOMPrintTicketResource de la ressource de ticket d’impression au niveau de la page qui doit être affectée à la page.
IXpsOMPageReference ::SetStoryFragmentsResource Définit le pointeur d’interface IXpsOMStoryFragmentsResource de la ressource StoryFragments à affecter à la page.
IXpsOMPageReference ::SetThumbnailResource Définit le pointeur vers l’interface IXpsOMImageResource de la ressource d’image miniature à affecter à la page.

Remarques

L’exemple de code qui suit montre comment créer une instance de cette 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
}

Pour plus d’informations sur l’utilisation de cette interface dans un programme, consultez Créer un modèle objet XPS vide et Parcourir le modèle d’interface utilisateur XPS.

Configuration requise


Client minimal pris en charge	Windows 7, Windows Vista avec SP2 et Mise à jour de plateforme pour Windows Vista [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2008 R2, Windows Server 2008 avec SP2 et Platform Update pour Windows Server 2008 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	xpsobjectmodel.h