PrintDlg

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);
 

Parâmetros

lppd
Ponteiro para uma estrutura PRINTDLG contém informações usadas para inicializar a caixa de diálogo. Quando PrintDlg retorna, essa estrutura contém informações sobre seleções do usuário.

Retornar valores

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

Observações

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.

QuickInfo

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.

Ver também

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

Index