Método IPrintOemUI2::HideStandardUI (prcomoem.h)

El IPrintOemUI2::HideStandardUI método permite que un complemento de interfaz de usuario especifique si las hojas de propiedades estándar deben mostrarse u ocultarse. A partir de Microsoft Windows XP, este método se puede implementar mediante un complemento de interfaz de usuario Pscript5. A partir de Windows Vista, este método se puede implementar mediante un complemento de interfaz de usuario Unidrv.

Sintaxis

HRESULT HideStandardUI(
  DWORD dwMode
);

Parámetros

dwMode

Especifica qué tipo de interfaz de usuario de hoja de propiedades (hoja de propiedades del documento o hoja de propiedades del dispositivo) se ocultarán. Este parámetro debe establecerse en una de las siguientes constantes, que se definen en printoem.h:

Valor	Significado
OEMCUIP_DOCPROP	Ocultar la interfaz de usuario de la hoja de propiedades del documento estándar.
OEMCUIP_PRNPROP	Ocultar la interfaz de usuario de la hoja de propiedades del dispositivo estándar.

Valor devuelto

Si se ejecuta correctamente, este método debe devolver S_OK. De lo contrario, debe devolver E_NOTIMPL. Vea Comentarios para obtener información adicional.

Comentarios

Este método se admite en Windows Vista para complementos Pscript 5 y Unidrv, y en Windows XP solo para complementos Pscript5.

Dentro de los DDIs de DrvDocumentPropertySheets o DrvDevicePropertySheets cuando pPSUIInfo-->Reason está establecido en PROPSHEETUI_REASON_INIT, el controlador llama al método para preguntar al IPrintOemUI2::HideStandardUI complemento de interfaz de usuario sobre las solicitudes de la interfaz de usuario. Este método puede responder de cualquiera de las cuatro maneras siguientes:

1. Ocultar la interfaz de usuario de la hoja de propiedades del documento estándar.
2. Ocultar la interfaz de usuario de la hoja de propiedades del dispositivo estándar.
3. Ocultar toda la interfaz de usuario de la hoja de propiedades estándar.
4. No oculte ninguna interfaz de usuario de hoja de propiedades estándar.

En la tabla siguiente se resume cómo respondería el IPrintOemUI2::HideStandardUI método en cada una de estas situaciones.

Para indicar esta respuesta...	IPrintOemUI2::HideStandardUI devuelve...
Ocultar la interfaz de usuario de la hoja de propiedades del documento estándar. El complemento implementa su propia interfaz de usuario de hoja de propiedades de documento.	Si dwMode == OEMCUIP_DOCPROP, devuelva S_OK; de lo contrario, devuelve E_NOTIMPL.
Ocultar la interfaz de usuario de la hoja de propiedades del dispositivo estándar. El complemento implementa su propia interfaz de usuario de hoja de propiedades de dispositivo.	Si dwMode == OEMCUIP_PRNPROP, devuelva S_OK; de lo contrario, devuelve E_NOTIMPL.
Ocultar toda la interfaz de usuario de la hoja de propiedades estándar. El complemento implementa su propia hoja de propiedades de documento y la interfaz de usuario de la hoja de propiedades del dispositivo.	Devuelve S_OK, independientemente del valor de dwMode.
Muestra toda la interfaz de usuario de la hoja de propiedades estándar.	Devuelve E_NOTIMPL, independientemente del valor de dwMode.

 

Si el IPrintOemUI2::HideStandardUI método indica al controlador que todas las hojas de propiedades estándar deben estar ocultas, el controlador omite las llamadas a compstui.dll (vea Componentes de Pscript) para agregar las hojas de propiedades estándar. Un complemento de interfaz de usuario debe implementar al menos una interfaz de usuario de hoja de propiedades personalizada si IPrintOemUI2::HideStandardUI devuelve S_OK.

Cuando la impresora tiene instalados varios complementos de interfaz de usuario, el controlador llama a los complementos de interfaz de usuario en el orden en que se instalaron, hasta que uno de ellos devuelve S_OK, o hasta que se haya llamado a todos los complementos de la interfaz de usuario y ninguno de ellos devuelva S_OK. El caso anterior indica al controlador que debe ocultarse la interfaz de usuario de la hoja de propiedades estándar. Este último caso indica al controlador que se debe mostrar la interfaz de usuario de la hoja de propiedades estándar.

Requisitos

Requisito	Value
Plataforma de destino	Escritorio
Encabezado	prcomoem.h (include Prcomoem.h)

Consulte también

DrvDevicePropertySheets

DrvDocumentPropertySheets

IPrintOemUI2