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

  • Artigo

O IPrintOemUI2::HideStandardUI método permite que um plug-in de interface do usuário especifique se as folhas de propriedades padrão devem ser exibidas ou ocultadas. A partir do Microsoft Windows XP, esse método pode ser implementado por um plug-in de interface do usuário Pscript5. A partir do Windows Vista, esse método pode ser implementado por um plug-in de interface do usuário Unidrv.

Sintaxe

HRESULT HideStandardUI(
  DWORD dwMode
);

Parâmetros

dwMode

Especifica qual tipo de interface do usuário da folha de propriedades – folha de propriedades do documento ou folha de propriedades do dispositivo – a ser ocultada. Esse parâmetro deve ser definido como uma das seguintes constantes, que são definidas em printoem.h:

Valor Significado
OEMCUIP_DOCPROP Ocultar a interface do usuário da folha de propriedades do documento padrão.
OEMCUIP_PRNPROP Ocultar a interface do usuário da folha de propriedades do dispositivo padrão.

Retornar valor

Em caso de êxito, esse método deve retornar S_OK. Caso contrário, ele deverá retornar E_NOTIMPL. Consulte Comentários para obter informações adicionais.

Comentários

Esse método tem suporte no Windows Vista para plug-ins Pscript 5 e Unidrv e no Windows XP somente para plug-ins Pscript5.

Dentro dos DDIs DrvDocumentPropertySheets ou DrvDevicePropertySheets quando pPSUIInfo--> Reason é definido como PROPSHEETUI_REASON_INIT, o driver chama o IPrintOemUI2::HideStandardUI método para perguntar ao plug-in da interface do usuário sobre solicitações de interface do usuário. Esse método pode responder de qualquer uma das quatro maneiras:

  1. Ocultar a interface do usuário da folha de propriedades do documento padrão.
  2. Ocultar a interface do usuário da folha de propriedades do dispositivo padrão.
  3. Ocultar toda a interface do usuário da folha de propriedades padrão.
  4. Não oculte nenhuma interface do usuário da folha de propriedades padrão.
A tabela a seguir resume como o IPrintOemUI2::HideStandardUI método responderia em cada uma dessas situações.
Para indicar essa resposta... IPrintOemUI2::HideStandardUI retorna...
Ocultar a interface do usuário da folha de propriedades do documento padrão. O plug-in implementa sua própria interface do usuário da folha de propriedades do documento. Se dwMode == OEMCUIP_DOCPROP, retorne S_OK; caso contrário, retorne E_NOTIMPL.
Ocultar a interface do usuário da folha de propriedades do dispositivo padrão. O plug-in implementa sua própria interface do usuário da folha de propriedades do dispositivo. Se dwMode == OEMCUIP_PRNPROP, retorne S_OK; caso contrário, retorne E_NOTIMPL.
Ocultar toda a interface do usuário da folha de propriedades padrão. O plug-in implementa sua própria folha de propriedades do documento e a interface do usuário da folha de propriedades do dispositivo. Retornar S_OK, independentemente do valor de dwMode.
Exibir toda a interface do usuário da folha de propriedades padrão. Retornar E_NOTIMPL, independentemente do valor de dwMode.
 

Se o IPrintOemUI2::HideStandardUI método indicar ao driver que todas as folhas de propriedades padrão devem estar ocultas, o driver omite chamadas para compstui.dll (consulte Componentes Pscript) para adicionar as folhas de propriedades padrão. Um plug-in de interface do usuário deve implementar pelo menos uma interface do usuário de folha de propriedades personalizada se IPrintOemUI2::HideStandardUI retornar S_OK.

Quando a impressora tem vários plug-ins de interface do usuário instalados, o driver chama plug-ins de interface do usuário na ordem em que foram instalados, até que um deles retorne S_OK ou até que todos os plug-ins de interface do usuário tenham sido chamados e nenhum deles tenha retornado S_OK. O caso anterior indica ao driver que a interface do usuário da folha de propriedades padrão deve estar oculta. O último caso indica ao driver que a interface do usuário da folha de propriedades padrão deve ser exibida.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho prcomoem.h (inclua Prcomoem.h)

Confira também

DrvDevicePropertySheets

DrvDocumentPropertySheets

IPrintOemUI2