CWinFormsDialog::OnInitDialog

2011-08-09

MFC ダイアログボックスに Windows フォームユーザーコントロールを作成してホストすることにより、そのダイアログボックスを初期化します。

virtual BOOL OnInitDialog();

戻り値

アプリケーションがダイアログボックスのコントロールの 1 つに入力フォーカスを設定したかどうかを指定するブール値を返します。 Windows がダイアログボックスの最初のコントロールに入力フォーカスを設定した場合は、0 以外の値を返します。このメソッドが 0 を返すのは、アプリケーションがダイアログボックスのコントロールの 1 つに入力フォーカスを明示的に設定した場合だけです。

解説

CDialog から継承した Create、CreateIndirect、または DoModal の各メソッドを使用して MFC ダイアログボックスを作成すると、WM_INITDIALOG メッセージが送信され、このメソッドが呼び出されます。このメソッドは、UserControl コントロールのインスタンスをダイアログボックス上に作成し、ユーザーコントロールのサイズに合わせてダイアログボックスのサイズを調整します。その後、新しいコントロールを MFC ダイアログボックスでホストします。

ダイアログボックスを初期化するときに特別な処理が必要な場合は、このメンバー関数をオーバーライドします。このメソッドの使い方の詳細については、「CDialog::OnInitDialog」を参照してください。