Método IPrintOemUI2::HideStandardUI (prcomoem.h)
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:
- Ocultar a interface do usuário da folha de propriedades do documento padrão.
- Ocultar a interface do usuário da folha de propriedades do dispositivo padrão.
- Ocultar toda a interface do usuário da folha de propriedades padrão.
- Não oculte nenhuma interface do usuário da folha de propriedades padrã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) |