用于指定页面的方法

重要

建议使用 Microsoft 的 IPP 收件箱类驱动程序，以及 Print Support Apps (PSA) ，在 Windows 10 和 11 中自定义打印体验，以便进行打印机设备开发。

有关详细信息，请参阅 打印支持应用设计指南。

应用程序可以使用三种方法中的任意一种方法将属性表页指定为 CPSUI。 以下每种方法都涉及调用 CPSUI 的 ComPropSheet 函数，并指定其中一个 ComPropSheet 函数代码。

• 提供 COMPROPSHEETUI 结构

  如果应用程序通过将 COMPROPSHEETUI 结构传递给 ComPropSheet 来描述属性表页，它可以：

  • 使用 CPSUI 提供的页面和模板 之一来指定打印机接口 DLL 可用于打印机属性表的预定义的标准页面类型。

  • 指定一组将显示在页面上的用户可修改 的属性表选项 。

  • 指定当用户查看或修改页面的选项时 CPSUI 将调用的页面 事件回调 函数。

• 提供 PROPSHEETPAGE 结构

  如果无法使用使用 COMPROPSHEETUI 结构时可用的常用 (标准) 对话框构造属性表页，则可以使用 PROPSHEETPAGE 结构来描述属性表页。 打印机接口 DLL 通常不需要使用此方法。

• 提供回调函数

  应用程序可以将 ComPropSheet 传递给 CPSUI 立即调用的 PFNPROPSHEETUI 类型回调函数的地址。 回调函数负责调用 ComPropSheet 本身来创建属性表页。

  打印后台处理程序使用此方法通知 CPSUI 是否存在打印机接口 DLL 的 DrvDocumentPropertySheets 和 DrvDevicePropertySheets 函数。 同样，Unidrv 和 Pscript 驱动程序使用技术通知 CPSUI 用户界面插件中是否存在 IPrintOemUI：:D ocumentPropertySheets 和 IPrintOemUI：:D evicePropertySheets COM 方法。

无论使用哪种方法来指定新页面，都必须通过将 组父句 柄传递给 ComPropSheet 函数，将页面分配给组父级。