\section{wxWidgets Hello World sample}\label{helloworld}As many people have requested a mini-sample to be published hereso that some quick judgment concerning syntaxand basic principles can be made, you can now look at wxWidgets'"Hello World":You have to include wxWidgets' header files, of course. This canbe done on a file by file basis (such as \#include "wx/window.h")or using one global include (\#include "wx/wx.h"). This isalso useful on platforms which support precompiled headers suchas all major compilers on the Windows platform.\begin{verbatim}//// file name: hworld.cpp////   purpose: wxWidgets "Hello world"//// For compilers that support precompilation, includes "wx/wx.h".#include "wx/wxprec.h"#ifdef __BORLANDC__    #pragma hdrstop#endif#ifndef WX_PRECOMP    #include "wx/wx.h"#endif\end{verbatim}Practically every app should define a new class derived from wxApp.By overriding wxApp's OnInit() the program can be initialized,e.g. by creating a new main window. \begin{verbatim}class MyApp: public wxApp{    virtual bool OnInit();};\end{verbatim}The main window is created by deriving a class from wxFrame and giving it a menu and a status bar in its constructor. Also, any classthat wishes to respond to any "event" (such as mouse clicks ormessages from the menu or a button) must declare an event table using the macro below. Finally, the way to react to such events must be done in "handlers". In our sample, we react to two menu items, one for "Quit" and one for displaying an "About" window. Thesehandlers should not be virtual.\begin{verbatim}class MyFrame: public wxFrame{public:    MyFrame(const wxString& title, const wxPoint& pos, const wxSize& size);    void OnQuit(wxCommandEvent& event);    void OnAbout(wxCommandEvent& event);private:    DECLARE_EVENT_TABLE()};\end{verbatim}In order to be able to react to a menu command, it must be given a uniqueidentifier such as a const or an enum.\begin{verbatim}enum{    ID_Quit = 1,    ID_About,};\end{verbatim}We then proceed to actually implement an event table in which the eventsare routed to their respective handler functions in the class MyFrame.There are predefined macros for routing all common events, ranging fromthe selection of a list box entry to a resize event when a user resizesa window on the screen. If -1 is given as the ID, the given handler will beinvoked for any event of the specified type, so that you could add justone entry in the event table for all menu commands or all button commands etc.The origin of the event can still be distinguished in the event handler asthe (only) parameter in an event handler is a reference to a wxEvent object,which holds various information about the event (such as the ID of and apointer to the class, which emitted the event).\begin{verbatim}BEGIN_EVENT_TABLE(MyFrame, wxFrame)    EVT_MENU(ID_Quit,  MyFrame::OnQuit)    EVT_MENU(ID_About, MyFrame::OnAbout)END_EVENT_TABLE()\end{verbatim}As in all programs there must be a "main" function. Under wxWidgets main is implementedusing this macro, which creates an application instance and starts the program.\begin{verbatim}IMPLEMENT_APP(MyApp)\end{verbatim}As mentioned above, wxApp::OnInit() is called upon startup and should beused to initialize the program, maybe showing a "splash screen" and creatingthe main window (or several). The frame should get a title bar text ("Hello World")and a position and start-up size. One frame can also be declared to be thetop window. Returning true indicates a successful initialization.\begin{verbatim}bool MyApp::OnInit(){    MyFrame *frame = new MyFrame( "Hello World", wxPoint(50,50), wxSize(450,340) );    frame->Show( true );    SetTopWindow( frame );    return true;}\end{verbatim}In the constructor of the main window (or later on) we create a menu with two menu items as well as a status bar to be shown at the bottom of the main window. Both have to be "announced" to the frame with respective calls.\begin{verbatim}MyFrame::MyFrame(const wxString& title, const wxPoint& pos, const wxSize& size)       : wxFrame((wxFrame *)NULL, -1, title, pos, size){    wxMenu *menuFile = new wxMenu;    menuFile->Append( ID_About, "&About..." );    menuFile->AppendSeparator();    menuFile->Append( ID_Quit, "E&xit" );    wxMenuBar *menuBar = new wxMenuBar;    menuBar->Append( menuFile, "&File" );    SetMenuBar( menuBar );    CreateStatusBar();    SetStatusText( "Welcome to wxWidgets!" );}\end{verbatim}Here are the actual event handlers. MyFrame::OnQuit() closes the main windowby calling Close(). The parameter true indicates that other windows have no vetopower such as after asking "Do you really want to close?". If there is no other main window left, the application will quit.\begin{verbatim}void MyFrame::OnQuit(wxCommandEvent& WXUNUSED(event)){    Close( true );}\end{verbatim}MyFrame::OnAbout() will display a small window with some text in it. In thiscase a typical "About" window with information about the program.\begin{verbatim}void MyFrame::OnAbout(wxCommandEvent& WXUNUSED(event)){    wxMessageBox( "This is a wxWidgets' Hello world sample",                  "About Hello World", wxOK | wxICON_INFORMATION );}\end{verbatim}