[共通] ダイアログ ボックスの種類

共通ダイアログ ボックス ライブラリには、共通ダイアログ ボックスの種類ごとに作成関数と構造が用意されています。 共通ダイアログ ボックスを最も単純な形式で使用するには、その作成関数を呼び出し、初期値とオプション フラグを含む構造体へのポインターを指定します。 ダイアログ ボックスを初期化した後、ダイアログ ボックス プロシージャは 構造体を使用してユーザー入力に関する情報を返します。 アプリケーションのニーズに合わせて共通のダイアログ ボックスをカスタマイズすることもできます。

次の表では、さまざまな種類の一般的なダイアログ ボックスについて簡単に説明し、各型で使用される関数と構造を示します。

ダイアログ ボックス	説明
色	使用可能な色を表示し、必要に応じてユーザーがカスタム 色を作成できるようにします。 ユーザーは、基本色またはカスタム色を選択できます。 ChooseColor 関数と CHOOSECOLOR 構造体を使用します。 詳細については、「 [色] ダイアログ ボックス」を参照してください。
Find	検索する文字列を入力できるダイアログ ボックスを表示します。 ユーザーは、検索の方向や検索で大文字と小文字が区別されるかどうかなど、検索オプションを指定することもできます。 FindText 関数と FINDREPLACE 構造体を使用します。 詳細については、「 ダイアログ ボックスの検索と置換」を参照してください。
フォント	ユーザーがフォント ファミリと関連するフォント スタイル、ポイント サイズ、およびフォントの色、下線、取り消し線などのその他のフォント属性を選択できるダイアログ ボックスを表示します。 ChooseFont 関数と CHOOSEFONT 構造体を使用します。 詳細については、「 [フォント] ダイアログ ボックス」を参照してください。
[ファイル]	ユーザーが開くファイルまたはシェルの名前空間オブジェクトの名前を入力または選択できるダイアログ ボックスを表示します。 ダイアログ ボックスには、ユーザーがシェルのネーム スペースを参照できるようにするドライブ、ディレクトリ、およびシェルのネームスペース拡張機能の一覧が含まれています。 また、表示されるファイル名をユーザーがフィルター処理できるようにするファイル名拡張子の一覧も含まれています。 GetOpenFileName 関数と OPENFILENAME 構造体を使用します。 詳細については、「 ダイアログ ボックスを開いて保存する」を参照してください。
ページ設定	現在のページ構成を表示します。 ユーザーは、用紙の向き、サイズ、ソース、余白などのページ構成オプションを選択できます。 PageSetupDlg 関数と PAGESETUPDLG 構造体を使用します。 詳細については、「 [ページ設定] ダイアログ ボックス」を参照してください。
印刷	インストールされているプリンターとその構成に関する情報を表示します。 ユーザーは、印刷するページの範囲や部数などの印刷ジョブ オプションを選択し、印刷プロセスを開始できます。 PrintDlg 関数と PRINTDLG 構造体を使用します。 詳細については、「 [印刷] ダイアログ ボックス」を参照してください。 [印刷] ダイアログ ボックスではなく Print プロパティ シートを表示するには、PRINTDLGEX 構造体と共に PrintDlgEx 関数を使用します。 プロパティ シートの [ 全般 ] ページは、[ 印刷 ] ダイアログ ボックスに似ています。 プロパティ シートには、[ 全般] ページの後に、追加のアプリケーション固有およびドライバー固有のプロパティ ページを含めることができます。 詳細については、「 Print Property Sheet」を参照してください。
Replace	検索する文字列と置換文字列を入力できるダイアログ ボックスを表示します。 ユーザーは、検索で大文字と小文字が区別されるかどうかなどの検索オプションと、置換のスコープなどの置換オプションを指定できます。 ReplaceText 関数と FINDREPLACE 構造体を使用します。 詳細については、「 ダイアログ ボックスの検索と置換」を参照してください。
[名前を付けて保存]	ユーザーがファイルまたはシェルの名前空間オブジェクトを保存する名前を入力または選択できるダイアログ ボックスを表示します。 ダイアログ ボックスには、ユーザーがシェルのネーム スペースを参照できるようにするドライブ、ディレクトリ、およびシェルのネームスペース拡張機能の一覧が含まれています。 また、表示されるファイル名をユーザーがフィルター処理できるようにするファイル名拡張子の一覧も含まれています。 GetSaveFileName 関数と OPENFILENAME 構造体を使用します。 詳細については、「 ダイアログ ボックスを開いて保存する」を参照してください。

[印刷設定] ダイアログ ボックスは使用できますが、[ページ設定] ダイアログ ボックスに置き換わりました。 アプリケーションでは、[ 印刷設定 ] ダイアログ ボックスではなく [ページ 設定 ] ダイアログ ボックスを使用する必要があります。

[ 検索 ] ダイアログ ボックスと [ 置換 ] ダイアログ ボックスを除き、すべての一般的なダイアログ ボックスはモーダルです。 ダイアログ ボックスの作成に使用する関数が戻る前に、モーダル ダイアログ ボックスを閉じる必要があります。 [ 検索 と 置換 ] ダイアログ ボックスはモードレスです。関数は、ダイアログ ボックスが閉じる前に を返します。 [検索と置換] ダイアログ ボックスを使用する場合は、アプリケーションの メイン メッセージ ループで IsDialogMessage 関数を使用して、TAB キーや ESC キーなどのキーボード入力がこれらのダイアログ ボックスで正しく処理されるようにする必要もあります。