CDialog::EndDialog

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

更新 : 2007 年 11 月

モーダルダイアログボックスを終了します。

void EndDialog(
   int nResult 
);

パラメータ

nResult
ダイアログボックスから DoModal の呼び出し側に返す値。

解説

nResult は DoModal の戻り値です。モーダルダイアログボックスを作成したときは EndDialog 関数を使って処理を完了する必要があります。

いつでも EndDialog 関数を呼び出すことができます。OnInitDialog 関数の中からでもかまいません。この場合、ダイアログボックスを表示される前か、入力フォーカスが設定される前に閉じます。

EndDialog 関数は、ダイアログボックスをすぐに閉じません。代わりに、フラグを設定して、現在のメッセージハンドラ関数から戻るとすぐにダイアログボックスを閉じるように指示します。

使用例

void CMyDialog::OnMenuShowSimpleModal()
{
   CSimpleDlg myDlg;
   INT_PTR nRet = myDlg.DoModal();

   if (nRet == IDOK || nRet == 5)
      AfxMessageBox(_T("Dialog closed successfully"));
}

void CSimpleDlg::OnRButtonUp(UINT nFlags, CPoint point)
{
   UNREFERENCED_PARAMETER(nFlags);
   // Do something

   int nRet = point.x; // Just any value would do!
   EndDialog(nRet); // This value is returned by DoModal!

   // Do something

   return; // Dialog closed and DoModal returns only here!
}