Поделиться через

Метод 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)

См. также раздел

DrvDocumentPropertySheets

IPrintOemUI

IPrintOemUI::D evicePropertySheets

PFNPROPSHEETUI