CPSUI 提供的函数

重要

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

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

CPSUI 为应用程序提供以下两个重要函数：

• CommonPropertySheetUI

  CommonPropertySheetUI 函数是 CPSUI 的入口点。 函数会导致创建和显示属性表页，然后允许用户查看和修改它们。

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

  请注意，打印机接口 DLL 不调用此函数;它由打印后台处理程序调用。

• ComPropSheet

  ComPropSheet 函数是应用程序向 CPSUI 描述属性表页的方式，以便 CPSUI 可以创建和显示它们。 CPSUI 应用程序从 页面创建回调中调用此函数。 通常，页面说明包括指向 页面事件回调的指针，当应用程序用户修改页面值时，CPSUI 将调用该回调。

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

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