Classe CPrintDialog

Artigo
06/10/2015

Encapsula os serviços fornecidos pela caixa de diálogo comuns do windows imprimindo.

class CPrintDialog : public CCommonDialog

Membros

Construtores public

Nome	Descrição
CPrintDialog::CPrintDialog	Constrói um objeto de CPrintDialog .

Métodos públicos

Nome	Descrição
CPrintDialog::CreatePrinterDC	Cria um contexto do dispositivo de impressora sem exibir a caixa de diálogo de impressão.
CPrintDialog::DoModal	Exibe a caixa de diálogo e permite que o usuário faça uma seleção.
CPrintDialog::GetCopies	Retorna o número de cópias solicitados.
CPrintDialog::GetDefaults	Recupera opções de dispositivo sem exibir uma caixa de diálogo.
CPrintDialog::GetDeviceName	Recupera o nome de dispositivo de impressão atualmente selecionado.
CPrintDialog::GetDevMode	Recupera a estrutura de DEVMODE .
CPrintDialog::GetDriverName	Recupera o nome do driver de impressão atualmente selecionado.
CPrintDialog::GetFromPage	Recupera a página inicial do intervalo de impressão.
CPrintDialog::GetPortName	Recupera o nome da porta de impressora selecionada.
CPrintDialog::GetPrinterDC	Recupera um identificador para o contexto do dispositivo de impressora.
CPrintDialog::GetToPage	Recupera a página final do intervalo de impressão.
CPrintDialog::PrintAll	Determina se imprimir todas as páginas do documento.
CPrintDialog::PrintCollate	Determina se as cópias agrupada são solicitados.
CPrintDialog::PrintRange	Determina se apenas impressão um intervalo específico de páginas.
CPrintDialog::PrintSelection	Determina se apenas impressão os itens atualmente selecionados.

Membros públicos de dados

Nome	Descrição
CPrintDialog::m_pd	Uma estrutura usada para personalizar um objeto de CPrintDialog .

Comentários

As caixas de diálogo comuns de impressão fornecem uma maneira fácil para implementar um modo das caixas de diálogo de impressão e configuração de impressão consistente com padrões do windows.

Dica

A classe de CPrintDialogEx encapsula os serviços fornecidos pela folha de propriedades de impressão do Windows 2000.Para obter mais informações consulte a visão geral de CPrintDialogEx .

A funcionalidade de CPrintDialog é substituída por que CPageSetupDialogde, que é criado para o fornece com uma caixa de diálogo comuns para a configuração de impressão e a configuração da página.

Você pode confiar na estrutura para manipular muitos aspectos do processo de impressão para seu aplicativo. Em esse caso, a estrutura exibe automaticamente a caixa de diálogo comuns do windows para imprimir. Você pode também ter a impressão de identificador de estrutura para seu aplicativo mas substitua a caixa de diálogo comuns de impressão com sua própria caixa de diálogo de impressão. Para obter mais informações sobre como usar a estrutura para gerenciar tarefas de impressão, consulte o artigo Imprimindo.

Se você quiser que seu aplicativo manipule a impressão sem participação de estrutura, você pode usar a classe de CPrintDialog como “é” com o construtor fornecido, ou você pode derivar sua própria classe da caixa de diálogo de CPrintDialog e escrever um construtor para atender às suas necessidades. Em ambos os casos, essas caixas de diálogo se comportar como caixas de diálogo padrão MFC porque eles são derivadas da classe CCommonDialog.

Para usar um objeto de CPrintDialog , primeiro crie o objeto usando o construtor de CPrintDialog . Uma vez que a caixa de diálogo foi construída, você pode definir ou modificar os valores na estrutura de m_pd para inicializar valores dos controles da caixa de diálogo. A estrutura de m_pd é do tipo PRINTDLG. Para obter mais informações sobre essa estrutura, consulte Windows SDK.

Se você não fornecer suas próprias identificadores em m_pd para os membros de hDevMode e de hDevNames , certifique-se chamar a função do windows GlobalFree para essas alças quando você concluiu a caixa de diálogo. A o usar a implementação de configuração de impressão de estrutura fornecida por CWinApp::OnFilePrintSetup, você não precisará liberar essas identificadores. Identificadores são mantidas por CWinApp e liberadas no destrutor de CWinApp. Só é necessário liberar essas manipula ao usar CPrintDialog autônomo.

Após inicializado os controles de caixa de diálogo, chame a função de membro de DoModal para exibir a caixa de diálogo e para permitir que o usuário selecione opções de impressão. DoModal retorna se o usuário tiver selecionado OK (IDOK) ou o botão cancelar (IDCANCEL).

Se DoModal retorna IDOK, você pode usar uma das funções de membro de CPrintDialog para recuperar informações de entrada pelo usuário.

A função de membro de CPrintDialog::GetDefaults é útil para recuperar as opções de impressão atual sem exibir uma caixa de diálogo. Essa função de membro não requer qualquer interação do usuário.

Você pode usar a função de CommDlgExtendedError do windows para determinar se um erro ocorrer durante a inicialização da caixa de diálogo e para aprender mais sobre o erro. Para obter mais informações sobre essa função, consulte Windows SDK.

CPrintDialog depende do arquivo de COMMDLG.DLL que vem com versões 3,1 e posterior do windows.

Para personalizar a caixa de diálogo, derive uma classe de CPrintDialog, forneça um modelo personalizado da caixa de diálogo, e adicionar um mapa de mensagens para processar as notificações dos controles estendidos. Todas as mensagens não processadas devem ser passados adiante para a classe base. Personalizar a função de gancho não é necessário.

Para processar a mesma mensagem de maneira diferente dependendo se a caixa de diálogo é impressão ou configuração de impressão, você deve derivar uma classe para cada caixa de diálogo. Você também deve substituir a função de AttachOnSetup do windows, que trata a criação de uma nova caixa de diálogo quando o botão de configuração de impressão é selecionado na caixa de diálogo de impressão.

Para obter mais informações sobre como usar CPrintDialog, consulte Classes comuns da caixa de diálogo.