]> git.saurik.com Git - wxWidgets.git/blob - include/wx/frame.h
getting rid of wxBuffer
[wxWidgets.git] / include / wx / frame.h
1 /////////////////////////////////////////////////////////////////////////////
2 // Name: wx/frame.h
3 // Purpose: wxFrame class interface
4 // Author: Vadim Zeitlin
5 // Modified by:
6 // Created: 15.11.99
7 // RCS-ID: $Id$
8 // Copyright: (c) wxWindows team
9 // Licence: wxWindows license
10 /////////////////////////////////////////////////////////////////////////////
11
12 #ifndef _WX_FRAME_H_BASE_
13 #define _WX_FRAME_H_BASE_
14
15 // ----------------------------------------------------------------------------
16 // headers
17 // ----------------------------------------------------------------------------
18
19 #if defined(__GNUG__) && !defined(__APPLE__)
20 #pragma interface "framebase.h"
21 #endif
22
23 #include "wx/toplevel.h" // the base class
24
25 // the default names for various classs
26 WXDLLEXPORT_DATA(extern const wxChar*) wxFrameNameStr;
27 WXDLLEXPORT_DATA(extern const wxChar*) wxStatusLineNameStr;
28 WXDLLEXPORT_DATA(extern const wxChar*) wxToolBarNameStr;
29
30 class WXDLLEXPORT wxFrame;
31 class WXDLLEXPORT wxMenuBar;
32 class WXDLLEXPORT wxStatusBar;
33 class WXDLLEXPORT wxToolBar;
34
35 // ----------------------------------------------------------------------------
36 // wxFrame is a top-level window with optional menubar, statusbar and toolbar
37 //
38 // For each of *bars, a frame may have several of them, but only one is
39 // managed by the frame, i.e. resized/moved when the frame is and whose size
40 // is accounted for in client size calculations - all others should be taken
41 // care of manually. The CreateXXXBar() functions create this, main, XXXBar,
42 // but the actual creation is done in OnCreateXXXBar() functions which may be
43 // overridden to create custom objects instead of standard ones when
44 // CreateXXXBar() is called.
45 // ----------------------------------------------------------------------------
46
47 class WXDLLEXPORT wxFrameBase : public wxTopLevelWindow
48 {
49 public:
50 // construction
51 wxFrameBase();
52 virtual ~wxFrameBase();
53
54 wxFrame *New(wxWindow *parent,
55 wxWindowID id,
56 const wxString& title,
57 const wxPoint& pos = wxDefaultPosition,
58 const wxSize& size = wxDefaultSize,
59 long style = wxDEFAULT_FRAME_STYLE,
60 const wxString& name = wxFrameNameStr);
61
62 // frame state
63 // -----------
64
65 // get the origin of the client area (which may be different from (0, 0)
66 // if the frame has a toolbar) in client coordinates
67 virtual wxPoint GetClientAreaOrigin() const;
68
69 // sends a size event to the window using its current size -- this has an
70 // effect of refreshing the window layout
71 //
72 // currently it is only implemented under MSW but is declared here to make
73 // it possible to call it in portable code without using #ifdef's
74 virtual void SendSizeEvent() { }
75
76 // menu bar functions
77 // ------------------
78
79 #if wxUSE_MENUS
80 virtual void SetMenuBar(wxMenuBar *menubar);
81 virtual wxMenuBar *GetMenuBar() const { return m_frameMenuBar; }
82 #endif // wxUSE_MENUS
83
84 #ifdef WXWIN_COMPATIBILITY_2_2
85 // call this to simulate a menu command
86 bool Command(int id) { return ProcessCommand(id); }
87 #endif // WXWIN_COMPATIBILITY_2_2
88
89 // process menu command: returns TRUE if processed
90 bool ProcessCommand(int id);
91
92 // status bar functions
93 // --------------------
94 #if wxUSE_STATUSBAR
95 // create the main status bar by calling OnCreateStatusBar()
96 virtual wxStatusBar* CreateStatusBar(int number = 1,
97 long style = wxST_SIZEGRIP,
98 wxWindowID id = 0,
99 const wxString& name =
100 wxStatusLineNameStr);
101 // return a new status bar
102 virtual wxStatusBar *OnCreateStatusBar(int number,
103 long style,
104 wxWindowID id,
105 const wxString& name);
106 // get the main status bar
107 virtual wxStatusBar *GetStatusBar() const { return m_frameStatusBar; }
108
109 // sets the main status bar
110 void SetStatusBar(wxStatusBar *statBar) { m_frameStatusBar = statBar; }
111
112 // forward these to status bar
113 virtual void SetStatusText(const wxString &text, int number = 0);
114 virtual void SetStatusWidths(int n, const int widths_field[]);
115 void PushStatusText(const wxString &text, int number = 0);
116 void PopStatusText(int number = 0);
117
118 // set the status bar pane the help will be shown in
119 void SetStatusBarPane(int n) { m_statusBarPane = n; }
120 int GetStatusBarPane() const { return m_statusBarPane; }
121 #endif // wxUSE_STATUSBAR
122
123 // toolbar functions
124 // -----------------
125 #if wxUSE_TOOLBAR
126 // create main toolbar bycalling OnCreateToolBar()
127 virtual wxToolBar* CreateToolBar(long style = wxNO_BORDER|wxTB_HORIZONTAL,
128 wxWindowID id = -1,
129 const wxString& name = wxToolBarNameStr);
130 // return a new toolbar
131 virtual wxToolBar *OnCreateToolBar(long style,
132 wxWindowID id,
133 const wxString& name );
134
135 // get/set the main toolbar
136 virtual wxToolBar *GetToolBar() const { return m_frameToolBar; }
137 virtual void SetToolBar(wxToolBar *toolbar) { m_frameToolBar = toolbar; }
138 #endif // wxUSE_TOOLBAR
139
140 // implementation only from now on
141 // -------------------------------
142
143 // event handlers
144 void OnIdle(wxIdleEvent& event);
145 void OnMenuHighlight(wxMenuEvent& event);
146
147 #if wxUSE_MENUS
148 // send wxUpdateUIEvents for all menu items (called from OnIdle())
149 void DoMenuUpdates();
150 void DoMenuUpdates(wxMenu* menu, wxWindow* focusWin);
151 #endif // wxUSE_MENUS
152
153 // if there is no real wxTopLevelWindow on this platform we have to define
154 // some wxTopLevelWindowBase pure virtual functions here to avoid breaking
155 // old ports (wxMotif) which don't define them in wxFrame
156 #ifndef wxTopLevelWindowNative
157 virtual bool ShowFullScreen(bool WXUNUSED(show),
158 long WXUNUSED(style) = wxFULLSCREEN_ALL)
159 { return FALSE; }
160 virtual bool IsFullScreen() const
161 { return FALSE; }
162 #endif // no wxTopLevelWindowNative
163
164 // show help text (typically in the statusbar); show is FALSE
165 // if you are hiding the help, TRUE otherwise
166 virtual void DoGiveHelp(const wxString& text, bool show);
167
168 protected:
169 // the frame main menu/status/tool bars
170 // ------------------------------------
171
172 // this (non virtual!) function should be called from dtor to delete the
173 // main menubar, statusbar and toolbar (if any)
174 void DeleteAllBars();
175
176 // test whether this window makes part of the frame
177 virtual bool IsOneOfBars(const wxWindow *win) const;
178
179 #if wxUSE_MENUS
180 // override to update menu bar position when the frame size changes
181 virtual void PositionMenuBar() { }
182
183 // override to do something special when the menu bar is being removed
184 // from the frame
185 virtual void DetachMenuBar();
186
187 // override to do something special when the menu bar is attached to the
188 // frame
189 virtual void AttachMenuBar(wxMenuBar *menubar);
190
191 wxMenuBar *m_frameMenuBar;
192 #endif // wxUSE_MENUS
193
194 #if wxUSE_STATUSBAR
195 // override to update status bar position (or anything else) when
196 // something changes
197 virtual void PositionStatusBar() { }
198
199 // show the help string for this menu item in the given status bar: the
200 // status bar pointer can be NULL; return TRUE if help was shown
201 bool ShowMenuHelp(wxStatusBar *statbar, int id);
202
203 wxStatusBar *m_frameStatusBar;
204 #endif // wxUSE_STATUSBAR
205
206
207 int m_statusBarPane;
208
209 #if wxUSE_TOOLBAR
210 // override to update status bar position (or anything else) when
211 // something changes
212 virtual void PositionToolBar() { }
213
214 wxToolBar *m_frameToolBar;
215 #endif // wxUSE_TOOLBAR
216
217 DECLARE_EVENT_TABLE()
218 DECLARE_NO_COPY_CLASS(wxFrameBase)
219 };
220
221 // include the real class declaration
222 #if defined(__WXUNIVERSAL__) // && !defined(__WXMICROWIN__)
223 #include "wx/univ/frame.h"
224 #else // !__WXUNIVERSAL__
225 #if defined(__WXMSW__)
226 #include "wx/msw/frame.h"
227 #elif defined(__WXGTK__)
228 #include "wx/gtk/frame.h"
229 #elif defined(__WXMOTIF__)
230 #include "wx/motif/frame.h"
231 #elif defined(__WXMAC__)
232 #include "wx/mac/frame.h"
233 #elif defined(__WXPM__)
234 #include "wx/os2/frame.h"
235 #endif
236 #endif
237
238 #endif
239 // _WX_FRAME_H_BASE_