CPrintDialog::CPrintDialog

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

Windows の [印刷] ダイアログオブジェクトまたは [プリンタの設定] ダイアログオブジェクトのいずれかを構築します。

CPrintDialog(
   BOOL bPrintSetupOnly,
   DWORD dwFlags = PD_ALLPAGES | PD_USEDEVMODECOPIES | PD_NOPAGENUMS | PD_HIDEPRINTTOFILE | PD_NOSELECTION,
   CWnd* pParentWnd = NULL 
);

パラメータ

bPrintSetupOnly
Windows 標準の [印刷] ダイアログボックスまたは [プリンタの設定] ダイアログボックスのどちらを表示するかを指定します。このパラメータを TRUE に設定すると、Windows 標準の [プリンタの設定] ダイアログボックスを表示します。このパラメータを FALSE に設定すると、Windows の [印刷] ダイアログボックスを表示します。bPrintSetupOnly が FALSE のときは、[プリンタの設定] オプションボタンが [印刷] ダイアログボックスに表示されます。
dwFlags
ダイアログボックスの設定をカスタマイズするための 1 つ以上のフラグを、ビットごとの OR 演算子で組み合わせて指定できます。たとえば、PD_ALLPAGES フラグは、既定の印刷範囲として文書の全ページを印刷するように設定されています。これらのフラグの詳細については、Windows SDK の PRINTDLG 構造体の説明を参照してください。
pParentWnd
ダイアログボックスの親ウィンドウまたはオーナーウィンドウへのポインタ。

解説

このメンバ関数はオブジェクトを構築するだけです。ダイアログボックスを表示するためには DoModal メンバ関数を使います。

bPrintSetupOnly に FALSE を指定してコンストラクタを呼び出すと、PD_RETURNDC フラグが自動的に使われることに注意してください。DoModal、GetDefaults、GetPrinterDC の呼び出しの後に、m_pd.hDC にプリンタ DC が返されます。この DC は、CPrintDialog の呼び出し元が DeleteDC を呼び出すことで解放する必要があります。

使用例

// Display the Windows Print dialog box with "All" radio button 
// initially selected. All other radio buttons are disabled.
CPrintDialog dlg1(FALSE);

// Display the Windows Print dialog box with Collate check box checked.  
CPrintDialog dlg2(FALSE, PD_ALLPAGES | PD_COLLATE | PD_NOPAGENUMS | PD_HIDEPRINTTOFILE);

// Display the Windows Print dialog box with "Selection" radio
// button initially selected. "All" radio button is enabled
// but "Pages" radio button is disabled.
CPrintDialog dlg3(FALSE, PD_SELECTION | PD_USEDEVMODECOPIES);