CPSUI 提供的函数

重要

新式打印平台是 Windows 与打印机通信的首选方式。 建议使用 Microsoft 的 IPP 收件箱类驱动程序以及打印支持应用 (PSA) 来自定义 Windows 10 和 11 中的打印体验,以便进行打印机设备开发。

有关详细信息,请参阅新式打印平台打印支持应用设计指南

CPSUI 为应用程序提供以下两个重要功能:

  • CommonPropertySheetUI

    CommonPropertySheetUI 函数是 CPSUI 的入口点。 该函数可创建和显示属性页,然后允许用户进行查看和修改。

    在应用程序调用 CommonPropertySheetUI 时,会提供描述要创建的页面的页面创建回调的地址。 CPSUI 调用此回调以获取页面说明。 然后显示页面,允许应用程序用户修改页面中包含的值,并使用页面事件回调将修改后的值发送给应用程序。 在用户点击“确定”或“取消”来清除属性表之前,CommonPropertySheetUI 函数不会返回。

    请注意,打印机接口 DLL 不会调用该函数,而是由打印后台处理程序调用。

  • ComPropSheet

    ComPropSheet 函数是应用程序向 CPSUI 描述属性页的一种方式,以便 CPSUI 创建和显示这些页面。 CPSUI 应用程序会在页面创建回调中调用此函数。 通常,页面描述包含一个指向页面事件回调的指针,当应用程序用户修改页面值时,CPSUI 将调用该指针。

有关调用这些函数的详细说明,请参阅将打印机驱动程序与 CPSUI 配合使用

应用程序提供的对话框程序可使用另外两个 CPSUI 提供的函数 SetCPSUIUserDataGetCPSUIUserData 来存储和检索应用程序提供的值。