]> git.saurik.com Git - wxWidgets.git/blobdiff - samples/except/except.cpp
Adding wxUIActionSimulator, a class for programmatically controlling the mouse and...
[wxWidgets.git] / samples / except / except.cpp
index fe8740fc9bc14960dfb00d3a729a85bf6c83b8b0..7ea7b7b159844b8a5e059159f417fdf3822f72be 100644 (file)
@@ -43,6 +43,9 @@
 
     #include "wx/utils.h"
     #include "wx/msgdlg.h"
+    #include "wx/icon.h"
+
+    #include "wx/thread.h"
 #endif
 
 // ----------------------------------------------------------------------------
     #include "../sample.xpm"
 #endif
 
+// ----------------------------------------------------------------------------
+// private functions
+// ----------------------------------------------------------------------------
+
+static void DoCrash()
+{
+    char *p = 0;
+    strcpy(p, "Let's crash");
+}
+
 // ----------------------------------------------------------------------------
 // private classes
 // ----------------------------------------------------------------------------
@@ -68,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
@@ -84,19 +107,37 @@ 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 wxWidgets events must use this macro
     DECLARE_EVENT_TABLE()
@@ -129,6 +170,11 @@ private:
     wxString m_msg;
 };
 
+// Another exception class which just has to be different from anything else
+class UnhandledException
+{
+};
+
 // ----------------------------------------------------------------------------
 // constants
 // ----------------------------------------------------------------------------
@@ -136,13 +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,
+    Except_ThrowUnhandled,
     Except_Crash,
-
-    // menu items
-    Except_ThrowString = 200,
+#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,
@@ -160,7 +212,18 @@ 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)
@@ -183,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 wxWidgets 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)
@@ -197,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);
+    }
 }
 
 // ============================================================================
@@ -223,8 +335,9 @@ void MyApp::OnUnhandledException()
 // ============================================================================
 
 // frame constructor
-MyFrame::MyFrame(const wxString& title, const wxPoint& pos, const wxSize& size, long style)
-       : wxFrame(NULL, wxID_ANY, 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(sample));
@@ -232,18 +345,34 @@ MyFrame::MyFrame(const wxString& title, const wxPoint& pos, const wxSize& size,
 #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);
@@ -252,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 wxWidgets!"));
+    SetStatusText(wxT("Welcome to wxWidgets!"));
 #endif // wxUSE_STATUSBAR
 }
 
@@ -264,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;
     }
@@ -286,23 +415,90 @@ void MyFrame::OnDialog(wxCommandEvent& WXUNUSED(event))
     }
     catch ( ... )
     {
+        wxLogWarning(wxT("An exception in MyDialog"));
+
         Destroy();
         throw;
     }
 }
 
+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);
 }
 
 // ============================================================================
@@ -310,21 +506,20 @@ void MyFrame::OnAbout(wxCommandEvent& WXUNUSED(event))
 // ============================================================================
 
 MyDialog::MyDialog(wxFrame *parent)
-        : wxDialog(parent, wxID_ANY, 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, _T("Throw &object")),
+    sizerTop->Add(new wxButton(this, Except_ThrowObject, wxT("Throw &object")),
                   0, wxCENTRE | wxALL, 5);
-    sizerTop->Add(new wxButton(this, Except_Crash, _T("&Crash")),
+    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))
@@ -334,12 +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))
 {
-    char *p = 0;
-    strcpy(p, "Let's crash");
+    DoCrash();
 }