Interface IXpsOMPage (xpsobjectmodel.h)

Article
03/13/2024

Fournit le nœud racine d’une arborescence d’objets qui contiennent le contenu d’une seule page.

L’interface IXpsOMPage correspond à l’élément FixedPage dans le balisage de document XPS.

Héritage

L’interface IXpsOMPage hérite d’IXpsOMPart. IXpsOMPage a également les types de membres suivants :

Méthodes

L’interface IXpsOMPage utilise ces méthodes.


IXpsOMPage ::Clone Effectue une copie approfondie de l’interface. (IXpsOMPage.Clone)
IXpsOMPage ::GenerateUnusedLookupKey Génère un nom unique qui peut être utilisé comme clé de recherche par une ressource dans un dictionnaire de ressources.
IXpsOMPage ::GetBleedBox Obtient les dimensions de la zone de purge de la page.
IXpsOMPage ::GetContentBox Obtient les dimensions de la zone de contenu de la page.
IXpsOMPage ::GetDictionary Obtient un pointeur vers l’interface IXpsOMDictionary résolue associée à cette page.
IXpsOMPage ::GetDictionaryLocal Obtient un pointeur vers l’interface IXpsOMDictionary du dictionnaire local et non partagé associé à cette page.
IXpsOMPage ::GetDictionaryResource Obtient un pointeur vers l’interface IXpsOMRemoteDictionaryResource de la ressource de dictionnaire partagé utilisée par cette page.
IXpsOMPage ::GetIsHyperlinkTarget Obtient une valeur booléenne qui indique si la page est la cible d’un lien hypertexte.
IXpsOMPage ::GetLanguage Obtient la propriété Language de la page.
IXpsOMPage ::GetName Obtient la propriété Name de la page.
IXpsOMPage ::GetOwner Obtient un pointeur vers l’interface IXpsOMPageReference qui contient la page.
IXpsOMPage ::GetPageDimensions Obtient les dimensions de la page.
IXpsOMPage ::GetVisuals Obtient un pointeur vers une interface IXpsOMVisualCollection qui contient une collection d’objets visuels de la page.
IXpsOMPage ::SetBleedBox Définit les dimensions de la zone de purge de la page.
IXpsOMPage ::SetContentBox Définit les dimensions de la zone de contenu de la page.
IXpsOMPage ::SetDictionaryLocal Définit le pointeur d’interface IXpsOMDictionary de la ressource de dictionnaire local de la page.
IXpsOMPage ::SetDictionaryResource Définit le pointeur d’interface IXpsOMRemoteDictionaryResource de la ressource de dictionnaire distant de la page.
IXpsOMPage ::SetIsHyperlinkTarget Spécifie si la page est la cible d’un lien hypertexte.
IXpsOMPage ::SetLanguage Définit la propriété Language de la page.
IXpsOMPage ::SetName Définit la propriété Name de cette page.
IXpsOMPage ::SetPageDimensions Définit les dimensions de la page.
IXpsOMPage ::Write Écrit la page dans le flux spécifié.

Remarques

L’exemple de code qui suit montre comment créer un instance de cette interface.


IXpsOMPage        *newInterface;
// The following values are defined outside of 
// this example.
//  LPWSTR        language;
//  XPS_SIZE      pageDimensions;

// 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->CreatePartUri(partUriString, &partUri);
    if (SUCCEEDED(hr))
    {
        hr = xpsFactory->CreatePage (
            &pageDimensions,
            language,
            partUri,
            &newInterface);

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

            newInterface->Release();
        }
        partUri->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 om XPS vide et Naviguer dans le modèle d’utilisation XPS.

Configuration requise

Condition requise	Valeur
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 Mise à jour de plateforme pour Windows Server 2008 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	xpsobjectmodel.h