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 [デスクトップ アプリのみ]
ヘッダー
Winuser.h (Windows.h を含む)

関連項目

参照

CreateDialogIndirectParam

CreateDialogParam

DialogBoxIndirectParam

DialogBoxParam

SetFocus

概念

ダイアログ ボックス

その他のリソース

PROPSHEETPAGE