大网数据广告活动
打印与设备

App Support for OpenXPS Printing

· 52CE 我爱测

OpenXPS is the Open XML Paper Specification format for documents, and it’s based on the European Carton Makers Association (ECMA) standard specification.

OpenXPS is the Open XML Paper Specification format for documents, and it’s based on the European Computer Manufacturers Association (ECMA) standard specification.

Windows 8 provides full support for OpenXPS printing via the v4 print driver model, side-by-side with continued support for the Microsoft XPS format. And this topic focuses on the portion of this support that is relevant to Windows application developers. For information about driver requirements for OpenXPS support, see Driver Support for OpenXPS.

Sending XPS data to the Print System

We recommend that you use IPrintDocumentPackageTarget for sending all XPS print jobs to the print system. IPrintDocumentPackageTarget accepts the XPS object model (OM) without serialization, and that helps to improve the overall performance.

Here's a brief summary of the IPrintDocumentPackageTarget interface:

  • This interface supports printing from tailored solutions as well as desktop applications.

  • For desktops apps, this can be used in place of StartXpsPrintJob1.

  • Available on Windows 7 with Service Pack 1 (SP1) + Platform Update, and Windows 8.

  • Include DocumentTarget.h in projects to use these APIs.

Applications that consume OpenXPS documents should note that the MIME type for OpenXPS is as follows:

application\oxps

Sending OpenXPS data to the XPS Print API

Specific to OpenXPS, XPS OM accepts both MSXPS and OpenXPS, and provides methods for conversion and serialization to either format. This allows application developers to be agnostic of the target driver, if they want. This also means that app developers can always submit print jobs as XPS OM to either StartXpsPrintJob1 or IDocumentPackageTarget, knowing that the print system will handle any necessary conversion.

Of course, preventing conversion between XPS formats will improve end-to-end performance. From the application, the developer can check the following registry key to determine the preferred XPS format of the targeted print driver:

HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Print\Printers\[PrintDriverName]\PrintDriverData\XpsFormat

Once the preferred XPS format has been determined, the application can provide XPS OM objects that will not require conversion. Of particular note is the use of HD Photo in MSXPS and JPEGXR in OpenXPS. Converting from JPEGXR to HD Photo is relatively lightweight since the primary difference in this conversion is that HD Photo ignores 4 control bits that JPEGXR requires. However, converting from HD Photo to JPEGXR requires the entire image to be re-encoded in order to generate the required control bits. Thus, providing JPEGXR images for high-resolution images will ensure compatibility with OpenXPS and minimize the conversion cost of the image for MSXPS.

The Xpsobjectmodel_1.h header defines the additional APIs and objects for OpenXPS. And the IXpsOMObjectFactory1 interface provides additional methods for image conversion. Here's the syntax:

IXpsOMObjectFactory1->ConvertHDPhotoToJpegXR(IXpsOMImageResource *imageResource);

IXpsOMObjectFactory1->ConvertJpegXRToHDPhoto(IXpsOMImageResource *imageResource);

Windows 8 provides the following new and updated enumerations.

New enumeration:

XPS_DOCUMENT_TYPE

Updated enumeration

XPS_IMAGE_TYPE

The new GetDocumentType methods allow an application to determine the XPS format of documents. These are available in IXpsOMObjectFactory1, IXpsOMPackage1, and IXpsOMPage1. Here's a list of the methods.

IXpsOMObjectFactory1::GetDocumentTypeFromFile
IXpsOMObjectFactory1::GetDocumentTypeFromStream
IXpsOMPackage1::GetDocumentType
IXpsOMPage1::GetDocumentType

Windows 8 provides the following new error codes in support of OpenXPS:

XPS_E_MISMATCHED_NAMESPACE. This error is returned, if there is a mismatched namespace.
XPS_E_ABSOLUTE_REFERENCE. This error is returned if MSXPS uses absolute URIs in internal references, or attempts to use internal references to serialize in the stream. That is because XPS OM generates relative URIs. And although MSXPS supports both relative and absolute URIs, OpenXPS requires relative URIs.

Related topics

Driver Support for OpenXPS

IPrintDocumentPackageTarget

IXpsOMObjectFactory1::GetDocumentTypeFromFile

IXpsOMObjectFactory1::GetDocumentTypeFromStream

IXpsOMPackage1::GetDocumentType

IXpsOMPage1::GetDocumentType

XPS_DOCUMENT_TYPE

XPS_IMAGE_TYPE

Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.

资料来源与适用范围

资料来源
Microsoft Learn / Windows Win32 documentation
适用范围
Windows Win32 API · Source date 05/31/2018
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 4.0 (documentation), MIT (code samples)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。