Função DrvDocumentPropertySheets (winddiui.h)
A função DrvDocumentPropertySheets de uma interface de impressora é responsável por criar páginas de folha de propriedades que descrevem as propriedades de um documento de impressão.
Sintaxe
LONG DrvDocumentPropertySheets(
[in, optional] PPROPSHEETUI_INFO pPSUIInfo,
LPARAM lParam
);
Parâmetros
[in, optional] pPSUIInfo
Ponteiro fornecido pelo chamador para uma estrutura PROPSHEETUI_INFO. Pode ser NULL (consulte a seção Comentários a seguir).
lParam
Valor inteiro fornecido pelo chamador que depende do conteúdo do Reason membro da estrutura PROPSHEETUI_INFO, conforme listado na tabela a seguir.
| Valor do motivo | Definição de lParam |
|---|---|
| PROPSHEETUI_REASON_INIT | Ponteiro para uma estrutura deDOCUMENTPROPERTYHEADER. |
| Todos os outros valores de motivo | Consulte a descrição do parâmetro lParam para o tipo de função PFNPROPSHEETUI. (O endereço da estruturaDOCUMENTPROPERTYHEADER está contido no membro lParamInit da estrutura PROPSHEETUI_INFO.) |
Valor de retorno
Se pPSUIInfo estiver NULL e se lParam ->fMode for zero ou lParam -> pdmOut estiver NULL, essa função deverá retornar o tamanho, em bytes, da estrutura dedeDEVMODEW da impressora. Caso contrário, o valor retornado da função é o mesmo descrito na seção ReturnValue do tipo de função PFNPROPSHEETUI. Para obter mais informações, consulte a seção Comentários.
Observações
Todas as DLLs da interface da impressora devem fornecer uma função DrvDocumentPropertySheets, que é definida usando o tipo de função PFNPROPSHEETUI. A finalidade da função é chamar a função ComPropSheet, fornecida por CPSUI, para especificar páginas de folha de propriedades contendo propriedades modificáveis pelo usuário para documentos de impressão.
Se o valor recebido para o parâmetro pPSUIInfo não for NULL, o spooler de impressão do sistema operacional baseado em NT chamará a função indiretamente por meio do CPSUI. As seguintes regras se aplicam:
A função deve executar operações conforme descrito para o tipo de função PFNPROPSHEETUI.
Sinalizadores no fMode membro da estrutura DOCUMENTPROPERTYHEADER indicam quais páginas da folha de propriedades exibir e se o usuário deve ter permissão para modificar as propriedades de um documento. Os únicos sinalizadores que podem ser definidos são DM_IN_PROMPT (ou DM_PROMPT), DM_ADVANCED, DM_NOPERMISSION e DM_OUT_BUFFER (ou DM_COPY).
Se o valor recebido para o parâmetro pPSUIInfo for NULL, o spooler de impressão chamará a função diretamente, sem passar por CPSUI. Nesse caso, o parâmetro lParam contém o endereço de uma estrutura DOCUMENTPROPERTYHEADER e as seguintes regras se aplicam:
Se o fMode membro da estruturaDOCUMENTPROPERTYHEADERfor zero, ou se o pdmOut membro da mesma estrutura for NULL, a função deverá retornar apenas o tamanho total da estrutura deDEVMODEWda impressora, incluindo membros da estrutura pública e privada, no membro cbOut da estrutura DOCUMENTPROPERTYHEADER.
Se o membro fMode da estrutura DOCUMENTPROPERTYHEADER não for zero, a função deverá executar as operações indicadas pelos sinalizadores de fMode. Os únicos sinalizadores que podem ser definidos são DM_IN_BUFFER (ou DM_MODIFY) e DM_OUT_BUFFER (ou DM_COPY).
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | winddiui.h (inclua Winddiui.h) |