include/wx/gtk/app.h

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        app.h
   3 // Purpose:
   4 // Author:      Robert Roebling
   5 // Created:     01/02/97
   6 // Id:
   7 // Copyright:   (c) 1998 Robert Roebling, Julian Smart and Markus Holzem
   8 // Licence:     wxWindows licence
   9 /////////////////////////////////////////////////////////////////////////////
  10
  11 #ifndef __GTKAPPH__
  12 #define __GTKAPPH__
  13
  14 #ifdef __GNUG__
  15 #pragma interface
  16 #endif
  17
  18 #include "wx/window.h"
  19 #include "wx/frame.h"
  20
  21 //-----------------------------------------------------------------------------
  22 // classes
  23 //-----------------------------------------------------------------------------
  24
  25 class wxApp;
  26 class wxLog;
  27 class wxConfig; // it's not used #if !USE_WXCONFIG, but fwd decl doesn't harm
  28
  29 //-----------------------------------------------------------------------------
  30 // global data
  31 //-----------------------------------------------------------------------------
  32
  33 extern wxApp *wxTheApp;
  34
  35 //-----------------------------------------------------------------------------
  36 // global functions
  37 //-----------------------------------------------------------------------------
  38
  39 void wxExit(void);
  40 bool wxYield(void);
  41
  42 //-----------------------------------------------------------------------------
  43 // constants
  44 //-----------------------------------------------------------------------------
  45
  46 #define wxPRINT_WINDOWS         1
  47 #define wxPRINT_POSTSCRIPT      2
  48
  49 //-----------------------------------------------------------------------------
  50 // wxApp
  51 //-----------------------------------------------------------------------------
  52
  53 class wxApp: public wxEvtHandler
  54 {
  55   DECLARE_DYNAMIC_CLASS(wxApp)
  56
  57   public:
  58
  59     wxApp(void);
  60     ~wxApp(void);
  61
  62     static void SetInitializerFunction(wxAppInitializerFunction fn) { m_appInitFn = fn; }
  63     static wxAppInitializerFunction GetInitializerFunction(void) { return m_appInitFn; }
  64
  65     virtual bool OnInit(void);
  66     virtual bool OnInitGui(void);
  67     virtual int OnRun(void);
  68     virtual int OnExit(void);
  69
  70     wxWindow *GetTopWindow(void);
  71     void SetTopWindow( wxWindow *win );
  72     virtual int MainLoop(void);
  73     void ExitMainLoop(void);
  74     bool Initialized(void);
  75     virtual bool Pending(void);
  76     virtual void Dispatch(void);
  77
  78     inline void SetWantDebugOutput(bool flag) { m_wantDebugOutput = flag; }
  79     inline bool GetWantDebugOutput(void) { return m_wantDebugOutput; }
  80
  81     void OnIdle( wxIdleEvent &event );
  82     bool SendIdleEvents(void);
  83     bool SendIdleEvents( wxWindow* win );
  84
  85     inline wxString GetAppName(void) const {
  86       if (m_appName != "")
  87         return m_appName;
  88       else return m_className;
  89     }
  90     inline void SetAppName(const wxString& name) { m_appName = name; };
  91     inline wxString GetClassName(void) const { return m_className; }
  92     inline void SetClassName(const wxString& name) { m_className = name; }
  93
  94     inline void SetExitOnFrameDelete(bool flag) { m_exitOnFrameDelete = flag; }
  95     inline bool GetExitOnFrameDelete(void) const { return m_exitOnFrameDelete; }
  96
  97     void SetPrintMode(int WXUNUSED(mode) ) {};
  98     int GetPrintMode(void) const { return wxPRINT_POSTSCRIPT; };
  99
 100     // override this function to create default log target of arbitrary
 101     // user-defined classv (default implementation creates a wxLogGui object)
 102     virtual wxLog *CreateLogTarget();
 103
 104 #if USE_WXCONFIG
 105     // override this function to create a global wxConfig object of different
 106     // than default type (right now the default implementation returns NULL)
 107     virtual wxConfig *CreateConfig() { return NULL; }
 108 #endif
 109
 110   // GTK implementation
 111
 112     static void CommonInit(void);
 113     static void CommonCleanUp(void);
 114
 115     bool ProcessIdle(void);
 116     void DeletePendingObjects(void);
 117
 118     bool          m_initialized;
 119     bool          m_exitOnFrameDelete;
 120     bool          m_wantDebugOutput;
 121     wxWindow     *m_topWindow;
 122     wxString      m_appName;
 123     wxString      m_className;
 124
 125     gint          m_idleTag;
 126
 127     int         argc;
 128     char      **argv;
 129
 130     static wxAppInitializerFunction m_appInitFn;
 131
 132   DECLARE_EVENT_TABLE()
 133 };
 134
 135 #endif // __GTKAPPH__