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