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

该方法 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::DocumentPropertySheetsPROPSHEETUI_INFO结构的 lParamInit 成员包含 OEMUIPSPARAM 结构的地址。

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

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

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

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

要求

   
目标平台 桌面
Header prcomoem.h (包括 Prcomoem.h、Compstui.h)

另请参阅

DrvDocumentPropertySheets

IPrintOemUI

IPrintOemUI::D evicePropertySheets

PFNPROPSHEETUI