X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/e0a4791892c3eeed89033e42b11fc271fc9591b3..7442b5ee7ad7cff7aa817c46e4bc94754d91650e:/docs/doxygen/overviews/app.h?ds=sidebyside
diff --git a/docs/doxygen/overviews/app.h b/docs/doxygen/overviews/app.h
index c6a321a662..a100c118f7 100644
--- a/docs/doxygen/overviews/app.h
+++ b/docs/doxygen/overviews/app.h
@@ -10,9 +10,17 @@
@page overview_app wxApp overview
- Classes: #wxApp
+ Classes: wxApp
+
+
+ @li @ref overview_app_shutdown
+
+
+
+
+
A wxWidgets application does not have a @e main procedure; the equivalent is the
- #OnInit member defined for a class derived from wxApp.
+ wxApp::OnInit member defined for a class derived from wxApp.
@e OnInit will usually create a top window as a bare minimum.
Unlike in earlier versions of wxWidgets, OnInit does not return a frame. Instead it
@@ -26,10 +34,10 @@
be destroyed for the application to exit, it is advisable to use parent
frames wherever possible when creating new frames, so that deleting the
top level frame will automatically delete child frames. The alternative
- is to explicitly delete child frames in the top-level frame's #wxCloseEvent
+ is to explicitly delete child frames in the top-level frame's wxCloseEvent
handler.
- In emergencies the #wxExit function can be called to kill the
+ In emergencies the wxExit function can be called to kill the
application however normally the application shuts down automatically,
see @ref overview_app_shutdown.
@@ -71,16 +79,16 @@
The application normally shuts down when the last of its top level windows is
closed. This is normally the expected behaviour and means that it is enough to
- call #Close() in response to the @c "Exit" menu command if your program has a single
- top level window. If this behaviour is not desirable wxApp::SetExitOnFrameDelete can
- be called to change it.
+ call wxWindow::Close() in response to the @c "Exit" menu command if your program has a
+ single top level window. If this behaviour is not desirable wxApp::SetExitOnFrameDelete
+ can be called to change it.
- Note that starting from wxWidgets 2.3.3 such logic doesn't apply for the windows shown
- before the program enters the main loop: in other words, you can safely show a dialog from
- wxApp::OnInit and not be afraid that your application terminates when this dialog --
- which is the last top level window for the moment -- is closed.
+ Note that such logic doesn't apply for the windows shown before the program enters the
+ main loop: in other words, you can safely show a dialog from wxApp::OnInit and not be
+ afraid that your application terminates when this dialog -- which is the last top level
+ window for the moment -- is closed.
- Another aspect of the application shutdown is #OnExit
+ Another aspect of the application shutdown is wxApp::OnExit
which is called when the application exits but @e before wxWidgets cleans up
its internal structures. You should delete all wxWidgets object that you
created by the time OnExit finishes.