CDialog::OnInitDialog (MFC)

MFC ライブラリリファレンス

CDialog::OnInitDialog

WM_INITDIALOG メッセージへの応答として呼び出されます。

virtual  BOOL OnInitDialog( );

戻り値

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

解説

このメッセージは、Create 関数、CreateIndirect 関数、または DoModal 関数が呼び出されている間に、ダイアログボックスの表示直前にダイアログボックスに対して送られます。

ダイアログボックスを初期化するときに特別な処理が必要な場合は、このメンバ関数をオーバーライドします。オーバーライドした関数では、まず基本クラスの OnInitDialog を呼び出します。戻り値は無視してもかまいません。オーバーライドしたメンバ関数は通常 TRUE を返します。

Windows が OnInitDialog 関数を呼び出すときは、ユーザーのメッセージマップではなく、すべての Microsoft Foundation Class ライブラリダイアログボックス共通の標準グローバルダイアログボックスプロシージャを使うため、このメンバ関数にメッセージマップエントリは必要ありません。

使用例

/* MyDialog.cpp */
#include "MyDialog.h"

BOOL CMyDialog::OnInitDialog() 
{
   CDialog::OnInitDialog();
   
   // TODO: Add extra initialization here
   m_cMyEdit.SetWindowText("My Name"); // Initialize control values
   m_cMyList.ShowWindow(SW_HIDE);      // Show or hide a control, etc.

   return TRUE;   // return TRUE unless you set the focus to a control
                  // EXCEPTION: OCX Property Pages should return FALSE
}

参照

その他の技術情報

CDialog のメンバ

関連項目

その他の技術情報