使用 IXpsOMPackageWriter 接口

项目
10/23/2023

IXpsOMPackageWriter 接口创建一个 XPS 文档文件，应用程序可以将 XPS OM 的 IXpsOMPage 接口的内容写入其中。当按顺序处理或创建文档内容时，IXpsOMPackageWriter 接口最有用。与 IXpsOMPackage 接口的 WriteToFile 和 WriteToStream 方法不同，若要使用 IXpsOMPackageWriter 接口，既不需要完成整个FixedDocument，也不需要完成FixedDocumentSequence。

概述

IXpsOMPackageWriter 接口一次写入一页（从 XPS 文档的第一页到最后一页）。该接口可用于创建简单的 XPS 文档文件以及在 FixedDocumentSequence 中包含多个 FixedDocument 的复杂 XPS 文档文件。在复杂的 XPS 文档文件中，FixedDocument 也是按顺序创建的，从 FixedDocumentSequence 中的第一个 FixedDocument 开始。 IXpsOMPackageWriter 接口不支持以随机顺序创建文档内容。例如，使用它来创建顺序报告或在设备驱动程序筛选器中执行处理，其中的文档内容按顺序馈送到驱动程序。

术语回顾

XPS 文档文件是符合 XML 纸张规范的开放式打包约定 (OPC) 包。因此，从技术上讲，IXpsOMPackageWriter 接口会创建一个 OPC 包，但它是一个符合 XML 纸张规范的 OPC 包。因此，在有关 XPS 文档的讨论中，术语“XPS 文档”和“包”经常互换使用。

由 IXpsOMPackageWriter 接口创建的包会包含所需的 XPS 文档组件：一个 FixedDocumentSequence、至少一个 FixedDocument 和至少一个 FixedPage。实例化 IXpsOMPackageWriter 接口时，会创建 FixedDocumentSequence。每次调用 IXpsOMPackageWriter::StartNewDocument 时都会创建一个 FixedDocument，每次调用 IXpsOMPackageWriter::AddPage 时都会创建一个 FixPage。由于接口按顺序写入文档内容，因此 AddPage 方法会将页面添加到最近创建的 FixedDocument 中。