1 /////////////////////////////////////////////////////////////////////////////
2 // Name: samples/except/except.cpp
3 // Purpose: shows how C++ exceptions can be used in wxWidgets
4 // Author: Vadim Zeitlin
8 // Copyright: (c) 2003-2005 Vadim Zeitlin
9 // Licence: wxWindows licence
10 /////////////////////////////////////////////////////////////////////////////
12 // ============================================================================
14 // ============================================================================
16 // ----------------------------------------------------------------------------
18 // ----------------------------------------------------------------------------
20 // For compilers that support precompilation, includes "wx/wx.h".
21 #include "wx/wxprec.h"
28 #error "This sample only works with wxUSE_EXCEPTIONS == 1"
29 #endif // !wxUSE_EXCEPTIONS
31 // for all others, include the necessary headers (this file is usually all you
32 // need because it includes almost all "standard" wxWidgets headers)
38 #include "wx/dialog.h"
41 #include "wx/button.h"
45 #include "wx/msgdlg.h"
49 // ----------------------------------------------------------------------------
51 // ----------------------------------------------------------------------------
53 // the application icon (under Windows and OS/2 it is in resources)
54 #if defined(__WXGTK__) || defined(__WXMOTIF__) || defined(__WXMAC__) || defined(__WXMGL__) || defined(__WXX11__)
55 #include "../sample.xpm"
58 // ----------------------------------------------------------------------------
60 // ----------------------------------------------------------------------------
65 strcpy(p
, "Let's crash");
68 // ----------------------------------------------------------------------------
70 // ----------------------------------------------------------------------------
72 // Define a new application type, each program should derive a class from wxApp
73 class MyApp
: public wxApp
76 // override base class virtuals
77 // ----------------------------
80 virtual bool OnInit();
82 // 2nd-level exception handling: we get all the exceptions occurring in any
84 virtual bool OnExceptionInMainLoop();
86 // 3rd, and final, level exception handling: whenever an unhandled
87 // exception is caught, this function is called
88 virtual void OnUnhandledException();
90 // and now for something different: this function is called in case of a
91 // crash (e.g. dereferencing null pointer, division by 0, ...)
92 virtual void OnFatalException();
94 // you can override this function to do something different (e.g. log the
95 // assert to file) whenever an assertion fails
96 virtual void OnAssertFailure(const wxChar
*file
,
103 // Define a new frame type: this is going to be our main frame
104 class MyFrame
: public wxFrame
110 // event handlers (these functions should _not_ be virtual)
111 void OnQuit(wxCommandEvent
& event
);
112 void OnAbout(wxCommandEvent
& event
);
113 void OnDialog(wxCommandEvent
& event
);
115 void OnThrowInt(wxCommandEvent
& event
);
116 void OnThrowString(wxCommandEvent
& event
);
117 void OnThrowObject(wxCommandEvent
& event
);
118 void OnThrowUnhandled(wxCommandEvent
& event
);
120 void OnCrash(wxCommandEvent
& event
);
121 #if wxUSE_ON_FATAL_EXCEPTION
122 void OnHandleCrash(wxCommandEvent
& event
);
127 // 1st-level exception handling: we overload ProcessEvent() to be able to
128 // catch exceptions which occur in MyFrame methods here
129 virtual bool ProcessEvent(wxEvent
& event
);
131 // show how an assert failure message box looks like
132 void OnShowAssert(wxCommandEvent
& event
);
135 // any class wishing to process wxWidgets events must use this macro
136 DECLARE_EVENT_TABLE()
139 // A simple dialog which has only some buttons to throw exceptions
140 class MyDialog
: public wxDialog
143 MyDialog(wxFrame
*parent
);
146 void OnThrowInt(wxCommandEvent
& event
);
147 void OnThrowObject(wxCommandEvent
& event
);
148 void OnCrash(wxCommandEvent
& event
);
151 DECLARE_EVENT_TABLE()
154 // A trivial exception class
158 MyException(const wxString
& msg
) : m_msg(msg
) { }
160 const wxChar
*what() const { return m_msg
.c_str(); }
166 // Another exception class which just has to be different from anything else
167 class UnhandledException
171 // ----------------------------------------------------------------------------
173 // ----------------------------------------------------------------------------
175 // IDs for the controls and the menu commands
178 // control ids and menu items
179 Except_ThrowInt
= wxID_HIGHEST
,
182 Except_ThrowUnhandled
,
184 #if wxUSE_ON_FATAL_EXCEPTION
186 #endif // wxUSE_ON_FATAL_EXCEPTION
190 Except_Quit
= wxID_EXIT
,
191 Except_About
= wxID_ABOUT
194 // ----------------------------------------------------------------------------
195 // event tables and other macros for wxWidgets
196 // ----------------------------------------------------------------------------
198 // the event tables connect the wxWidgets events with the functions (event
199 // handlers) which process them. It can be also done at run-time, but for the
200 // simple menu events like this the static method is much simpler.
201 BEGIN_EVENT_TABLE(MyFrame
, wxFrame
)
202 EVT_MENU(Except_Quit
, MyFrame
::OnQuit
)
203 EVT_MENU(Except_About
, MyFrame
::OnAbout
)
204 EVT_MENU(Except_Dialog
, MyFrame
::OnDialog
)
205 EVT_MENU(Except_ThrowInt
, MyFrame
::OnThrowInt
)
206 EVT_MENU(Except_ThrowString
, MyFrame
::OnThrowString
)
207 EVT_MENU(Except_ThrowObject
, MyFrame
::OnThrowObject
)
208 EVT_MENU(Except_ThrowUnhandled
, MyFrame
::OnThrowUnhandled
)
209 EVT_MENU(Except_Crash
, MyFrame
::OnCrash
)
210 #if wxUSE_ON_FATAL_EXCEPTION
211 EVT_MENU(Except_HandleCrash
, MyFrame
::OnHandleCrash
)
212 #endif // wxUSE_ON_FATAL_EXCEPTION
213 EVT_MENU(Except_ShowAssert
, MyFrame
::OnShowAssert
)
216 BEGIN_EVENT_TABLE(MyDialog
, wxDialog
)
217 EVT_BUTTON(Except_ThrowInt
, MyDialog
::OnThrowInt
)
218 EVT_BUTTON(Except_ThrowObject
, MyDialog
::OnThrowObject
)
219 EVT_BUTTON(Except_Crash
, MyDialog
::OnCrash
)
222 // Create a new application object: this macro will allow wxWidgets to create
223 // the application object during program execution (it's better than using a
224 // static object for many reasons) and also implements the accessor function
225 // wxGetApp() which will return the reference of the right type (i.e. MyApp and
229 // ============================================================================
230 // MyApp implementation
231 // ============================================================================
233 // 'Main program' equivalent: the program execution "starts" here
236 if ( !wxApp
::OnInit() )
239 // create the main application window
240 MyFrame
*frame
= new MyFrame();
242 // and show it (the frames, unlike simple controls, are not shown when
243 // created initially)
246 // success: wxApp::OnRun() will be called which will enter the main message
247 // loop and the application will run. If we returned false here, the
248 // application would exit immediately.
252 bool MyApp
::OnExceptionInMainLoop()
260 wxLogWarning(wxT("Caught an int %d in MyApp."), i
);
262 catch ( MyException
& e
)
264 wxLogWarning(wxT("Caught MyException(%s) in MyApp."), e
.what());
274 void MyApp
::OnUnhandledException()
276 // this shows how we may let some exception propagate uncaught
281 catch ( UnhandledException
& )
287 wxMessageBox(wxT("Unhandled exception caught, program will terminate."),
288 wxT("wxExcept Sample"), wxOK
| wxICON_ERROR
);
292 void MyApp
::OnFatalException()
294 wxMessageBox(wxT("Program has crashed and will terminate."),
295 wxT("wxExcept Sample"), wxOK
| wxICON_ERROR
);
298 void MyApp
::OnAssertFailure(const wxChar
*file
,
306 wxString
::Format("An assert failed in %s().", func
) +
308 "Do you want to call the default assert handler?",
310 wxYES_NO
| wxICON_QUESTION
313 wxApp
::OnAssertFailure(file
, line
, func
, cond
, msg
);
317 // ============================================================================
318 // MyFrame implementation
319 // ============================================================================
323 : wxFrame(NULL
, wxID_ANY
, wxT("Except wxWidgets App"),
324 wxPoint(50, 50), wxSize(450, 340))
326 // set the frame icon
327 SetIcon(wxICON(sample
));
331 wxMenu
*menuFile
= new wxMenu
;
332 menuFile
->Append(Except_Dialog
, wxT("Show &dialog\tCtrl-D"));
333 menuFile
->AppendSeparator();
334 menuFile
->Append(Except_ThrowInt
, wxT("Throw an &int\tCtrl-I"));
335 menuFile
->Append(Except_ThrowString
, wxT("Throw a &string\tCtrl-S"));
336 menuFile
->Append(Except_ThrowObject
, wxT("Throw an &object\tCtrl-O"));
337 menuFile
->Append(Except_ThrowUnhandled
,
338 wxT("Throw &unhandled exception\tCtrl-U"));
339 menuFile
->Append(Except_Crash
, wxT("&Crash\tCtrl-C"));
340 menuFile
->AppendSeparator();
341 #if wxUSE_ON_FATAL_EXCEPTION
342 menuFile
->AppendCheckItem(Except_HandleCrash
, wxT("&Handle crashes\tCtrl-H"));
343 menuFile
->AppendSeparator();
344 #endif // wxUSE_ON_FATAL_EXCEPTION
345 menuFile
->Append(Except_ShowAssert
, wxT("Provoke &assert failure\tCtrl-A"));
346 menuFile
->AppendSeparator();
347 menuFile
->Append(Except_Quit
, wxT("E&xit\tCtrl-Q"), wxT("Quit this program"));
349 wxMenu
*helpMenu
= new wxMenu
;
350 helpMenu
->Append(Except_About
, wxT("&About...\tF1"), wxT("Show about dialog"));
352 // now append the freshly created menu to the menu bar...
353 wxMenuBar
*menuBar
= new wxMenuBar();
354 menuBar
->Append(menuFile
, wxT("&File"));
355 menuBar
->Append(helpMenu
, wxT("&Help"));
357 // ... and attach this menu bar to the frame
359 #endif // wxUSE_MENUS
361 #if wxUSE_STATUSBAR && !defined(__WXWINCE__)
362 // create a status bar just for fun (by default with 1 pane only)
364 SetStatusText(wxT("Welcome to wxWidgets!"));
365 #endif // wxUSE_STATUSBAR
368 bool MyFrame
::ProcessEvent(wxEvent
& event
)
372 return wxFrame
::ProcessEvent(event
);
374 catch ( const wxChar
*msg
)
376 wxLogMessage(wxT("Caught a string \"%s\" in MyFrame"), msg
);
382 void MyFrame
::OnQuit(wxCommandEvent
& WXUNUSED(event
))
384 // true is to force the frame to close
388 void MyFrame
::OnDialog(wxCommandEvent
& WXUNUSED(event
))
398 wxLogWarning(wxT("An exception in MyDialog"));
405 void MyFrame
::OnThrowInt(wxCommandEvent
& WXUNUSED(event
))
410 void MyFrame
::OnThrowString(wxCommandEvent
& WXUNUSED(event
))
412 throw wxT("string thrown from MyFrame");
415 void MyFrame
::OnThrowObject(wxCommandEvent
& WXUNUSED(event
))
417 throw MyException(wxT("Exception thrown from MyFrame"));
420 void MyFrame
::OnThrowUnhandled(wxCommandEvent
& WXUNUSED(event
))
422 throw UnhandledException();
425 void MyFrame
::OnCrash(wxCommandEvent
& WXUNUSED(event
))
430 #if wxUSE_ON_FATAL_EXCEPTION
432 void MyFrame
::OnHandleCrash(wxCommandEvent
& event
)
434 wxHandleFatalExceptions(event
.IsChecked());
437 #endif // wxUSE_ON_FATAL_EXCEPTION
439 void MyFrame
::OnShowAssert(wxCommandEvent
& WXUNUSED(event
))
441 // provoke an assert from wxArrayString
446 void MyFrame
::OnAbout(wxCommandEvent
& WXUNUSED(event
))
449 msg
.Printf( wxT("This is the About dialog of the except sample.\n")
450 wxT("Welcome to %s"), wxVERSION_STRING
);
452 wxMessageBox(msg
, wxT("About Except"), wxOK
| wxICON_INFORMATION
, this);
455 // ============================================================================
456 // MyDialog implementation
457 // ============================================================================
459 MyDialog
::MyDialog(wxFrame
*parent
)
460 : wxDialog(parent
, wxID_ANY
, wxString(wxT("Throw exception dialog")))
462 wxSizer
*sizerTop
= new wxBoxSizer(wxVERTICAL
);
464 sizerTop
->Add(new wxButton(this, Except_ThrowInt
, wxT("Throw &int")),
465 0, wxCENTRE
| wxALL
, 5);
466 sizerTop
->Add(new wxButton(this, Except_ThrowObject
, wxT("Throw &object")),
467 0, wxCENTRE
| wxALL
, 5);
468 sizerTop
->Add(new wxButton(this, Except_Crash
, wxT("&Crash")),
469 0, wxCENTRE
| wxALL
, 5);
470 sizerTop
->Add(new wxButton(this, wxID_CANCEL
, wxT("&Cancel")),
471 0, wxCENTRE
| wxALL
, 5);
473 SetSizerAndFit(sizerTop
);
476 void MyDialog
::OnThrowInt(wxCommandEvent
& WXUNUSED(event
))
481 void MyDialog
::OnThrowObject(wxCommandEvent
& WXUNUSED(event
))
483 throw MyException(wxT("Exception thrown from MyDialog"));
486 void MyDialog
::OnCrash(wxCommandEvent
& WXUNUSED(event
))