Initialiser un OM XPS

  • Article

Décrit comment initialiser un OM XPS, qui permet à un programme de créer un document XPS.

Les interfaces de l’API Document XPS sont créées par une interface IXpsOMObjectFactory. Pour obtenir un pointeur vers un IXpsOMObjectFactory qui peut être utilisé dans votre programme, appelez CoCreateInstance.

Avant d’utiliser les exemples de code suivants dans votre programme, lisez l’exclusion de responsabilité dans les Tâches courantes de programmation de documents XPS.

Exemple de code

L’exemple suivant crée la fabrique d’objets qui sera utilisée pour créer des interfaces OM XPS dans d’autres exemples.

    IXpsOMObjectFactory *xpsFactory;

    HRESULT hr = S_OK;

    // Init COM for this thread if it hasn't 
    //  been initialized, yet.
    hr = CoInitializeEx(0, COINIT_MULTITHREADED);

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

    if (SUCCEEDED(hr))
    {
        // Make sure that you got a pointer 
        //  to the interface.

        // Use object factory...

        // ... and release when done
        xpsFactory->Release();
    }

    // Uninitialize COM when finished
    CoUninitialize();

Meilleures pratiques

Vous pouvez rendre votre programme plus efficace en obtenant un pointeur vers une interface IXpsOMObjectFactory la première fois que vous devez appeler IXpsOMObjectFactory pour créer une interface, puis enregistrer le pointeur à utiliser dans d’autres domaines du programme. Lorsque le programme n’a plus besoin de la fabrique d’objets ou qu’il n’en a pas besoin pendant un certain temps, le pointeur peut être libéré.

Étapes suivantes

Créer un OM XPS vide

Utilisé dans cette section

IXpsOMObjectFactory

CoCreateInstance

Pour plus d'informations

Emballage

Informations de référence sur l’API Document XPS

XML Paper Specification