wxApp: wxObject

The wxApp class represents the application itself. A wxWindows application does not have a main procedure; the equivalent is the OnInit member defined for a class derived from wxApp. OnInit must create and return a main window frame as a bare minimum. If NULL is returned from OnInit, the application will exit. Note that the program's command line arguments, represented by argc and argv, are available from within wxApp member functions.

An application closes by destroying all windows. Because all frames must 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 OnClose handler. See wxFrame::OnClose.

In emergencies the wxExit function can be called to kill the application (see wxExit).

An example of defining an application follows:

class DerivedApp: public wxApp
{
 public:
  wxFrame *OnInit(void);
};

wxFrame *DerivedApp::OnInit(void)
{
  wxFrame *the_frame = new wxFrame(NULL, argv[0]);
  ...
  return the_frame;
}

MyApp DerivedApp;
wxApp::wxApp

wxApp::~wxApp

wxApp::argc

wxApp::argv

wxApp::wx_class

wxApp::Initialized

wxApp::MainLoop

wxApp::OnExit

wxApp::OnInit