added a note about XRCID() and EVT_*_RANGE macros (see bug #11431)

[wxWidgets.git] / samples / except / except.cpp

diff --git a/samples/except/except.cpp b/samples/except/except.cpp
index 7d1c9991eb8f511af40d24194840243f28a0d6a4..ed04aec596c17f77cf6ba0d16772d628691edc38 100644 (file)
--- a/samples/except/except.cpp
+++ b/samples/except/except.cpp
@@ -79,7 +79,7 @@ public:
     // program startup
     virtual bool OnInit();
 
     // 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 bool OnExceptionInMainLoop();
 
     // event handler here
     virtual bool OnExceptionInMainLoop();
 


@@ -90,6 +90,15 @@ public:
     // 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();
     // 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();

+
+#ifdef __WXDEBUG__
+    // in debug mode, you can override this function to do something different
+    // (e.g. log the assert to file) whenever an assertion fails
+    virtual void OnAssert(const wxChar *file,
+                          int line,
+                          const wxChar *cond,
+                          const wxChar *msg);
+#endif // __WXDEBUG__

 };
 
 // Define a new frame type: this is going to be our main frame
 };
 
 // Define a new frame type: this is going to be our main frame


@@ -110,12 +119,21 @@ public:
     void OnThrowUnhandled(wxCommandEvent& event);
 
     void OnCrash(wxCommandEvent& event);
     void OnThrowUnhandled(wxCommandEvent& event);
 
     void OnCrash(wxCommandEvent& event);

+#if wxUSE_ON_FATAL_EXCEPTION

     void OnHandleCrash(wxCommandEvent& event);
     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);
 
 
     // 1st-level exception handling: we overload ProcessEvent() to be able to
     // catch exceptions which occur in MyFrame methods here
     virtual bool ProcessEvent(wxEvent& event);
 

+#ifdef __WXDEBUG__
+    // show how an assert failure message box looks like
+    void OnShowAssert(wxCommandEvent& event);
+#endif // __WXDEBUG__
+

 private:
     // any class wishing to process wxWidgets events must use this macro
     DECLARE_EVENT_TABLE()
 private:
     // any class wishing to process wxWidgets events must use this macro
     DECLARE_EVENT_TABLE()


@@ -161,12 +179,17 @@ class UnhandledException
 enum
 {
     // control ids and menu items
 enum
 {
     // control ids and menu items

-    Except_ThrowInt = 100,
+    Except_ThrowInt = wxID_HIGHEST,

     Except_ThrowString,
     Except_ThrowObject,
     Except_ThrowUnhandled,
     Except_Crash,
     Except_ThrowString,
     Except_ThrowObject,
     Except_ThrowUnhandled,
     Except_Crash,

+#if wxUSE_ON_FATAL_EXCEPTION

     Except_HandleCrash,
     Except_HandleCrash,

+#endif // wxUSE_ON_FATAL_EXCEPTION
+#ifdef __WXDEBUG__
+    Except_ShowAssert,
+#endif // __WXDEBUG__

     Except_Dialog,
 
     Except_Quit = wxID_EXIT,
     Except_Dialog,
 
     Except_Quit = wxID_EXIT,


@@ -189,7 +212,12 @@ BEGIN_EVENT_TABLE(MyFrame, wxFrame)
     EVT_MENU(Except_ThrowObject, MyFrame::OnThrowObject)
     EVT_MENU(Except_ThrowUnhandled, MyFrame::OnThrowUnhandled)
     EVT_MENU(Except_Crash, MyFrame::OnCrash)
     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)
     EVT_MENU(Except_HandleCrash, MyFrame::OnHandleCrash)

+#endif // wxUSE_ON_FATAL_EXCEPTION
+#ifdef __WXDEBUG__
+    EVT_MENU(Except_ShowAssert, MyFrame::OnShowAssert)
+#endif // __WXDEBUG__

 END_EVENT_TABLE()
 
 BEGIN_EVENT_TABLE(MyDialog, wxDialog)
 END_EVENT_TABLE()
 
 BEGIN_EVENT_TABLE(MyDialog, wxDialog)


@@ -212,6 +240,9 @@ IMPLEMENT_APP(MyApp)
 // 'Main program' equivalent: the program execution "starts" here
 bool MyApp::OnInit()
 {
 // '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();
 
     // create the main application window
     MyFrame *frame = new MyFrame();
 


@@ -233,11 +264,11 @@ bool MyApp::OnExceptionInMainLoop()
     }
     catch ( int i )
     {
     }
     catch ( int i )
     {

-        wxLogWarning(_T("Caught an int %d in MyApp."), i);
+        wxLogWarning(wxT("Caught an int %d in MyApp."), i);

     }
     catch ( MyException& e )
     {
     }
     catch ( MyException& e )
     {

-        wxLogWarning(_T("Caught MyException(%s) in MyApp."), e.what());
+        wxLogWarning(wxT("Caught MyException(%s) in MyApp."), e.what());

     }
     catch ( ... )
     {
     }
     catch ( ... )
     {


@@ -260,24 +291,37 @@ void MyApp::OnUnhandledException()
     }
     catch ( ... )
     {
     }
     catch ( ... )
     {

-        wxMessageBox(_T("Unhandled exception caught, program will terminate."),
-                     _T("wxExcept Sample"), wxOK | wxICON_ERROR);
+        wxMessageBox(wxT("Unhandled exception caught, program will terminate."),
+                     wxT("wxExcept Sample"), wxOK | wxICON_ERROR);

     }
 }
 
 void MyApp::OnFatalException()
 {
     }
 }
 
 void MyApp::OnFatalException()
 {

-    wxMessageBox(_T("Program has crashed and will terminate."),
-                 _T("wxExcept Sample"), wxOK | wxICON_ERROR);
+    wxMessageBox(wxT("Program has crashed and will terminate."),
+                 wxT("wxExcept Sample"), wxOK | wxICON_ERROR);
+}
+
+#ifdef __WXDEBUG__
+
+void MyApp::OnAssert(const wxChar *file,
+                     int line,
+                     const wxChar *cond,
+                     const wxChar *msg)
+{
+    // we don't have anything special to do here
+    wxApp::OnAssert(file, line, cond, msg);

 }
 
 }
 

