次の方法で共有

ダイアログ ボックス (ダイアログ ボックス)

  • [アーティクル]

ダイアログ ボックスは、アプリケーションがユーザー入力を取得するために作成する一時的なウィンドウです。 通常、アプリケーションはダイアログ ボックスを使用して、メニュー項目の追加情報をユーザーに求めるメッセージを表示します。 通常、ダイアログ ボックスには、ユーザーがテキストを入力したり、オプションを選択したり、アクションを指示したりする 1 つ以上のコントロール (子ウィンドウ) が含まれます。

Windows には、開く や 印刷などの一般的なメニュー項目をサポートする定義済みのダイアログ ボックスも用意されています。 これらのメニュー項目を使用するアプリケーションでは、アプリケーションの種類に関係なく、このユーザー入力を求める一般的なダイアログ ボックスを使用する必要があります。

このセクションでは

名前 形容
ダイアログ ボックスについて アプリケーションのユーザー インターフェイスでのダイアログ ボックスの使用について説明します。
[] ダイアログ ボックスのプログラミングに関する考慮事項 この概要では、ダイアログ ボックスに関するいくつかのプログラミング上の考慮事項について説明します。
ダイアログ ボックス を使用する ダイアログ ボックスを使用して、情報を表示し、ユーザーからの入力を求めます。
ダイアログ ボックスリファレンス API リファレンス
共通ダイアログ ボックス ライブラリ アプリケーションのユーザー インターフェイスで共通のダイアログ ボックスを使用する方法について説明します。

ダイアログ ボックス関数

名前 形容
CreateDialogの ダイアログ ボックス テンプレート リソースからモードレス ダイアログ ボックスを作成します。
CreateDialogIndirectの メモリ内のダイアログ ボックス テンプレートからモードレス ダイアログ ボックスを作成します。
CreateDialogIndirectParamの メモリ内のダイアログ ボックス テンプレートからモードレス ダイアログ ボックスを作成します。 この関数は、ダイアログ ボックスを表示する前に、WM_INITDIALOG メッセージの lParam パラメーターとして、アプリケーション定義値をダイアログ ボックス プロシージャに渡します。 アプリケーションでは、この値を使用してダイアログ ボックス コントロールを初期化できます。
CreateDialogParamの ダイアログ ボックス テンプレート リソースからモードレス ダイアログ ボックスを作成します。 この関数は、ダイアログ ボックスを表示する前に、WM_INITDIALOG メッセージの lParam パラメーターとして、アプリケーション定義値をダイアログ ボックス プロシージャに渡します。 アプリケーションでは、この値を使用してダイアログ ボックス コントロールを初期化できます。
DefDlgProcの 既定のダイアログ ボックス ウィンドウ プロシージャを呼び出して、プライベート ウィンドウ クラスを持つダイアログ ボックスが処理しないウィンドウ メッセージの既定の処理を提供します。
DialogBox ダイアログ ボックス テンプレート リソースからモーダル ダイアログ ボックスを作成します。 DialogBox は、指定されたコールバック関数が EndDialog 関数を呼び出してモーダル ダイアログ ボックスを終了するまで、コントロールを返しません。
DialogBoxIndirect メモリ内のダイアログ ボックス テンプレートからモーダル ダイアログ ボックスを作成します。 DialogBoxIndirect は、指定したコールバック関数が、EndDialog 関数を呼び出してモーダル ダイアログ ボックスを終了するまで制御を返しません。
DialogBoxIndirectParam メモリ内のダイアログ ボックス テンプレートからモーダル ダイアログ ボックスを作成します。 この関数は、ダイアログ ボックスを表示する前に、WM_INITDIALOG メッセージの lParam パラメーターとして、アプリケーション定義値をダイアログ ボックス プロシージャに渡します。 アプリケーションでは、この値を使用してダイアログ ボックス コントロールを初期化できます。
DialogBoxParam ダイアログ ボックス テンプレート リソースからモーダル ダイアログ ボックスを作成します。 この関数は、ダイアログ ボックスを表示する前に、WM_INITDIALOG メッセージの lParam パラメーターとして、アプリケーション定義値をダイアログ ボックス プロシージャに渡します。 アプリケーションでは、この値を使用してダイアログ ボックス コントロールを初期化できます。
DialogProc CreateDialog および DialogBox で使用されるアプリケーション定義のコールバック関数 関数のファミリです。 モーダル ダイアログ ボックスまたはモードレス ダイアログ ボックスに送信されたメッセージを処理します。 DLGPROC 型は、このコールバック関数へのポインターを定義します。 DialogProc は、アプリケーション定義関数名のプレースホルダーです。
EndDialogの モーダル ダイアログ ボックスを破棄し、システムがダイアログ ボックスの処理を終了します。
GetDialogBaseUnitsの システムのダイアログの基本単位を取得します。これは、システム フォントの文字の平均幅と高さです。 システム フォントを使用するダイアログ ボックスでは、これらの値を使用して、ダイアログ ボックス テンプレートとピクセルで指定されているダイアログ テンプレート単位間で変換できます。 システム フォントを使用しないダイアログ ボックスの場合、ダイアログ テンプレート単位からピクセルへの変換は、ダイアログ ボックスで使用されるフォントによって異なります。
GetDlgCtrlIDの 指定したコントロールの識別子を取得します。
GetDlgItemをする 指定したダイアログ ボックス内のコントロールへのハンドルを取得します。
GetDlgItemIntをする ダイアログ ボックス内の指定したコントロールのテキストを整数値に変換します。
GetDlgItemTextの ダイアログ ボックス内のコントロールに関連付けられているタイトルまたはテキストを取得します。
GetNextDlgGroupItemの ダイアログ ボックスで指定したコントロールの前 (または後に続く) コントロールのグループ内の最初のコントロールへのハンドルを取得します。
GetNextDlgTabItemをする 指定したコントロールの前 (または後に) WS_TABSTOP スタイルを持つ最初のコントロールへのハンドルを取得します。
IsDialogMessageの メッセージが指定されたダイアログ ボックスを対象としているかどうかを判断し、メッセージを処理する場合は処理します。
MapDialogRect 指定したダイアログ ボックスの単位を画面単位 (ピクセル) に変換します。 この関数は、指定した RECT 構造体の座標を変換された座標に置き換えます。これにより、構造体を使用してダイアログ ボックスを作成したり、ダイアログ ボックス内にコントロールを配置したりできるようになります。
MessageBox システム アイコン、一連のボタン、および状態やエラー情報などのアプリケーション固有の簡単なメッセージを含むモーダル ダイアログ ボックスを表示します。 メッセージ ボックスは、ユーザーがクリックしたボタンを示す整数値を返します。
MessageBoxEx メッセージ ボックスを作成、表示、および操作します。 メッセージ ボックスには、アプリケーション定義のメッセージとタイトルに加えて、定義済みのアイコンとプッシュ ボタンの任意の組み合わせが含まれます。 ボタンは、システム ユーザー インターフェイスの言語で表示されます。
MessageBoxIndirect メッセージ ボックスを作成、表示、および操作します。 メッセージ ボックスには、アプリケーション定義のメッセージ テキストとタイトル、任意のアイコン、および定義済みのプッシュ ボタンの任意の組み合わせが含まれます。
SendDlgItemMessage ダイアログ ボックス内の指定したコントロールにメッセージを送信します。
SetDlgItemIntの ダイアログ ボックス内のコントロールのテキストを、指定した整数値の文字列形式に設定します。
SetDlgItemText ダイアログ ボックス内のコントロールのタイトルまたはテキストを設定します。

