Compartilhar via


CPrintDialog::DoModal

Exibe a caixa de diálogo comuns de impressão do windows e permite que o usuário selecione várias opções de impressão como o número de intervalo, cópias de página, e se as cópias devem ser classificadas.

virtual INT_PTR DoModal( );

Valor de retorno

IDOK ou IDCANCEL.Se IDCANCEL é retornado, chame a função de CommDlgExtendedError do windows para determinar se um erro ocorrer.

IDOK e IDCANCEL são constantes que indica se o usuário tiver selecionado o botão OK ou cancelar.

Comentários

Se você deseja inicializar as várias opções de diálogo de impressão definindo membros de estrutura de m_pd , você deve fazê-lo antes de chamar DoModal, mas após o objeto da caixa de diálogo é construído.

Após chamar DoModal, você pode chamar outras funções de membro para recuperar as configurações ou a entrada de informações pelo usuário na caixa de diálogo.

Observe que quando você chamar o construtor com bPrintSetupOnly definido como Falso, o sinalizador de PD_RETURNDC é usado automaticamente.Após chamar DoModal, GetDefaults, ou GetPrinterDC, uma C.C. de impressão será retornada em m_pd.hDC.Esta C.C. deve ser liberada com uma chamada a DeleteDC pelo chamador de CPrintDialog.

Exemplo

Consulte o exemplo para CPrintDialog::CreatePrinterDC.

Requisitos

Cabeçalho: afxdlgs.h

Consulte também

Referência

Classe de CPrintDialog

Gráfico de hierarquia

CPrintDialog::CPrintDialog

CDialog::DoModal