ダイアログ ボックスが表示される直前に、ダイアログ ボックス プロシージャに送信されます。 通常、ダイアログ ボックス プロシージャは、このメッセージを使用してコントロールを初期化し、ダイアログ ボックスの外観に影響を与えるその他の初期化タスクを実行します。
#define WM_INITDIALOG 0x0110
パラメーター
-
wParam
-
既定のキーボード フォーカスを受け取るコントロールのハンドル。 システムは、ダイアログ ボックス プロシージャが TRUE を返す場合にのみ、既定のキーボード フォーカスを割り当てます。
-
lParam
-
追加の初期化データ。 このデータは、ダイアログ ボックスの作成に使用される CreateDialogIndirectParam、CreateDialogParam、DialogBoxIndirectParam、または DialogBoxParam 関数の呼び出しで、lParam パラメーターとしてシステムに渡されます。 プロパティ シートの場合、このパラメーターはページの作成に使用される PROPSHEETPAGE 構造体へのポインターです。 他のダイアログ ボックス作成関数が使用されている場合、このパラメーターは 0 です。
戻り値
ダイアログ ボックス プロシージャは、wParam で指定されたコントロールにキーボード フォーカスを設定するシステムを指示する TRUE を返す必要があります。 それ以外の場合は、システムが既定のキーボード フォーカスを設定できないように FALSE を 返す必要があります。
ダイアログ ボックス プロシージャは、値を直接返す必要があります。 SetWindowLong 関数によって設定されたDWL_MSGRESULT値は無視されます。
注釈
既定のキーボード フォーカスを受け取るコントロールは、常にダイアログ ボックスの最初のコントロールであり、表示され、無効ではなく、 WS_TABSTOP スタイルを持ちます。 ダイアログ ボックス プロシージャが TRUE を返すと、システムはコントロールをチェックして、プロシージャが無効にされていないことを確認します。 無効になっている場合、システムはキーボード フォーカスを次のコントロールに設定します。このコントロールは表示され、無効ではなく、 WS_TABSTOP。
アプリケーションは、ダイアログ ボックスのいずれかのコントロールにキーボード フォーカスを設定している場合にのみ FALSE を 返すことができます。
Requirements
| Requirement | 価値 |
|---|---|
| サポートされている最小のクライアント |
Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows 2000 Server [デスクトップ アプリのみ] |
| Header |
|