Classe CPrintDialogEx

Artigo
06/10/2015

Encapsula os serviços fornecidos pela folha de propriedades de impressão do Windows 2000.

class CPrintDialogEx : public CCommonDialog

Membros

Construtores public

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

Métodos públicos

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

Membros públicos de dados

Nome	Descrição
CPrintDialogEx::m_pdex	Uma estrutura usada para personalizar um objeto de CPrintDialogEx .

Comentários

Você pode confiar na estrutura para manipular muitos aspectos do processo de impressão para seu aplicativo. 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 CPrintDialogEx como “é” com o construtor fornecido, ou você pode derivar sua própria classe da caixa de diálogo de CPrintDialogEx 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 CPrintDialogEx , primeiro crie o objeto usando o construtor de CPrintDialogEx . Uma vez que a caixa de diálogo foi construída, você pode definir ou modificar os valores na estrutura de m_pdex para inicializar valores dos controles da caixa de diálogo. A estrutura de m_pdex é do tipo PRINTDLGEX. Para obter mais informações sobre essa estrutura, consulte Windows SDK.

Se você não fornecer suas próprias identificadores em m_pdex 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.

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. Quando DoModal retorna, você pode determinar se o usuário tiver selecionado, aplica, OK ou cancelar o botão.

Se o usuário pressionou OK, você pode usar as funções de membro de CPrintDialogEx para recuperar informações de entrada pelo usuário.

A função de membro de CPrintDialogEx::GetDefaults é útil para recuperar as opções de impressão atual sem exibir uma caixa de diálogo. Este método 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.

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