Write an XPS OM to an XPS Document

Describes how to write the contents of an XPS OM in a program to an XPS document file.

If a program has an XPS OM that contains a complete document, the program can write the XPS OM to a file as an XPS document, by calling the WriteToFile method of the IXpsOMPackage interface.

Before using these code examples in a program, read the disclaimer in Common XPS Document Programming Tasks.

Writing a complete XPS OM to an XPS document

After you set the contents of an XPS OM, you can save the XPS OM to a file as an XPS document, by calling the WriteToFile method of the IXpsOMPackage interface.

    HRESULT hr = S_OK;

    hr = xpsPackage->WriteToFile(
        fileName,
        NULL,                    // LPSECURITY_ATTRIBUTES
        FILE_ATTRIBUTE_NORMAL,
        FALSE                    // Optimize Markup Size
        );

Note  Writing an XPS OM to a file or stream does not automatically create a thumbnail for the XPS document. To create a thumbnail of the XPS document, use the IXpsOMThumbnailGenerator interface.

 

Incrementally writing an XPS document

The IXpsOMPackageWriter interface can be used to write the parts of an XPS document incrementally; for example, when the document parts are created or processed in sequence.

Note  Writing an XPS OM to a file or stream does not automatically create a thumbnail for the XPS document. To create a thumbnail of the XPS document, use the IXpsOMThumbnailGenerator interface.

 

Next Steps

Print an XPS OM

Used in This Section

IOpcPartUri

IXpsOMPackage

IXpsOMThumbnailGenerator

For More Information

Initialize an XPS OM

XPS Document API Reference

XML Paper Specification