+#endif // __WXDEBUG__
+

 // ============================================================================
 // MyFrame implementation
 // ============================================================================
 
 // frame constructor
 MyFrame::MyFrame()
 // ============================================================================
 // MyFrame implementation
 // ============================================================================
 
 // frame constructor
 MyFrame::MyFrame()

-       : wxFrame(NULL, wxID_ANY, _T("Except wxWidgets App"),
+       : wxFrame(NULL, wxID_ANY, wxT("Except wxWidgets App"),

                  wxPoint(50, 50), wxSize(450, 340))
 {
     // set the frame icon
                  wxPoint(50, 50), wxSize(450, 340))
 {
     // set the frame icon


@@ -286,26 +330,32 @@ MyFrame::MyFrame()
 #if wxUSE_MENUS
     // create a menu bar
     wxMenu *menuFile = new wxMenu;
 #if wxUSE_MENUS
     // create a menu bar
     wxMenu *menuFile = new wxMenu;

-    menuFile->Append(Except_Dialog, _T("Show &dialog\tCtrl-D"));
+    menuFile->Append(Except_Dialog, wxT("Show &dialog\tCtrl-D"));

     menuFile->AppendSeparator();
     menuFile->AppendSeparator();

-    menuFile->Append(Except_ThrowInt, _T("Throw an &int\tCtrl-I"));
-    menuFile->Append(Except_ThrowString, _T("Throw a &string\tCtrl-S"));
-    menuFile->Append(Except_ThrowObject, _T("Throw an &object\tCtrl-O"));
+    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,
     menuFile->Append(Except_ThrowUnhandled,

-                        _T("Throw &unhandled exception\tCtrl-U"));
-    menuFile->Append(Except_Crash, _T("&Crash\tCtrl-C"));
+                        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->AppendSeparator();

-    menuFile->AppendCheckItem(Except_HandleCrash, _T("&Handle crashes\tCtrl-H"));
+#endif // wxUSE_ON_FATAL_EXCEPTION
+#ifdef __WXDEBUG__
+    menuFile->Append(Except_ShowAssert, wxT("Provoke &assert failure\tCtrl-A"));

     menuFile->AppendSeparator();
     menuFile->AppendSeparator();

-    menuFile->Append(Except_Quit, _T("E&xit\tCtrl-Q"), _T("Quit this program"));
+#endif // __WXDEBUG__
+    menuFile->Append(Except_Quit, wxT("E&xit\tCtrl-Q"), wxT("Quit this program"));

 
     wxMenu *helpMenu = new wxMenu;
 
     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();
 
     // 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);
 
     // ... and attach this menu bar to the frame
     SetMenuBar(menuBar);


@@ -314,7 +364,7 @@ MyFrame::MyFrame()
 #if wxUSE_STATUSBAR && !defined(__WXWINCE__)
     // create a status bar just for fun (by default with 1 pane only)
     CreateStatusBar(2);
 #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
 }
 
 #endif // wxUSE_STATUSBAR
 }
 


