CDialog::DoModal

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

モーダルダイアログボックスを起動します。この関数は、ダイアログボックスの実行が終了したときに戻ります。

virtual INT_PTR DoModal( );

戻り値

ダイアログボックスを閉じる CDialog::EndDialog メンバ関数のパラメータ nResult に渡す int 値を返します。ダイアログボックスを作成できなかった場合は、戻り値 –1 を返します。それ以外のエラーが発生した場合は、IDABORT を返します。その場合、Output window に GetLastError のエラー情報が含まれます。

解説

このメンバ関数は、ダイアログボックスがアクティブの間すべての対話を処理します。これにより、ダイアログボックスがモーダルになります。つまり、そのダイアログボックスを閉じるまで、ユーザーはほかのウィンドウを操作できません。

[OK]、[キャンセル] などのダイアログボックスのプッシュボタンをどれかクリックすると、OnOK または OnCancel のようなメッセージハンドラメンバ関数が呼び出され、ダイアログボックスが閉じられます。既定の OnOK メンバ関数は、ダイアログボックスのデータの妥当性検査と更新をしてダイアログボックスを閉じ、IDOK を返します。既定の OnCancel メンバ関数は、ダイアログボックスのデータの妥当性検査や更新を行わずに、ダイアログボックスを閉じ、IDCANCEL を返します。このメッセージハンドラ関数をオーバーライドすると、独自の機能を持たせることができます。

メモ :
PreTranslateMessage はモーダルダイアログボックスメッセージ処理のために呼び出されます。

使用例

void CMyDialog::OnMenuShowAboutDialog()
{
   // Construct the dialog box passing the 
   // ID of the dialog template resource
   CDialog aboutDlg(IDD_ABOUTBOX);

   // Create and show the dialog box
   INT_PTR nRet = -1;
   nRet = aboutDlg.DoModal();

   // Handle the return value from DoModal
   switch (nRet)
   {
      case -1: 
         AfxMessageBox(_T("Dialog box could not be created!"));
         break;
      case IDABORT:
         // Do something
         break;
      case IDOK:
         // Do something
         break;
      case IDCANCEL:
         // Do something
         break;
      default:
         // Do something
         break;
   };
}