Share via


CDialog::OnCancel

フレームワークは、ユーザーが [キャンセル] をクリックするか、モーダルまたはモードレス ダイアログ ボックスの Esc キーを押したときにこのメソッドを呼び出します。

virtual void OnCancel( );

解説

ユーザーが [キャンセル] をクリックするか、Esc キーを行うことで、ダイアログ ボックスを閉じるときにアクションを実行するには、このメソッドをオーバーライドします (古いデータ復元など)。既定値は EndDialog を呼び出し、DoModal に IDCANCEL を戻させますにより、モーダル ダイアログ ボックスを閉じます。

モードレス ダイアログ ボックスの [キャンセル] のボタンを実装する場合は、OnCancel のメソッドをオーバーライドし、その中の DestroyWindow を呼び出す必要があります。ダイアログ ボックスを表示するオブジェクトを破棄せずに呼び出す EndDialogをため、基本クラスのメソッドを呼び出さないでください。

[!メモ]

Windows XP でコンパイルされるプログラムで CFileDialog のオブジェクトを使用するときにこのメソッドをオーバーライドすることはできません。CFileDialog の詳細については、「CFileDialog クラス」を参照してください。

使用例

void CSimpleDlg::OnCancel()
{
   // TODO: Add extra cleanup here

   // Ensure that you reset all the values back to the
   // ones before modification. This handler is called
   // when the user doesn't want to save the changes.

   if (AfxMessageBox(_T("Are you sure you want to abort the changes?"), 
      MB_YESNO) == IDNO)
   {
      // Give the user a chance if he has unknowingly hit the
      // Cancel button. If he says No, return. Don't reset. If
      // Yes, go ahead and reset the values and close the dialog.
      return; 
   }

   m_nMyValue = m_nPrevValue;
   m_pMyString = NULL; 

   CDialog::OnCancel();
}

必要条件

Header: afxwin.h

参照

関連項目

CDialog クラス

階層図

CDialog::OnOK

CDialog::EndDialog