Метод IPrintOemUI::D evicePropertySheets (prcomoem.h)

Статья
03/01/2024

Метод IPrintOemUI::DevicePropertySheets позволяет подключаемого модуля пользовательского интерфейса добавлять новую страницу к листу свойств принтера устройства принтера.

Синтаксис

HRESULT DevicePropertySheets(
  PPROPSHEETUI_INFO pPSUIInfo,
  LPARAM            lParam
);

Параметры

pPSUIInfo

Указатель на структуру PROPSHEETUI_INFO , предоставленный вызывающим абонентом.

lParam

Предоставленное вызывающим абонентом значение, которое зависит от значения причины в pPSUIInfo-->Reason. Значением причины может быть одна из следующих констант, которые определены в файле compstui.h. Дополнительные сведения об этих константах см. в разделе Примечания и описании параметра lParam в типе функции PFNPROPSHEETUI .

PROPSHEETUI_REASON_DESTROY

PROPSHEETUI_REASON_GET_ICON

PROPSHEETUI_REASON_GET_INFO_HEADER

PROPSHEETUI_REASON_INIT

PROPSHEETUI_REASON_SET_RESULT

Возвращаемое значение

Возвращаемое значение зависит от содержимого элемента Reason структуры PROPSHEETUI_INFO. Дополнительные сведения см. в описании DrvDevicePropertySheets.

Метод подключаемого модуля IPrintOemUI::DevicePropertySheets пользовательского интерфейса выполняет те же типы операций, что и функция DrvDevicePropertySheets , экспортируемая библиотеками DLL интерфейса принтера в пользовательском режиме. Обе функции имеют одинаковые входные параметры.

Если вы предоставляете подключаемый модуль пользовательского IPrintOemUI::DevicePropertySheets интерфейса, метод вызывается после вызова функции DrvDevicePropertySheets драйвера.

При IPrintOemUI::DevicePropertySheets вызове метода член lParamInit структуры PROPSHEETUI_INFO содержит адрес структуры OEMUIPSPARAM .

При реализации этого метода обычно также предоставляется _CPSUICALLBACK типизированной функции обратного вызова для обработки изменений пользователей. Эта функция обратного вызова должна вызывать IPrintOemDriverUI::D rvUpdateUISetting , чтобы сообщить драйверу об изменении значения, связанного с параметром пользовательского интерфейса, если значение хранится в структуре DEVMODEW драйвера (вместо частных элементов DEVMODEW подключаемого модуля) или в разделах реестра.

Если IPrintOemUI::DevicePropertySheets методы экспортируются несколькими подключаемыми модулями пользовательского интерфейса, методы вызываются в том порядке, в который указаны подключаемые модули для установки.

Если один подключаемый модуль пользовательского интерфейса поддерживает несколько моделей принтеров и вы хотите, чтобы новая страница отображалась только для некоторых из этих моделей, IPrintOemUI::DevicePropertySheets метод должен просто предоставить значение успешного возврата без фактического добавления страницы для моделей, не требующих страницы.

Дополнительные сведения о создании и установке подключаемых модулей пользовательского интерфейса см. в разделе Настройка драйверов принтеров Майкрософт.