Método IPrintOemUI::D ocumentPropertySheets (prcomoem.h)

Artigo
02/26/2024

O IPrintOemUI::DocumentPropertySheets método 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 a 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

Retornar valor

O valor retornado depende do conteúdo do membro Reason da estrutura PROPSHEETUI_INFO. Para obter mais informações, consulte a descrição de DrvDocumentPropertySheets.

Comentários

O método de um plug-in de interface do IPrintOemUI::DocumentPropertySheets usuário executa os mesmos tipos de operações que a função DrvDocumentPropertySheets exportada por DLLs de 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 IPrintOemUI::DocumentPropertySheets método será chamado depois que a função DrvDocumentPropertySheets do driver for chamada.

Quando IPrintOemUI::DocumentPropertySheets é chamado, o membro lParamInit da estrutura PROPSHEETUI_INFO contém o endereço de uma estrutura OEMUIPSPARAM .

Se você implementar esse método, normalmente também fornecerá uma função de retorno de chamada do tipo _CPSUICALLBACK para 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 DEVMODEW do driver (em vez dos membros DEVMODEW privados do plug-in ) ou em chaves do Registro.

Se IPrintOemUI::DocumentPropertySheets os 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 apenas que a nova página seja exibida para alguns desses modelos, o IPrintOemUI::DocumentPropertySheets método 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 drivers de impressora da Microsoft.