@@ -326,7 +376,7 @@ bool MyFrame::ProcessEvent(wxEvent& event)
     }
     catch ( const wxChar *msg )
     {
     }
     catch ( const wxChar *msg )
     {

-        wxLogMessage(_T("Caught a string \"%s\" in MyFrame"), msg);
+        wxLogMessage(wxT("Caught a string \"%s\" in MyFrame"), msg);

 
         return true;
     }
 
         return true;
     }


@@ -348,7 +398,7 @@ void MyFrame::OnDialog(wxCommandEvent& WXUNUSED(event))
     }
     catch ( ... )
     {
     }
     catch ( ... )
     {

-        wxLogWarning(_T("An exception in MyDialog"));
+        wxLogWarning(wxT("An exception in MyDialog"));

 
         Destroy();
         throw;
 
         Destroy();
         throw;


@@ -362,12 +412,12 @@ void MyFrame::OnThrowInt(wxCommandEvent& WXUNUSED(event))
 
 void MyFrame::OnThrowString(wxCommandEvent& WXUNUSED(event))
 {
 
 void MyFrame::OnThrowString(wxCommandEvent& WXUNUSED(event))
 {

-    throw _T("string thrown from MyFrame");
+    throw wxT("string thrown from MyFrame");

 }
 
 void MyFrame::OnThrowObject(wxCommandEvent& WXUNUSED(event))
 {
 }
 
 void MyFrame::OnThrowObject(wxCommandEvent& WXUNUSED(event))
 {

-    throw MyException(_T("Exception thrown from MyFrame"));
+    throw MyException(wxT("Exception thrown from MyFrame"));

 }
 
 void MyFrame::OnThrowUnhandled(wxCommandEvent& WXUNUSED(event))
 }
 
 void MyFrame::OnThrowUnhandled(wxCommandEvent& WXUNUSED(event))


@@ -380,18 +430,33 @@ void MyFrame::OnCrash(wxCommandEvent& WXUNUSED(event))
     DoCrash();
 }
 
     DoCrash();
 }
 

+#if wxUSE_ON_FATAL_EXCEPTION
+

 void MyFrame::OnHandleCrash(wxCommandEvent& event)
 {
     wxHandleFatalExceptions(event.IsChecked());
 }
 
 void MyFrame::OnHandleCrash(wxCommandEvent& event)
 {
     wxHandleFatalExceptions(event.IsChecked());
 }
 

+#endif // wxUSE_ON_FATAL_EXCEPTION
+
+#ifdef __WXDEBUG__
+
+void MyFrame::OnShowAssert(wxCommandEvent& WXUNUSED(event))
+{
+    // provoke an assert from wxArrayString
+    wxArrayString arr;
+    arr[0];
+}
+
+#endif // __WXDEBUG__
+

 void MyFrame::OnAbout(wxCommandEvent& WXUNUSED(event))
 {
     wxString msg;
 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);

 }
 
 // ============================================================================
 }
 
 // ============================================================================


@@ -399,21 +464,20 @@ void MyFrame::OnAbout(wxCommandEvent& WXUNUSED(event))
 // ============================================================================
 
 MyDialog::MyDialog(wxFrame *parent)
 // ============================================================================
 
 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);
 
 {
     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);
                   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);
                   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);
                   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);
 
                   0, wxCENTRE | wxALL, 5);
 

-    SetSizer(sizerTop);
-    sizerTop->Fit(this);
+    SetSizerAndFit(sizerTop);

 }
 
 void MyDialog::OnThrowInt(wxCommandEvent& WXUNUSED(event))
 }
 
 void MyDialog::OnThrowInt(wxCommandEvent& WXUNUSED(event))


@@ -423,7 +487,7 @@ void MyDialog::OnThrowInt(wxCommandEvent& WXUNUSED(event))
 
 void MyDialog::OnThrowObject(wxCommandEvent& WXUNUSED(event))
 {
 
 void MyDialog::OnThrowObject(wxCommandEvent& WXUNUSED(event))
 {

-    throw MyException(_T("Exception thrown from MyDialog"));
+    throw MyException(wxT("Exception thrown from MyDialog"));

 }
 
 void MyDialog::OnCrash(wxCommandEvent& WXUNUSED(event))
 }
 
 void MyDialog::OnCrash(wxCommandEvent& WXUNUSED(event))