X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/532c773634cccf5c19f42aac5d2425ed3e7bb12a..d8eff331e23435d9d8d6483a40f6fd9997a13f87:/samples/except/except.cpp?ds=sidebyside diff --git a/samples/except/except.cpp b/samples/except/except.cpp index 6f8a0acbbe..7ea7b7b159 100644 --- a/samples/except/except.cpp +++ b/samples/except/except.cpp @@ -1,11 +1,11 @@ ///////////////////////////////////////////////////////////////////////////// -// Name: except.cpp -// Purpose: Except wxWindows sample -// Author: Julian Smart +// Name: samples/except/except.cpp +// Purpose: shows how C++ exceptions can be used in wxWidgets +// Author: Vadim Zeitlin // Modified by: -// Created: 04/01/98 +// Created: 2003-09-17 // RCS-ID: $Id$ -// Copyright: (c) Julian Smart +// Copyright: (c) 2003-2005 Vadim Zeitlin // Licence: wxWindows licence ///////////////////////////////////////////////////////////////////////////// @@ -24,8 +24,12 @@ #pragma hdrstop #endif +#if !wxUSE_EXCEPTIONS + #error "This sample only works with wxUSE_EXCEPTIONS == 1" +#endif // !wxUSE_EXCEPTIONS + // for all others, include the necessary headers (this file is usually all you -// need because it includes almost all "standard" wxWindows headers) +// need because it includes almost all "standard" wxWidgets headers) #ifndef WX_PRECOMP #include "wx/log.h" @@ -37,7 +41,11 @@ #include "wx/button.h" #include "wx/sizer.h" - #include "wx/utils.h" // for wxMessageBox + #include "wx/utils.h" + #include "wx/msgdlg.h" + #include "wx/icon.h" + + #include "wx/thread.h" #endif // ---------------------------------------------------------------------------- @@ -49,6 +57,16 @@ #include "../sample.xpm" #endif +// ---------------------------------------------------------------------------- +// private functions +// ---------------------------------------------------------------------------- + +static void DoCrash() +{ + char *p = 0; + strcpy(p, "Let's crash"); +} + // ---------------------------------------------------------------------------- // private classes // ---------------------------------------------------------------------------- @@ -63,15 +81,25 @@ public: // program startup virtual bool OnInit(); - // 2nd-level exception handling: we get all the exceptions occuring in any + // 2nd-level exception handling: we get all the exceptions occurring in any // event handler here - virtual void HandleEvent(wxEvtHandler *handler, - wxEventFunction func, - wxEvent& event) const; + virtual bool OnExceptionInMainLoop(); // 3rd, and final, level exception handling: whenever an unhandled // exception is caught, this function is called virtual void OnUnhandledException(); + + // and now for something different: this function is called in case of a + // crash (e.g. dereferencing null pointer, division by 0, ...) + virtual void OnFatalException(); + + // you can override this function to do something different (e.g. log the + // assert to file) whenever an assertion fails + virtual void OnAssertFailure(const wxChar *file, + int line, + const wxChar *func, + const wxChar *cond, + const wxChar *msg); }; // Define a new frame type: this is going to be our main frame @@ -79,21 +107,39 @@ class MyFrame : public wxFrame { public: // ctor(s) - MyFrame(const wxString& title, const wxPoint& pos, const wxSize& size, - long style = wxDEFAULT_FRAME_STYLE); + MyFrame(); // event handlers (these functions should _not_ be virtual) void OnQuit(wxCommandEvent& event); void OnAbout(wxCommandEvent& event); void OnDialog(wxCommandEvent& event); + + void OnThrowInt(wxCommandEvent& event); void OnThrowString(wxCommandEvent& event); + void OnThrowObject(wxCommandEvent& event); + void OnThrowUnhandled(wxCommandEvent& event); + + void OnCrash(wxCommandEvent& event); +#if wxUSE_ON_FATAL_EXCEPTION + void OnHandleCrash(wxCommandEvent& event); +#endif + +protected: // 1st-level exception handling: we overload ProcessEvent() to be able to // catch exceptions which occur in MyFrame methods here virtual bool ProcessEvent(wxEvent& event); + // provoke assert in main or worker thread + // + // this is used to show how an assert failure message box looks like + void OnShowAssert(wxCommandEvent& event); +#if wxUSE_THREADS + void OnShowAssertInThread(wxCommandEvent& event); +#endif // wxUSE_THREADS + private: - // any class wishing to process wxWindows events must use this macro + // any class wishing to process wxWidgets events must use this macro DECLARE_EVENT_TABLE() }; @@ -106,6 +152,7 @@ public: // event handlers void OnThrowInt(wxCommandEvent& event); void OnThrowObject(wxCommandEvent& event); + void OnCrash(wxCommandEvent& event); private: DECLARE_EVENT_TABLE() @@ -123,6 +170,11 @@ private: wxString m_msg; }; +// Another exception class which just has to be different from anything else +class UnhandledException +{ +}; + // ---------------------------------------------------------------------------- // constants // ---------------------------------------------------------------------------- @@ -130,12 +182,19 @@ private: // IDs for the controls and the menu commands enum { - // control ids - Except_ThrowInt = 100, + // control ids and menu items + Except_ThrowInt = wxID_HIGHEST, + Except_ThrowString, Except_ThrowObject, - - // menu items - Except_ThrowString = 200, + Except_ThrowUnhandled, + Except_Crash, +#if wxUSE_ON_FATAL_EXCEPTION + Except_HandleCrash, +#endif // wxUSE_ON_FATAL_EXCEPTION + Except_ShowAssert, +#if wxUSE_THREADS + Except_ShowAssertInThread, +#endif // wxUSE_THREADS Except_Dialog, Except_Quit = wxID_EXIT, @@ -143,25 +202,37 @@ enum }; // ---------------------------------------------------------------------------- -// event tables and other macros for wxWindows +// event tables and other macros for wxWidgets // ---------------------------------------------------------------------------- -// the event tables connect the wxWindows events with the functions (event +// the event tables connect the wxWidgets events with the functions (event // handlers) which process them. It can be also done at run-time, but for the // simple menu events like this the static method is much simpler. BEGIN_EVENT_TABLE(MyFrame, wxFrame) EVT_MENU(Except_Quit, MyFrame::OnQuit) EVT_MENU(Except_About, MyFrame::OnAbout) EVT_MENU(Except_Dialog, MyFrame::OnDialog) + EVT_MENU(Except_ThrowInt, MyFrame::OnThrowInt) EVT_MENU(Except_ThrowString, MyFrame::OnThrowString) + EVT_MENU(Except_ThrowObject, MyFrame::OnThrowObject) + EVT_MENU(Except_ThrowUnhandled, MyFrame::OnThrowUnhandled) + EVT_MENU(Except_Crash, MyFrame::OnCrash) +#if wxUSE_ON_FATAL_EXCEPTION + EVT_MENU(Except_HandleCrash, MyFrame::OnHandleCrash) +#endif // wxUSE_ON_FATAL_EXCEPTION + EVT_MENU(Except_ShowAssert, MyFrame::OnShowAssert) +#if wxUSE_THREADS + EVT_MENU(Except_ShowAssertInThread, MyFrame::OnShowAssertInThread) +#endif // wxUSE_THREADS END_EVENT_TABLE() BEGIN_EVENT_TABLE(MyDialog, wxDialog) EVT_BUTTON(Except_ThrowInt, MyDialog::OnThrowInt) EVT_BUTTON(Except_ThrowObject, MyDialog::OnThrowObject) + EVT_BUTTON(Except_Crash, MyDialog::OnCrash) END_EVENT_TABLE() -// Create a new application object: this macro will allow wxWindows to create +// Create a new application object: this macro will allow wxWidgets to create // the application object during program execution (it's better than using a // static object for many reasons) and also implements the accessor function // wxGetApp() which will return the reference of the right type (i.e. MyApp and @@ -175,9 +246,11 @@ IMPLEMENT_APP(MyApp) // 'Main program' equivalent: the program execution "starts" here bool MyApp::OnInit() { + if ( !wxApp::OnInit() ) + return false; + // create the main application window - MyFrame *frame = new MyFrame(_T("Except wxWindows App"), - wxPoint(50, 50), wxSize(450, 340)); + MyFrame *frame = new MyFrame(); // and show it (the frames, unlike simple controls, are not shown when // created initially) @@ -189,25 +262,72 @@ bool MyApp::OnInit() return true; } -void -MyApp::HandleEvent(wxEvtHandler *handler, - wxEventFunction func, - wxEvent& event) const +bool MyApp::OnExceptionInMainLoop() { try { - wxApp::HandleEvent(handler, func, event); + throw; } catch ( int i ) { - wxLogError(_T("Caught an int %d in MyApp."), i); + wxLogWarning(wxT("Caught an int %d in MyApp."), i); } + catch ( MyException& e ) + { + wxLogWarning(wxT("Caught MyException(%s) in MyApp."), e.what()); + } + catch ( ... ) + { + throw; + } + + return true; } void MyApp::OnUnhandledException() { - wxMessageBox(_T("Unhandled exception caught, program will terminate."), - _T("wxExcept Sample"), wxOK | wxICON_ERROR); + // this shows how we may let some exception propagate uncaught + try + { + throw; + } + catch ( UnhandledException& ) + { + throw; + } + catch ( ... ) + { + wxMessageBox(wxT("Unhandled exception caught, program will terminate."), + wxT("wxExcept Sample"), wxOK | wxICON_ERROR); + } +} + +void MyApp::OnFatalException() +{ + wxMessageBox(wxT("Program has crashed and will terminate."), + wxT("wxExcept Sample"), wxOK | wxICON_ERROR); +} + +void MyApp::OnAssertFailure(const wxChar *file, + int line, + const wxChar *func, + const wxChar *cond, + const wxChar *msg) +{ + // take care to not show the message box from a worker thread, this doesn't + // work as it doesn't have any event loop + if ( !wxIsMainThread() || + wxMessageBox + ( + wxString::Format("An assert failed in %s().", func) + + "\n" + "Do you want to call the default assert handler?", + "wxExcept Sample", + wxYES_NO | wxICON_QUESTION + ) == wxYES ) + { + wxApp::OnAssertFailure(file, line, func, cond, msg); + } } // ============================================================================ @@ -215,27 +335,44 @@ void MyApp::OnUnhandledException() // ============================================================================ // frame constructor -MyFrame::MyFrame(const wxString& title, const wxPoint& pos, const wxSize& size, long style) - : wxFrame(NULL, -1, title, pos, size, style) +MyFrame::MyFrame() + : wxFrame(NULL, wxID_ANY, wxT("Except wxWidgets App"), + wxPoint(50, 50), wxSize(450, 340)) { // set the frame icon - SetIcon(wxICON(mondrian)); + SetIcon(wxICON(sample)); #if wxUSE_MENUS // create a menu bar wxMenu *menuFile = new wxMenu; - menuFile->Append(Except_Dialog, _T("Show &dialog\tCtrl-D")); - menuFile->Append(Except_ThrowString, _T("Throw a &string\tCtrl-S")); + menuFile->Append(Except_Dialog, wxT("Show &dialog\tCtrl-D")); + menuFile->AppendSeparator(); + menuFile->Append(Except_ThrowInt, wxT("Throw an &int\tCtrl-I")); + menuFile->Append(Except_ThrowString, wxT("Throw a &string\tCtrl-S")); + menuFile->Append(Except_ThrowObject, wxT("Throw an &object\tCtrl-O")); + menuFile->Append(Except_ThrowUnhandled, + wxT("Throw &unhandled exception\tCtrl-U")); + menuFile->Append(Except_Crash, wxT("&Crash\tCtrl-C")); + menuFile->AppendSeparator(); +#if wxUSE_ON_FATAL_EXCEPTION + menuFile->AppendCheckItem(Except_HandleCrash, wxT("&Handle crashes\tCtrl-H")); menuFile->AppendSeparator(); - menuFile->Append(Except_Quit, _T("E&xit\tCtrl-Q"), _T("Quit this program")); +#endif // wxUSE_ON_FATAL_EXCEPTION + menuFile->Append(Except_ShowAssert, wxT("Provoke &assert failure\tCtrl-A")); +#if wxUSE_THREADS + menuFile->Append(Except_ShowAssertInThread, + wxT("Assert failure in &thread\tShift-Ctrl-A")); +#endif // wxUSE_THREADS + menuFile->AppendSeparator(); + menuFile->Append(Except_Quit, wxT("E&xit\tCtrl-Q"), wxT("Quit this program")); wxMenu *helpMenu = new wxMenu; - helpMenu->Append(Except_About, _T("&About...\tF1"), _T("Show about dialog")); + helpMenu->Append(Except_About, wxT("&About...\tF1"), wxT("Show about dialog")); // now append the freshly created menu to the menu bar... wxMenuBar *menuBar = new wxMenuBar(); - menuBar->Append(menuFile, _T("&File")); - menuBar->Append(helpMenu, _T("&Help")); + menuBar->Append(menuFile, wxT("&File")); + menuBar->Append(helpMenu, wxT("&Help")); // ... and attach this menu bar to the frame SetMenuBar(menuBar); @@ -244,7 +381,7 @@ MyFrame::MyFrame(const wxString& title, const wxPoint& pos, const wxSize& size, #if wxUSE_STATUSBAR && !defined(__WXWINCE__) // create a status bar just for fun (by default with 1 pane only) CreateStatusBar(2); - SetStatusText(_T("Welcome to wxWindows!")); + SetStatusText(wxT("Welcome to wxWidgets!")); #endif // wxUSE_STATUSBAR } @@ -256,7 +393,7 @@ bool MyFrame::ProcessEvent(wxEvent& event) } catch ( const wxChar *msg ) { - wxLogMessage(_T("Caught a string \"%s\" in MyFrame"), msg); + wxLogMessage(wxT("Caught a string \"%s\" in MyFrame"), msg); return true; } @@ -270,23 +407,98 @@ void MyFrame::OnQuit(wxCommandEvent& WXUNUSED(event)) void MyFrame::OnDialog(wxCommandEvent& WXUNUSED(event)) { - MyDialog dlg(this); + try + { + MyDialog dlg(this); + + dlg.ShowModal(); + } + catch ( ... ) + { + wxLogWarning(wxT("An exception in MyDialog")); + + Destroy(); + throw; + } +} - dlg.ShowModal(); +void MyFrame::OnThrowInt(wxCommandEvent& WXUNUSED(event)) +{ + throw -17; } void MyFrame::OnThrowString(wxCommandEvent& WXUNUSED(event)) { - throw _T("some string"); + throw wxT("string thrown from MyFrame"); +} + +void MyFrame::OnThrowObject(wxCommandEvent& WXUNUSED(event)) +{ + throw MyException(wxT("Exception thrown from MyFrame")); +} + +void MyFrame::OnThrowUnhandled(wxCommandEvent& WXUNUSED(event)) +{ + throw UnhandledException(); +} + +void MyFrame::OnCrash(wxCommandEvent& WXUNUSED(event)) +{ + DoCrash(); +} + +#if wxUSE_ON_FATAL_EXCEPTION + +void MyFrame::OnHandleCrash(wxCommandEvent& event) +{ + wxHandleFatalExceptions(event.IsChecked()); +} + +#endif // wxUSE_ON_FATAL_EXCEPTION + +void MyFrame::OnShowAssert(wxCommandEvent& WXUNUSED(event)) +{ + // provoke an assert from wxArrayString + wxArrayString arr; + arr[0]; } +#if wxUSE_THREADS + +void MyFrame::OnShowAssertInThread(wxCommandEvent& WXUNUSED(event)) +{ + class AssertThread : public wxThread + { + public: + AssertThread() + : wxThread(wxTHREAD_JOINABLE) + { + } + + protected: + virtual void *Entry() + { + wxFAIL_MSG("Test assert in another thread."); + + return 0; + } + }; + + AssertThread thread; + thread.Create(); + thread.Run(); + thread.Wait(); +} + +#endif // wxUSE_THREADS + void MyFrame::OnAbout(wxCommandEvent& WXUNUSED(event)) { wxString msg; - msg.Printf( _T("This is the About dialog of the except sample.\n") - _T("Welcome to %s"), wxVERSION_STRING); + msg.Printf( wxT("This is the About dialog of the except sample.\n") + wxT("Welcome to %s"), wxVERSION_STRING); - wxMessageBox(msg, _T("About Except"), wxOK | wxICON_INFORMATION, this); + wxMessageBox(msg, wxT("About Except"), wxOK | wxICON_INFORMATION, this); } // ============================================================================ @@ -294,19 +506,20 @@ void MyFrame::OnAbout(wxCommandEvent& WXUNUSED(event)) // ============================================================================ MyDialog::MyDialog(wxFrame *parent) - : wxDialog(parent, -1, wxString(_T("Throw exception dialog"))) + : wxDialog(parent, wxID_ANY, wxString(wxT("Throw exception dialog"))) { wxSizer *sizerTop = new wxBoxSizer(wxVERTICAL); - sizerTop->Add(new wxButton(this, Except_ThrowInt, _T("Throw &int")), + sizerTop->Add(new wxButton(this, Except_ThrowInt, wxT("Throw &int")), + 0, wxCENTRE | wxALL, 5); + sizerTop->Add(new wxButton(this, Except_ThrowObject, wxT("Throw &object")), 0, wxCENTRE | wxALL, 5); - sizerTop->Add(new wxButton(this, Except_ThrowObject, _T("Throw &object")), + sizerTop->Add(new wxButton(this, Except_Crash, wxT("&Crash")), 0, wxCENTRE | wxALL, 5); - sizerTop->Add(new wxButton(this, wxID_CANCEL, _T("&Cancel")), + sizerTop->Add(new wxButton(this, wxID_CANCEL, wxT("&Cancel")), 0, wxCENTRE | wxALL, 5); - SetSizer(sizerTop); - sizerTop->Fit(this); + SetSizerAndFit(sizerTop); } void MyDialog::OnThrowInt(wxCommandEvent& WXUNUSED(event)) @@ -316,6 +529,11 @@ void MyDialog::OnThrowInt(wxCommandEvent& WXUNUSED(event)) void MyDialog::OnThrowObject(wxCommandEvent& WXUNUSED(event)) { - throw MyException(_T("Exception thrown from the dialog")); + throw MyException(wxT("Exception thrown from MyDialog")); +} + +void MyDialog::OnCrash(wxCommandEvent& WXUNUSED(event)) +{ + DoCrash(); }