Método IPrintOemUI::D ocumentPropertySheets (prcomoem.h)
O método IPrintOemUI::DocumentPropertySheets permite que um plug-in de interface do usuário acrescente uma nova página à folha de propriedades do documento de um dispositivo de impressora.
Sintaxe
HRESULT DocumentPropertySheets(
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 de motivo da estrutura de PROPSHEETUI_INFO. Para obter mais informações, consulte a descrição de DrvDocumentPropertySheets.
Observações
O método IPrintOemUI::DocumentPropertySheets de um plug-in de interface do usuário executa os mesmos tipos de operações que a função DrvDocumentPropertySheets 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::DocumentPropertySheets será chamado depois que a função DrvDocumentPropertySheets do driver for chamada.
Quando IPrintOemUI::DocumentPropertySheets é 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 tiver sido modificado, se o valor for armazenado na estrutura de DEVMODEW do do driver (em vez dos membros de DEVMODEW privados do plug-in) ou em chaves do registro.
Se IPrintOemUI::DocumentPropertySheets 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::DocumentPropertySheets 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, Compstui.h) |