Método IPrintOemUI::D evicePropertySheets (prcomoem.h)
O método IPrintOemUI::DevicePropertySheets permite que um plug-in de interface do usuário acrescente uma nova página à folha de propriedades da impressora de um dispositivo de impressora.
Sintaxe
HRESULT DevicePropertySheets(
PPROPSHEETUI_INFO pPSUIInfo,
LPARAM lParam
);
Parâmetros
pPSUIInfo
Ponteiro fornecido pelo chamador para uma estrutura PROPSHEETUI_INFO.
lParam
Valor fornecido pelo chamador que depende do valor do motivo em pPSUIInfo -->Reason. O valor do motivo pode ser uma das seguintes constantes, que são definidas em compstui.h. Para obter mais informações sobre essas constantes, consulte a seção Comentários e descrição do parâmetro lParam no tipo de função PFNPROPSHEETUI.
PROPSHEETUI_REASON_DESTROY
PROPSHEETUI_REASON_GET_ICON
PROPSHEETUI_REASON_GET_INFO_HEADER
PROPSHEETUI_REASON_INIT
PROPSHEETUI_REASON_SET_RESULT
Valor de retorno
O valor retornado depende do conteúdo do membro Reason da estrutura de PROPSHEETUI_INFO. Para obter mais informações, consulte a descrição de DrvDevicePropertySheets.
Observações
O método IPrintOemUI::DevicePropertySheets de um plug-in de interface do usuário executa os mesmos tipos de operações que a função DrvDevicePropertySheets exportada por DLLs da interface da impressora no modo de usuário. Ambas as funções têm os mesmos parâmetros de entrada.
Se você fornecer um plug-in de interface do usuário, o método IPrintOemUI::DevicePropertySheets será chamado após a função DrvDevicePropertySheets do driver ser chamada.
Quando IPrintOemUI::DevicePropertySheets é chamado, o lParamInit membro da estrutura PROPSHEETUI_INFO contém o endereço de uma estrutura de OEMUIPSPARAM.
Se você implementar esse método, normalmente você também fornecerá uma função de retorno de chamada com tipo _CPSUICALLBACKpara lidar com as modificações do usuário. Essa função de retorno de chamada deve chamar IPrintOemDriverUI::D rvUpdateUISetting para informar o driver quando o valor associado a uma configuração de interface do usuário foi modificado, se o valor for armazenado na estrutura de de DEVMODEW do driver (em vez dos membros de DEVMODEW privados do plug-in) ou nas chaves do registro.
Se IPrintOemUI::DevicePropertySheets métodos forem exportados por vários plug-ins de interface do usuário, os métodos serão chamados na ordem em que os plug-ins são especificados para instalação.
Se um plug-in de interface do usuário der suporte a vários modelos de impressora e se você quiser que a nova página seja exibida apenas para alguns desses modelos, o método IPrintOemUI::DevicePropertySheets deverá fornecer apenas um valor de retorno de êxito, sem realmente adicionar a página, para os modelos que não exigem a página.
Para obter mais informações sobre como criar e instalar plug-ins de interface do usuário, consulte Personalizando os drivers de impressora da Microsoft.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | prcomoem.h (inclua Prcomoem.h) |