include/wx/gtk/app.h

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