O PrintDlg função exibe uma caixa de diálogo Imprimir ou uma caixa de diálogoConfigurar impressão. A caixa de diálogo Imprimir permite que o usuário especificar as propriedades de um determinado trabalho de impressão .
A caixa de diálogo Imprimir não deve ser usada em novas aplicações. Ele foi substituído por uma páginacomum caixa de diálogoConfigurar criada pelo PageSetupDlg função .
(BOOL PrintDlg LPPRINTDLG lppd / / ponteiro para estrutura com dados de inicialização);
Se o usuário clicar no botão OK , o valor de retorno é diferente de zero. Os membros da estrutura PRINTDLG apontada pelo parâmetro lppd indicar as seleções do usuário.
Se o usuário cancelada ou fechada a caixa de diálogo Imprimir ou Configuração da impressora ou ocorreu um erro, o valor de retorno é zero. Para informações de erro estendidas get, use o CommDlgExtendedError função. Se o usuário cancelada ou fechada a caixa de diálogo, CommDlgExtendedError retorna zero; caso contrário, ele retorna um dos seguintes valores:
| CDERR_FINDRESFAILURE | PDERR_CREATEICFAILURE |
| CDERR_INITIALIZATION | PDERR_DEFAULTDIFFERENT |
| CDERR_LOADRESFAILURE | PDERR_DNDMMISMATCH |
| CDERR_LOADSTRFAILURE | PDERR_GETDEVMODEFAIL |
| CDERR_LOCKRESFAILURE | PDERR_INITFAILURE |
| CDERR_MEMALLOCFAILURE | PDERR_LOADDRVFAILURE |
| CDERR_MEMLOCKFAILURE | PDERR_NODEFAULTPRN |
| CDERR_NOHINSTANCE | PDERR_NODEVICES |
| CDERR_NOHOOK | PDERR_PARSEFAILURE |
| CDERR_NOTEMPLATE | PDERR_PRINTERNOTFOUND |
| CDERR_STRUCTSIZE | PDERR_RETDEFFAILURE |
Se o procedimento de gancho (apontado pelo lpfnPrintHook ou lpfnSetupHook membro da estrutura PRINTDLG ) processa a WM_CTLCOLORDLG mensagem, o procedimento de gancho deve retornar um identificador para o pincel que deve ser usado para pintar o plano de fundo do Controlarar.
Windows NT 5.0 e posterior: Você pode usar a função PrintDlgEx para exibir uma folha de propriedades de impressão, que tem uma página Geral contendo controles similares para a Imprimir caixa de diálogo comum.
Windows CE: A estrutura PRINTDLG contém membros diferentes no Windows CE do que em plataformas de desktop de Windows.
nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Requer a versão 2.0 ou posterior.
Cabeçalho:Declaradas no commdlg.h.
Biblioteca de importação:Use comdlg32.lib.
Unicode:Implementado como versões Unicode e ANSI no Windows NT.
Visão geral de biblioteca de caixa de diálogo comum, funções de caixa de diálogo comum, CommDlgExtendedError, CreateDC, DOCINFO, PRINTDLG, PrintHookProc, SetupHookProc, StartDoc, WM_CTLCOLORDLG