Compartilhar via


Inicializar um OM XPS

Descreve como inicializar um OM XPS, que permite que um programa crie um documento XPS.

As interfaces da API de Documento XPS são criadas por uma interface IXpsOMObjectFactory. Para obter um ponteiro para um IXpsOMObjectFactory que pode ser usado em seu programa, chame CoCreateInstance.

Antes de usar os exemplos de código a seguir em seu programa, leia o aviso de isenção de responsabilidade nas tarefas comuns de programação de documentos XPS .

Exemplo de código

O exemplo a seguir cria a fábrica de objetos que será usada para criar interfaces OM XPS em outros exemplos.

    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();

Práticas recomendadas

Você pode tornar seu programa mais eficiente obtendo um ponteiro para uma interfaceIXpsOMObjectFactoryna primeira vez que precisar chamar IXpsOMObjectFactory para criar uma interface e salvar o ponteiro para uso em outras áreas do programa. Quando o programa não precisar mais da fábrica de objetos ou não precisar dele por um tempo, o ponteiro poderá ser liberado.

próximas etapas

criar um de OM XPS em branco

usado nesta seção

IXpsOMObjectFactory

CoCreateInstance

para obter mais informações

de empacotamento

de referência da API de Documentos XPS

de especificação de papel XML