PrintDlg (function)
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/9/2008
Essa função exibe um Imprimir Ou Configuração de impressão caixa diálogo. O Imprimir caixa diálogo permite que o usuário para especificar as propriedades de um determinado trabalho de impressão.
Windows CE 2.10 e posterior, essa função foi substituída pelo PageSetupDlg (função).
Syntax
BOOL PrintDlg(
LPPRINTDLG lppd
);
Parameters
- lppd
Ponteiro longo para um PRINTDLG (estrutura) que contém informações usadas para inicializar a caixa diálogo. Quando PrintDlg Retorna, essa estrutura contém informações sobre as seleções do usuário.
Return Value
Se o usuário clica a OK botão, o valor de retorno é diferente de zero. Os membros a PRINTDLG estrutura apontado pelo lppd parâmetro indicar as seleções do usuário.
Se o usuário cancelada ou fechada a Imprimir Ou A instalação da impressora caixa diálogo ou um erro ocorreu, 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 diálogo, CommDlgExtendedError Retorna zero; caso contrário, ele retorna um dos seguinte 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 |
Remarks
Se o procedimento gancho (apontado pelo lpfnPrintHook membro das PRINTDLG estrutura) processa a mensagem WM_CTLCOLORDLG, procedimento de gancho deve retornar um identificador para o pincel que deve ser usado para tinta segundo plano o controle.
Chamando PrintDlg Com dwFlags Igual a PD_RETURNDEFAULTDC faz com que a função para usar as configurações Last-Saved ou as configurações usar como padrão. Essa pode causar PrintDlg Falha se as configurações não forem válido. Você deve usar o manual PrintDlg — Isto é, sem a PD_RETURNDEFAULTDC — para escolher um válido da impressora, porta ou outro destino para garantir que você pode imprimir para ele.
Quando você terminar com a contexto para dispositivo (DC) retornado por PrintDlg, chamar o DeleteDC função para excluí-lo.
Requirements
| Header | commdlg.h |
| Library | commdlg.lib |
| Windows Embedded CE | Windows CE 2.0 and later |
See Also
Reference
CommDlgExtendedError
CreateDC
DeleteDC
PrintHookProc
StartDoc
PageSetupDlg (function)
WM_CTLCOLORDLG
PAGESETUPDLG (structure)
PRINTDLG (structure)