Partager via

XPS OM Package Interfaces

Les interfaces de package représentent le niveau supérieur de l’om XPS, qui correspond à un fichier de document XPS. Ces interfaces contiennent des méthodes qui sérialisent un modèle XPS vers un document ou un flux XPS et désérialisent un package XPS pour créer un modèle XPS qui permet à un programme d’accéder au contenu d’un document.

Nom de l’interface Interfaces enfants logiques Description
IXpsOMPackage
 IXpsOMDocumentSequence
IXpsOMCoreProperties
 Om XPS complet qui correspond au package qui contient le document XPS.
IXpsOMPackageWriter
 Aucun
 Permet la sérialisation incrémentielle des pages de documents dans un package.
IXpsOMCoreProperties
 Aucun
 Accède aux métadonnées du document.

Exemples de code

Les exemples de code qui suivent illustrent l’utilisation de certaines interfaces de package par un programme. Sauf indication contraire, tous les éléments italiques sont des noms de paramètres.

Lire un document XPS dans un MODÈLE XPS

À partir d’un document XPS existant dont le nom de fichier est stocké dans xpsDocumentFilename, cet exemple de code crée un om XPS référencé par xpsPackage.

    HRESULT                 hr = S_OK;
    IXpsOMPackage           *xpsPackage;

    hr = xpsFactory->CreatePackageFromFile(
        xpsDocumentFilename,
        FALSE,
        &xpsPackage);

    // xpsPackage now contains a pointer to the IXpsOMPackage
    // object that has been populated with the contents
    // of the XPS document in xpsDocumentFilename.

Écrire un MODÈLE XPS dans un fichier de document XPS

L’exemple de code suivant écrit l’om XPS référencé par xpsPackage. L’exemple crée un document XPS dans le fichier dont le nom est stocké dans fileName.

    HRESULT hr = S_OK;

    hr = xpsPackage->WriteToFile(
        xpsDocumentFilename,
        NULL,                    // LPSECURITY_ATTRIBUTES
        FILE_ATTRIBUTE_NORMAL,
        FALSE);                  // optimizeMarkupSize

Accéder à la séquence de documents de l’om XPS

L’exemple de code suivant obtient un pointeur vers l’interface IXpsOMDocumentSequence, qui contient la séquence de documents de l’om XPS représenté par xpsPackage.

    HRESULT                         hr = S_OK;
    IXpsOMDocumentSequence          *docSeq;
    IXpsOMDocumentCollection        *docs;

    // get the fixed document sequence of the package
    hr = xpsPackage->GetDocumentSequence(&docSeq);

    // get the collection of fixed documents in 
    //  the fixed document sequence
    hr = docSeq->GetDocuments(&docs);

Accéder à CoreProperties du document

L’exemple de code suivant obtient un pointeur vers l’interface IXpsOMCoreProperties, ce qui permet au programme d’accéder au contenu de la partie CoreProperties. Dans l’exemple, le document est supposé avoir été lu dans un modèle XPS représenté par xpsPackage.

    HRESULT                         hr = S_OK;
    IXpsOMCoreProperties            *coreProps;
    LPWSTR                          title;

    // get the fixed document sequence of the package
    hr = xpsPackage->GetCoreProperties(&coreProps);

    // get the title property 
    hr = coreProps->GetTitle(&title);

    // do something with the title property here...

    // free the string when finished with it
    CoTaskMemFree ( title );
    coreProps->Release();

à l’aide de l’interface IXpsOMPackageWriter

Naviguer dans le de l’om XPS

interface IXpsOMDocumentSequence

interface IXpsOMPackage

interface IXpsOMPackageWriter

interface IXpsOMCoreProperties

  • Last updated on