XPS OM 打印票证接口

XPS 文档 API 的此 IXpsOMPrintTicketResource 接口提供对现有打印票证的访问,以及在 XPS OM 中创建打印票证的能力。

IXpsOMPrintTicketResource 接口允许程序通过调用支持打印票证的接口的 GetPrintTicketResource 方法来读取现有打印票证的内容。 可以通过调用 SetPrintTicketResource 将新的打印票证资源添加到文档部件。

有三个打印票证级别,它们指定打印票证的范围。 打印票证级别为:作业(或包)级别、文档级别和页面级别。 下表显示了打印票证级别、相应的 XPS OM 接口和用于访问打印票证资源的方法之间的关系。

打印票证级别 接口 Get 方法 Set 方法
作业 IXpsOMDocumentSequence GetPrintTicketResource SetPrintTicketResource
文档 IXpsOMDocument GetPrintTicketResource SetPrintTicketResource
页面 IXpsOMPageReference GetPrintTicketResource SetPrintTicketResource

 

可以通过从与资源关联的流中进行读取来访问现有打印票证资源的内容。 IXpsOMPrintTicketResource 接口的 GetStream 方法返回指向包含打印票证的 XML 格式内容的只读流的指针。 打印架构规范中介绍了打印票证内容的格式。

可以通过创建新的 IXpsOMPrintTicketResource 接口来创建新的打印票证资源。 一个有效的 XML 格式的打印票证将被写入到流,并且将创建一个部件 URI 来标识打印票证部件。 有关有效打印票证内容的详细信息,请参阅打印架构规范。 流和部件 URI 作为 SetContent 调用的参数传递,用于设置新的打印票证资源,并且打印票证资源通过调用上表中所示的 SetPrintTicketResource 方法添加到相应的文档部件。

打印票证继承范围更大的打印票证的属性。 例如,文档级打印票证继承与文档的文档序列关联的作业级打印票证的属性。 同样,页面级打印票证继承与页面的文档关联的文档级打印票证的属性。 在此继承过程中,在较低级别的打印票证中指定的属性将替代从更高级别的打印票证继承的相应属性。

打印架构规范

IXpsOMDocument

IXpsOMDocumentSequence

IXpsOMPageReference

IXpsOMPrintTicketResource

XML 纸张规范