include/wx/x11/app.h

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        app.h
   3 // Purpose:     wxApp class
   4 // Author:      Julian Smart
   5 // Modified by:
   6 // Created:     17/09/98
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) Julian Smart
   9 // Licence:     wxWindows licence
  10 /////////////////////////////////////////////////////////////////////////////
  11
  12 #ifndef _WX_APP_H_
  13 #define _WX_APP_H_
  14
  15 #if defined(__GNUG__) && !defined(__APPLE__)
  16 #pragma interface "app.h"
  17 #endif
  18
  19 // ----------------------------------------------------------------------------
  20 // headers
  21 // ----------------------------------------------------------------------------
  22
  23 #include "wx/gdicmn.h"
  24 #include "wx/event.h"
  25
  26 // ----------------------------------------------------------------------------
  27 // forward declarations
  28 // ----------------------------------------------------------------------------
  29
  30 class WXDLLEXPORT wxFrame;
  31 class WXDLLEXPORT wxWindow;
  32 class WXDLLEXPORT wxApp;
  33 class WXDLLEXPORT wxKeyEvent;
  34 class WXDLLEXPORT wxLog;
  35 class WXDLLEXPORT wxEventLoop;
  36 class WXDLLEXPORT wxXVisualInfo;
  37
  38 // ----------------------------------------------------------------------------
  39 // the wxApp class for wxX11 - see wxAppBase for more details
  40 // ----------------------------------------------------------------------------
  41
  42 class WXDLLEXPORT wxApp : public wxAppBase
  43 {
  44     DECLARE_DYNAMIC_CLASS(wxApp)
  45
  46 public:
  47     wxApp();
  48     ~wxApp();
  49
  50     // override base class (pure) virtuals
  51     // -----------------------------------
  52
  53     virtual int MainLoop();
  54     virtual void ExitMainLoop();
  55     virtual bool Initialized();
  56     virtual bool Pending();
  57     virtual void Dispatch();
  58
  59     virtual void Exit();
  60
  61     virtual bool Yield(bool onlyIfNeeded = FALSE);
  62     virtual bool ProcessIdle();
  63     virtual void WakeUpIdle();
  64
  65     virtual bool OnInitGui();
  66
  67     // implementation from now on
  68     // --------------------------
  69
  70     void OnIdle(wxIdleEvent& event);
  71
  72     // Send idle event to all top-level windows.
  73     // Returns TRUE if more idle time is requested.
  74     bool SendIdleEvents();
  75
  76     // Send idle event to window and all subwindows
  77     // Returns TRUE if more idle time is requested.
  78     bool SendIdleEvents(wxWindow* win);
  79
  80     // Processes an X event.
  81     virtual bool ProcessXEvent(WXEvent* event);
  82
  83 #ifdef __WXDEBUG__
  84     virtual void OnAssert(const wxChar *file, int line, const wxChar* cond, const wxChar *msg);
  85 #endif // __WXDEBUG__
  86
  87 protected:
  88     bool                  m_showOnInit;
  89
  90 public:
  91     // Implementation
  92     static bool Initialize();
  93     static void CleanUp();
  94
  95     void DeletePendingObjects();
  96
  97     WXWindow       GetTopLevelWidget() const { return m_topLevelWidget; }
  98     WXColormap     GetMainColormap(WXDisplay* display);
  99     long           GetMaxRequestSize() const { return m_maxRequestSize; }
 100
 101     // This handler is called when a property change event occurs
 102     virtual bool HandlePropertyChange(WXEvent *event);
 103
 104     // Values that can be passed on the command line.
 105     // Returns -1, -1 if none specified.
 106     const wxSize& GetInitialSize() const { return m_initialSize; }
 107     bool GetShowIconic() const { return m_showIconic; }
 108
 109 #if wxUSE_UNICODE
 110     // Global context for Pango layout. Either use X11
 111     // or use Xft rendering according to GDK_USE_XFT
 112     // environment variable
 113     PangoContext* GetPangoContext();
 114 #endif
 115
 116     wxXVisualInfo* GetVisualInfo(WXDisplay* display)
 117     {
 118         // this should be implemented correctly for wxBitmap to work
 119         // with multiple display
 120         return m_visualInfo;
 121     }
 122
 123     // We need this before creating the app
 124     static   WXDisplay* GetDisplay() { return ms_display; }
 125     static   WXDisplay* ms_display;
 126
 127 public:
 128     static long           sm_lastMessageTime;
 129     bool                  m_showIconic;
 130     wxSize                m_initialSize;
 131
 132 #if !wxUSE_NANOX
 133     wxXVisualInfo*        m_visualInfo;
 134 #endif
 135
 136 protected:
 137     bool                  m_keepGoing;
 138
 139     WXWindow              m_topLevelWidget;
 140     WXColormap            m_mainColormap;
 141     long                  m_maxRequestSize;
 142     wxEventLoop*          m_mainLoop;
 143
 144     DECLARE_EVENT_TABLE()
 145 };
 146
 147 int WXDLLEXPORT wxEntry( int argc, char *argv[] );
 148
 149 #endif
 150 // _WX_APP_H_
 151