Метод IPrintOemUI2::HideStandardUI (prcomoem.h)
Метод IPrintOemUI2::HideStandardUI позволяет подключаемым модулем пользовательского интерфейса указать, должны ли отображаться или скрыты стандартные листы свойств. Начиная с Microsoft Windows XP этот метод можно реализовать подключаемым модулем пользовательского интерфейса Pscript5. Начиная с Windows Vista этот метод можно реализовать подключаемым модулем пользовательского интерфейса Unidrv.
Синтаксис
HRESULT HideStandardUI(
DWORD dwMode
);
Параметры
dwMode
Указывает, какой тип пользовательского интерфейса листа свойств — лист свойств документа или лист свойств устройства — скрытие. Этот параметр должен иметь одну из следующих констант, определенных в printoem.h:
| Ценность | Значение |
|---|---|
| OEMCUIP_DOCPROP | Скрытие стандартного пользовательского интерфейса листа свойств документа. |
| OEMCUIP_PRNPROP | Скрыть стандартный пользовательский интерфейс листа свойств устройства. |
Возвращаемое значение
При успешном выполнении этот метод должен возвращать S_OK. В противном случае он должен возвращать E_NOTIMPL. Дополнительные сведения см. в примечаниях.
Замечания
Этот метод поддерживается в подключаемых модулях Windows Vista для Pscript 5 и Unidrv, а также в Windows XP только для подключаемых модулей Pscript5.
В DrvDocumentPropertySheets или DrvDevicePropertySheets DDIs при>Причина pPSUIInfo-- 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. В предыдущем случае драйвер указывает, что пользовательский интерфейс стандартного листа свойств должен быть скрыт. Последний случай указывает драйверу, что должен отображаться стандартный пользовательский интерфейс листа свойств.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Настольный |
| заголовка | prcomoem.h (include Prcomoem.h) |