ダイアログ ボックスのメッセージ

名前 形容
DM_GETDEFID ダイアログ ボックスの既定のプッシュ ボタン コントロールの識別子を取得します。
DM_REPOSITION デスクトップ領域内に収まるように、最上位のダイアログ ボックスの位置を変更します。 アプリケーションは、サイズを変更した後にこのメッセージをダイアログ ボックスに送信して、ダイアログ ボックス全体が確実に表示されるようにすることができます。
DM_SETDEFID ダイアログ ボックスの既定のプッシュ ボタンの識別子を変更します。

ダイアログ ボックスの通知

名前 形容
WM_CTLCOLORDLG システムがダイアログ ボックスを描画する前に、ダイアログ ボックスに送信されます。 このメッセージに応答することで、ダイアログ ボックスは、指定されたディスプレイ デバイス コンテキスト ハンドルを使用して、テキストと背景色を設定できます。
WM_ENTERIDLE アイドル状態に入っているモーダル ダイアログ ボックスまたはメニューの所有者ウィンドウに送信されます。 モーダル ダイアログ ボックスまたはメニューは、1 つ以上の前のメッセージを処理した後、キューで待機しているメッセージがない場合にアイドル状態になります。
WM_GETDLGCODE コントロールに関連付けられているウィンドウ プロシージャに送信されます。 既定では、システムはコントロールへのすべてのキーボード入力を処理します。システムは、特定の種類のキーボード入力をダイアログ ボックス ナビゲーション キーとして解釈します。 この既定の動作をオーバーライドするために、コントロールは WM_GETDLGCODE メッセージに応答して、自身を処理する入力の種類を示すことができます。
WM_INITDIALOG ダイアログ ボックスが表示される直前に、ダイアログ ボックス プロシージャに送信されます。 通常、ダイアログ ボックス プロシージャは、このメッセージを使用してコントロールを初期化し、ダイアログ ボックスの外観に影響を与えるその他の初期化タスクを実行します。
WM_NEXTDLGCTL ダイアログ ボックスのプロシージャに送信され、キーボード フォーカスをダイアログ ボックス内の別のコントロールに設定します。

ダイアログ ボックスの構造

名前 形容
DLGITEMTEMPLATEをする ダイアログ ボックス内のコントロールの寸法とスタイルを定義します。 これらの構造体の 1 つ以上を DLGTEMPLATE 構造体と組み合わせて、ダイアログ ボックスの標準テンプレートを形成します。
DLGITEMTEMPLATEEXの 拡張ダイアログ ボックスについて説明します。 拡張ダイアログ・ボックス・テンプレートの形式の説明については、DLGTEMPLATEEX参照してください。
DLGTEMPLATEの ダイアログ ボックスの寸法とスタイルを定義します。 この構造体は、常にダイアログ ボックスの標準テンプレートの最初の構造であり、ダイアログ ボックス内のコントロールの数も指定するため、テンプレート内の DLGITEMTEMPLATE構造体後続の数を指定します。
DLGTEMPLATEEXの 拡張ダイアログ ボックス テンプレートは、ダイアログ ボックスを記述し、ダイアログ ボックス内のコントロールの数を指定する DLGTEMPLATEEX ヘッダーで始まります。 ダイアログ ボックス内の各コントロールについて、拡張ダイアログ ボックス テンプレートには、DLGITEMTEMPLATEEX 形式を使用してコントロールを記述するデータ ブロックがあります。
MSGBOXPARAMSをする メッセージ ボックスの表示に使用する情報が含まれます。 MessageBoxIndirect 関数は、この構造体を使用します。