[共通] ダイアログ ボックスの種類
共通ダイアログ ボックス ライブラリには、共通ダイアログ ボックスの種類ごとに作成関数と構造が用意されています。 最も単純な形式で共通のダイアログ ボックスを使用するには、その作成関数を呼び出し、初期値とオプション フラグを含む構造体へのポインターを指定します。 ダイアログ ボックスの初期化後、ダイアログ ボックス プロシージャは構造体を使用してユーザー入力に関する情報を返します。 アプリケーションのニーズに合わせて、共通のダイアログ ボックスをカスタマイズすることもできます。
次の表に、さまざまな種類の一般的なダイアログ ボックスの簡単な説明と、各型で使用される関数と構造を示します。
| ダイアログ ボックス | 形容 |
|---|---|
|
色の |
使用可能な色を表示し、必要に応じてユーザーがカスタム 色を作成できるようにします。 ユーザーは、基本色またはカスタム色を選択できます。
ChooseColor 関数を使用し、CHOOSECOLOR構造体をします。 詳細については、「色] ダイアログ ボックスのを参照してください。 |
|
検索 |
検索する文字列をユーザーが入力できるダイアログ ボックスを表示します。 ユーザーは、検索の方向や、検索で大文字と小文字が区別されるかどうかなど、検索オプションを指定することもできます。
FindText 関数を使用し、FINDREPLACE構造体します。 詳細については、「検索と置換ダイアログ ボックスを参照してください。 |
|
フォント |
ユーザーがフォント ファミリと関連するフォント スタイル、ポイント サイズ、その他のフォント属性 (フォントの色、下線、取り消し線など) を選択できるダイアログ ボックスを表示します。
ChooseFont 関数を使用し、CHOOSEFONT構造体します。 詳細については、「フォント] ダイアログ ボックスのを参照してください。 |
|
を開く |
ユーザーが開くファイルまたはシェルの名前空間オブジェクトの名前を入力または選択できるダイアログ ボックスを表示します。 このダイアログ ボックスには、ユーザーがシェル名前空間を参照できるようにするドライブ、ディレクトリ、およびシェル名前空間拡張機能の一覧が含まれています。 また、表示されるファイル名をユーザーがフィルター処理できるようにするファイル名拡張子の一覧も含まれています。
GetOpenFileName 関数を使用し、OPENFILENAME構造体します。 詳細については、「開く]および[名前を付けて保存]ダイアログ ボックスを参照してください。 |
|
ページのセットアップ |
現在のページ構成を表示します。 ユーザーは、用紙の向き、サイズ、ソース、余白などのページ構成オプションを選択できます。
PageSetupDlg 関数と PAGESETUPDLG構造体使用します。 詳細については、「ページ設定ダイアログ ボックス」を参照してください。 |
|
印刷 |
インストールされているプリンターとその構成に関する情報を表示します。 ユーザーは、印刷するページの範囲や部数などの印刷ジョブ オプションを選択し、印刷プロセスを開始できます。
PrintDlg 関数と PRINTDLG構造体使用します。 詳細については、「印刷]ダイアログ ボックスのを参照してください。 Print ダイアログ ボックスではなく、Print プロパティ シートを表示するには、PRINTDLGEX 構造体で PrintDlgEx 関数を使用します。 プロパティ シートの [全般] ページは、[印刷] ダイアログ ボックスに似ています。 プロパティ シートには、全般 ページの後に、アプリケーション固有およびドライバー固有の追加のプロパティ ページを含めることができます。 詳細については、「プロパティ シートを印刷する」を参照してください。 |
|
置換 |
検索する文字列と置換文字列をユーザーが入力できるダイアログ ボックスを表示します。 ユーザーは、検索で大文字と小文字が区別されるかどうかなどの検索オプションと、置換の範囲などの置換オプションを指定できます。
ReplaceText 関数を使用し、FINDREPLACE構造体します。 詳細については、「検索と置換ダイアログ ボックスを参照してください。 |
|
名前を付けて保存 |
ユーザーがファイルまたはシェルの名前空間オブジェクトを保存する名前を入力または選択できるダイアログ ボックスを表示します。 このダイアログ ボックスには、ユーザーがシェル名前空間を参照できるようにするドライブ、ディレクトリ、およびシェル名前空間拡張機能の一覧が含まれています。 また、表示されるファイル名をユーザーがフィルター処理できるようにするファイル名拡張子の一覧も含まれています。
GetSaveFileName 関数と OPENFILENAME構造体使用します。 詳細については、「開く]および[名前を付けて保存]ダイアログ ボックスを参照してください。 |
[印刷設定] ダイアログ ボックスは使用できますが、[ページ設定] ダイアログ ボックスに置き換わりました。 アプリケーションでは、[印刷セットアップ] ダイアログ ボックスではなく、[ページセットアップ] ダイアログ ボックスを使用する必要があります。
すべての一般的なダイアログ ボックスは、検索 と 置換 ダイアログ ボックスを除き、モーダルです。 ダイアログ ボックスの作成に使用する関数が返される前に、モーダル ダイアログ ボックスを閉じる必要があります。 [検索 と 置換 ダイアログ ボックスはモードレスです。ダイアログ ボックスが閉じる前に関数が戻ります。 [検索] ダイアログ ボックスと [置換] ダイアログ ボックスを使用する場合は、アプリケーションのメイン メッセージ ループで IsDialogMessage 関数を使用して、Tab キーや ESC キーなどのキーボード入力がこれらのダイアログ ボックスで正しく処理されるようにする必要もあります。