Classe CPrintDialog
Encapsula os serviços fornecidos pela caixa de diálogo comuns do Windows para impressão.
class CPrintDialog : public CCommonDialog
Comentários
Caixas de diálogo de impressão comuns fornecem uma maneira fácil de implementar caixas de diálogo Imprimir e configurar impressão de maneira consistente com os padrões do Windows.
.gif "Observação") Observação: |
|---|
O CPrintDialogEx classe encapsula os serviços fornecidos pela folha de propriedades de impressão do Windows 2000. Para obter mais informações, consulte o CPrintDialogEx visão geral. |
CPrintDialogda funcionalidade é substituída do CPageSetupDialog, projetada para fornecer a você uma caixa de diálogo comum para ambos o programa de instalação e configuração de página de impressão.
Você pode contar com a estrutura para lidar com muitos aspectos do processo de impressão para o aplicativo.Nesse caso, a estrutura exibe automaticamente a caixa de diálogo comuns do Windows para impressão.Você também pode ter o identificador de estrutura para seu aplicativo de impressão mas substituir a caixa de diálogo Imprimir comuns com sua própria caixa de diálogo de impressão.Para obter mais informações sobre como usar a estrutura para lidar com tarefas de impressão, consulte o artigo Impressão.
Se você quiser que seu aplicativo para manipular a impressão sem o envolvimento da estrutura, você pode usar o CPrintDialogclasse "sistema autônomo estão" com o construtor fornecido ou você pode derivar sua própria classe de caixa de diálogo de CPrintDialog e escrever um construtor para atender às suas necessidades. Em ambos os casos, essas caixas de diálogo comportará como padrão uma caixa de diálogo MFC porque elas derivam da classe CCommonDialog.
Para usar um CPrintDialog objeto, primeiro crie o objeto usando o CPrintDialog construtor. Depois que a caixa de diálogo tenha sido construída, você pode conjunto ou modificar quaisquer valores no m_pd estrutura ao inicializar os valores dos controles da caixa de diálogo.The m_pd estrutura é do tipo PRINTDLG.Para obter mais informações nessa estrutura, consulte o Windows SDK.
Se você não fornecer seus próprios identificadores de m_pd para o hDevMode and hDevNames membros, certifique-se telefonar os Windows funcionar GlobalFree essas alças quando tiver terminado com a caixa de diálogo.Ao usar a implementação de configuração da impressão da estrutura fornecida por CWinApp::OnFilePrintSetup, você não tem disponível essas alças. As alças são mantidas por CWinApp e liberados na CWinAppdo destruidor. Só é necessário liberar essas alças ao usar CPrintDialog autônomo.
Após inicializar os controles da caixa de diálogo, chame o DoModal função de membro para exibir a caixa de diálogo e permitir que o usuário selecionar opções de impressão. DoModal Retorna se o usuário selecionado (OKIDOK) ou em Cancelar (IDCANCEL) botão.
If DoModal Retorna IDOK, você pode usar um dos CPrintDialog's funções de membro para recuperar as informações de entrada pelo usuário.
The CPrintDialog::GetDefaults função de membro é útil para recuperar os padrões da impressora corrente sem exibir uma caixa de diálogo. Esta função de membro não requer interação do usuário.
Você pode usar o Windows CommDlgExtendedError função para determinar se ocorreu um erro durante a inicialização da caixa de diálogo e para obter mais informações sobre o erro.Para obter mais informações sobre esta função, consulte o Windows SDK.
CPrintDialog conta com o arquivo Commdlg.dll que acompanha o Windows versões 3.1 e posteriores.
Para personalizar a caixa de diálogo, derivar uma classe de CPrintDialog, fornecer um modelo de diálogo personalizada e adicione um MAP da mensagem a processo mensagens de notificação de controles estendidas. Todas as mensagens não processadas devem ser passadas para a classe base.Personalizando a função de gancho não é necessária.
Para processar a mesma mensagem de forma diferente de acordo com a caixa de diálogo Imprimir ou Configurar impressão, você deve derivar uma classe para cada caixa de diálogo.Você também deverá substituir o Windows AttachOnSetup função, que manipula a criação de uma nova caixa de diálogo quando o botão Configurar impressão é selecionado em uma caixa de diálogo Imprimir.
Para obter mais informações sobre como usar CPrintDialog, consulte Classes de caixa de diálogo comum.
Requisitos
Cabeçalho: afxdlgs.h
Consulte também
Tarefas
Exemplo DIBLOOK: Ilustra o uso de DIBs e Palettes de cor