[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);
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. |
Para obter mais informações, consulte a Folha de propriedades de impressão.
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.
Visão geral de biblioteca de caixa de diálogo comum, funções de caixa de diálogo comuns, CreatePropertySheetPage, PrintDlg, PRINTDLGEX