PrintDlgEx

[Esta é a documentação preliminar e estão sujeitos a alterações.]

A função PrintDlgEx exibe um folha de propriedades de impressão que permite ao usuário especificar as propriedades de um determinado trabalho de impressão. Um folha de propriedades de impressão tem uma página Geral contendo controles similares para a Imprimir caixa de diálogo comum. A folha também pode ter páginas de propriedades adicionais específicas do aplicativo e específicos de driver após a página Geral.

(HRESULT PrintDlgEx LPPRINTDLGEX  lppd / / ponteiro para estrutura com dados de inicialização);
 

Parâmetros

lppd
Ponteiro para uma estrutura PRINTDLGEX que contém informações usadas para inicializar a folha de propriedades. Quando PrintDlgEx retorna, essa estrutura contém informações sobre seleções do usuário.

Retornar valores

Se a função for bem-sucedido, o valor de retorno é S_OK e o dwResultAction membro da estrutura PRINTDLGEX contém um dos seguintes valores.

Valor Significado
PD_RESULT_APPLY O usuário clicou no botão aplicar e depois clicou no botão Cancelar . Isso indica que o usuário quer aplicar as alterações feitas na folha de propriedades, mas não ainda quer imprimir. A estrutura PRINTDLGEX contém as informações especificadas pelo usuário no momento foi clicado no botão aplicar.
PD_RESULT_CANCEL O usuário clicou no botão Cancelar . As informações na estrutura PRINTDLGEX permanece inalteradas.
PD_RESULT_PRINT O usuário clicou no botão Imprimir . A estrutura PRINTDLGEX contém as informações especificadas pelo usuário.

Se a função falhar, o valor de retorno pode ser uma do seguintes códigos de erro COM. Para obter mais informações, consulte A manipulação de erro.

Valor Significado
E_OUTOFMEMORY Memória insuficiente.
E_INVALIDARG Um ou mais argumentos são inválidos.
E_POINTER Ponteiro inválido.
E_HANDLE Identificador inválido.
E_FAIL Erro não especificado.

Observações

Para obter mais informações, consulte a Folha de propriedades de impressão.

QuickInfo

nbsp; Windows &NT: requer versão 5.0 ou posterior.
Windows:Sem suporte.
Windows CE:Sem suporte.
Cabeçalho:Declaradas no commdlg.h.
Biblioteca de importação:Use comdlg32.lib.
Unicode:Implementado como versões Unicode e ANSI no Windows NT.

Ver também

Visão geral de biblioteca de caixa de diálogo comum, funções de caixa de diálogo comuns, CreatePropertySheetPage, PrintDlg, PRINTDLGEX

Index