Метод IPrintOemUI::D ocumentPropertySheets (prcomoem.h)
Метод IPrintOemUI::DocumentPropertySheets позволяет подключаемым модулям пользовательского интерфейса добавлять новую страницу на страницу свойств документа устройства принтера.
Синтаксис
HRESULT DocumentPropertySheets(
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. Дополнительные сведения см. в описании DrvDocumentPropertySheets.
Комментарии
Метод подключаемого модуля IPrintOemUI::DocumentPropertySheets пользовательского интерфейса выполняет те же типы операций, что и функция DrvDocumentPropertySheets , экспортируемая библиотеками DLL интерфейса принтера в пользовательском режиме. Обе функции имеют одинаковые входные параметры.
Если вы предоставляете подключаемый модуль пользовательского IPrintOemUI::DocumentPropertySheets интерфейса, метод вызывается после вызова функции DrvDocumentPropertySheets драйвера.
При IPrintOemUI::DocumentPropertySheets вызове метода член lParamInit структуры PROPSHEETUI_INFO содержит адрес структуры OEMUIPSPARAM .
При реализации этого метода обычно также предоставляется _CPSUICALLBACK типизированной функции обратного вызова для обработки изменений пользователей. Эта функция обратного вызова должна вызывать IPrintOemDriverUI::D rvUpdateUISetting , чтобы сообщить драйверу об изменении значения, связанного с параметром пользовательского интерфейса, если значение хранится в структуре DEVMODEW драйвера (вместо частных элементов DEVMODEW подключаемого модуля) или в разделах реестра.
Если IPrintOemUI::DocumentPropertySheets методы экспортируются несколькими подключаемыми модулями пользовательского интерфейса, методы вызываются в том порядке, в который указаны подключаемые модули для установки.
Если один подключаемый модуль пользовательского интерфейса поддерживает несколько моделей принтеров и вы хотите, чтобы новая страница отображалась только для некоторых из этих моделей, IPrintOemUI::DocumentPropertySheets метод должен просто предоставить значение успешного возврата без фактического добавления страницы для моделей, не требующих страницы.
Дополнительные сведения о создании и установке подключаемых модулей пользовательского интерфейса см. в разделе Настройка драйверов принтеров Майкрософт.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Персональный компьютер |
| Верхняя часть | prcomoem.h (включая Prcomoem.h, Compstui.h) |