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结构 原因 成员的内容。 有关详细信息,请参阅 DrvDevicePropertySheets的说明。
言论
用户界面插件的 IPrintOemUI::DevicePropertySheets
方法执行与用户模式打印机接口 DLL 导出的 DrvDevicePropertySheets 函数相同的作类型。 这两个函数具有相同的输入参数。
如果提供用户界面插件,则调用驱动程序的 DrvDevicePropertySheets 函数后调用 IPrintOemUI::DevicePropertySheets
方法。
调用 IPrintOemUI::DevicePropertySheets
时,PROPSHEETUI_INFO 结构的 lParamInit 成员包含 OEMUIPSPARAM 结构的地址。
如果实现此方法,通常还会提供 _CPSUICALLBACK类型回调函数来处理用户修改。 此回调函数必须调用 IPrintOemDriverUI::D rvUpdateUISetting,以在修改与用户界面设置关联的值时通知驱动程序,前提是该值存储在驱动程序的 DEVMODEW 结构(而不是插件的专用 DEVMODEW 成员)或注册表项中。
如果 IPrintOemUI::DevicePropertySheets
方法由多个用户界面插件导出,则按照为安装指定插件的顺序调用这些方法。
如果一个用户界面插件支持多个打印机模型,并且仅希望为其中一些模型显示新页面,则 IPrintOemUI::DevicePropertySheets
方法应仅提供成功返回值,而无需为不需要页面的模型添加页面。
有关创建和安装用户界面插件的详细信息,请参阅 自定义Microsoft的打印机驱动程序。
要求
要求 | 价值 |
---|---|
目标平台 | 桌面 |
标头 | prcomoem.h (include Prcomoem.h) |