IPrintOemUI：:D ocumentPropertySheets 方法 (prcomoem.h)

项目
08/07/2023

方法 IPrintOemUI::DocumentPropertySheets 允许用户界面插件将新页面追加到打印机设备的文档属性表。

语法

HRESULT DocumentPropertySheets(
  PPROPSHEETUI_INFO pPSUIInfo,
  LPARAM            lParam
);

参数

pPSUIInfo

调用方提供的指向 PROPSHEETUI_INFO 结构的指针。

lParam

调用方提供的值，该值取决于 pPSUIInfo-->Reason 中的原因值。原因值可以是以下常量之一，这些常量在 compstui.h 中定义。有关这些常量的详细信息，请参阅 PFNPROPSHEETUI 函数类型中的“备注”部分和 lParam 参数说明。

PROPSHEETUI_REASON_DESTROY

PROPSHEETUI_REASON_GET_ICON

PROPSHEETUI_REASON_GET_INFO_HEADER

PROPSHEETUI_REASON_INIT

PROPSHEETUI_REASON_SET_RESULT

返回值

返回值取决于PROPSHEETUI_INFO结构的 Reason 成员的内容。有关详细信息，请参阅 DrvDocumentPropertySheets 的说明。

注解

用户界面插件的 IPrintOemUI::DocumentPropertySheets 方法执行的操作类型与用户模式打印机接口 DLL 导出的 DrvDocumentPropertySheets 函数相同。这两个函数具有相同的输入参数。

如果提供用户界面插件，则会 IPrintOemUI::DocumentPropertySheets 在调用驱动程序的 DrvDocumentPropertySheets 函数后调用方法。

调用时IPrintOemUI::DocumentPropertySheets，PROPSHEETUI_INFO 结构的 lParamInit 成员包含 OEMUIPSPARAM 结构的地址。

如果实现此方法，通常还会提供 _CPSUICALLBACK类型的回调函数来处理用户修改。如果值存储在驱动程序的 DEVMODEW 结构 (而不是插件的专用 DEVMODEW 成员 ) 或注册表项中，则此回调函数必须调用 IPrintOemDriverUI：:D rvUpdateUISetting 以通知驱动程序与用户界面设置关联的值。

如果 IPrintOemUI::DocumentPropertySheets 方法由多个用户界面插件导出，则按照为安装指定插件的顺序调用方法。

如果一个用户界面插件支持多个打印机型号，并且你只希望为其中一些模型显示新页面，则 IPrintOemUI::DocumentPropertySheets 该方法应仅为不需要页面的模型提供成功返回值，而不实际添加页面。

有关创建和安装用户界面插件的详细信息，请参阅自定义 Microsoft 打印机驱动程序。