Метод IPrintOemUI2::HideStandardUI (prcomoem.h)

Статья
08/07/2023

Метод IPrintOemUI2::HideStandardUI позволяет подключаемым модулям пользовательского интерфейса указать, должны ли отображаться или скрываться стандартные страницы свойств. Начиная с Microsoft Windows XP этот метод можно реализовать с помощью подключаемого модуля пользовательского интерфейса Pscript5. Начиная с Windows Vista этот метод можно реализовать с помощью подключаемого модуля пользовательского интерфейса Unidrv.

Синтаксис

HRESULT HideStandardUI(
  DWORD dwMode
);

Параметры

dwMode

Указывает тип пользовательского интерфейса страницы свойств (лист свойств документа или лист свойств устройства) для скрытия. Для этого параметра следует задать одну из следующих констант, которые определены в printoem.h:

Значение	Значение
OEMCUIP_DOCPROP	Скрыть пользовательский интерфейс стандартного листа свойств документа.
OEMCUIP_PRNPROP	Скрытие стандартного пользовательского интерфейса страницы свойств устройства.

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

При успешном выполнении этот метод должен возвращать S_OK. В противном случае он должен вернуть E_NOTIMPL. Дополнительные сведения см. в разделе Примечания.

В DDIs DrvDocumentPropertySheets или DrvDevicePropertySheets , когда pPSUIInfo-->Reason имеет значение PROPSHEETUI_REASON_INIT, драйвер вызывает IPrintOemUI2::HideStandardUI метод , чтобы запросить подключаемый модуль пользовательского интерфейса о запросах пользовательского интерфейса. Этот метод может реагировать любым из четырех способов:

Скрыть пользовательский интерфейс стандартного листа свойств документа.
Скрытие стандартного пользовательского интерфейса страницы свойств устройства.
Скрыть все стандартные пользовательский интерфейс страницы свойств.
Не скрывайте стандартный пользовательский интерфейс страницы свойств.

В следующей таблице приведены сведения о IPrintOemUI2::HideStandardUI том, как метод будет реагировать в каждой из этих ситуаций.

Чтобы указать этот ответ...	IPrintOemUI2::HideStandardUI возвращает...
Скрыть пользовательский интерфейс стандартного листа свойств документа. Подключаемый модуль реализует собственный пользовательский интерфейс листа свойств документа.	Если dwMode == OEMCUIP_DOCPROP, возвращается S_OK; в противном случае возвращает E_NOTIMPL.
Скрытие стандартного пользовательского интерфейса страницы свойств устройства. Подключаемый модуль реализует собственный пользовательский интерфейс страницы свойств устройства.	Если dwMode == OEMCUIP_PRNPROP, возвращается S_OK; в противном случае возвращает E_NOTIMPL.
Скрыть все стандартные пользовательский интерфейс страницы свойств. Подключаемый модуль реализует собственный пользовательский интерфейс страницы свойств документа и страницы свойств устройства.	Возвращает S_OK независимо от значения dwMode.
Отображение всего стандартного пользовательского интерфейса страницы свойств.	Возвращает E_NOTIMPL независимо от значения dwMode.

IPrintOemUI2::HideStandardUI Если метод указывает драйверу, что все стандартные страницы свойств должны быть скрыты, драйвер пропускает вызовы compstui.dll (см. раздел Компоненты Pscript) для добавления стандартных таблиц свойств. Подключаемый модуль пользовательского интерфейса должен реализовывать по крайней мере один пользовательский интерфейс пользовательского листа свойств, если IPrintOemUI2::HideStandardUI возвращает S_OK.

Если на принтере установлено несколько подключаемых модулей пользовательского интерфейса, драйвер вызывает подключаемые модули пользовательского интерфейса в том порядке, в котором они были установлены, пока один из них не вернет S_OK или пока не будут вызваны все подключаемые модули пользовательского интерфейса и ни один из них не вернул S_OK. Первый вариант указывает драйверу, что стандартный пользовательский интерфейс страницы свойств должен быть скрыт. Последний вариант указывает драйверу, что должен отображаться стандартный пользовательский интерфейс страницы свойств.