]> git.saurik.com Git - wxWidgets.git/blob - include/wx/x11/app.h
added and documented wxDEFINE_SCOPED_PTR_TYPE; improved docs a bit
[wxWidgets.git] / 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(NO_GCC_PRAGMA)
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 void WakeUpIdle();
63
64 virtual bool OnInitGui();
65
66 // implementation from now on
67 // --------------------------
68
69 // Processes an X event.
70 virtual bool ProcessXEvent(WXEvent* event);
71
72 #ifdef __WXDEBUG__
73 virtual void OnAssert(const wxChar *file, int line, const wxChar* cond, const wxChar *msg);
74 #endif // __WXDEBUG__
75
76 protected:
77 bool m_showOnInit;
78
79 public:
80 // Implementation
81 virtual bool Initialize(int& argc, wxChar **argv);
82 virtual void CleanUp();
83
84 WXWindow GetTopLevelWidget() const { return m_topLevelWidget; }
85 WXColormap GetMainColormap(WXDisplay* display);
86 long GetMaxRequestSize() const { return m_maxRequestSize; }
87
88 // This handler is called when a property change event occurs
89 virtual bool HandlePropertyChange(WXEvent *event);
90
91 // Values that can be passed on the command line.
92 // Returns -1, -1 if none specified.
93 const wxSize& GetInitialSize() const { return m_initialSize; }
94 bool GetShowIconic() const { return m_showIconic; }
95
96 #if wxUSE_UNICODE
97 // Global context for Pango layout. Either use X11
98 // or use Xft rendering according to GDK_USE_XFT
99 // environment variable
100 PangoContext* GetPangoContext();
101 #endif
102
103 wxXVisualInfo* GetVisualInfo(WXDisplay* display)
104 {
105 // this should be implemented correctly for wxBitmap to work
106 // with multiple display
107 return m_visualInfo;
108 }
109
110 // We need this before creating the app
111 static WXDisplay* GetDisplay() { return ms_display; }
112 static WXDisplay* ms_display;
113
114 public:
115 static long sm_lastMessageTime;
116 bool m_showIconic;
117 wxSize m_initialSize;
118
119 #if !wxUSE_NANOX
120 wxXVisualInfo* m_visualInfo;
121 #endif
122
123 protected:
124 bool m_keepGoing;
125
126 WXWindow m_topLevelWidget;
127 WXColormap m_mainColormap;
128 long m_maxRequestSize;
129 wxEventLoop* m_mainLoop;
130
131 DECLARE_EVENT_TABLE()
132 };
133
134 #endif // _WX_APP_H_
135