CPrintDialog::DoModal
更新 : 2007 年 11 月
この関数を呼び出すと、Windows の [印刷] コモン ダイアログ ボックスが表示され、印刷部数、ページ範囲、部単位で印刷するかどうかなどのさまざまな印刷オプションを選択できるようになります。
virtual INT_PTR DoModal( );
戻り値
IDOK または IDCANCEL を返します。IDCANCEL が返された場合は、エラーが発生したかどうかを Windows の CommDlgExtendedError 関数で調べることができます。
IDOK は [OK]、IDCANCEL は [キャンセル] がクリックされたことを示す定数です。
解説
m_pd 構造体のメンバを設定することで [印刷] ダイアログのさまざまなオプションを初期化する場合、この初期化は、ダイアログ オブジェクトを構築してから DoModal 関数を呼び出すまでの間に行います。
DoModal 関数呼び出し後は、ほかのメンバ関数を呼び出してダイアログ ボックスに指定した設定や入力情報を取得できます。
bPrintSetupOnly に FALSE を指定してコンストラクタを呼び出すと、PD_RETURNDC フラグが自動的に使われることに注意してください。DoModal、GetDefaults、GetPrinterDC の呼び出しの後に、m_pd.hDC にプリンタ DC が返されます。この DC は、CPrintDialog の呼び出し元が DeleteDC を呼び出すことで解放する必要があります。
使用例
「CPrintDialog::CreatePrinterDC」の例を参照してください。
必要条件
ヘッダー : afxdlgs.h