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

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

语法

HRESULT DevicePropertySheets(
  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 成员的内容。 有关详细信息,请参阅 DrvDevicePropertySheets 的说明。

注解

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

如果提供用户界面插件,则会 IPrintOemUI::DevicePropertySheets 在调用驱动程序的 DrvDevicePropertySheets 函数后调用该方法。

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

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

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

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

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

要求

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

另请参阅

DrvDevicePropertySheets

IPrintOemUI

IPrintOemUI::D ocumentPropertySheets

PFNPROPSHEETUI