CPSUI 提供的函数

重要

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

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

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

• CommonPropertySheetUI

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

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

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

• ComPropSheet

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

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

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