]> git.saurik.com Git - wxWidgets.git/blob - src/common/toplvcmn.cpp
renamed Render's argument to not obfuscate its meaning
[wxWidgets.git] / src / common / toplvcmn.cpp
1 /////////////////////////////////////////////////////////////////////////////
2 // Name: common/toplvcmn.cpp
3 // Purpose: common (for all platforms) wxTopLevelWindow functions
4 // Author: Julian Smart, Vadim Zeitlin
5 // Created: 01/02/97
6 // Id: $Id$
7 // Copyright: (c) 1998 Robert Roebling and Julian Smart
8 // Licence: wxWindows licence
9 /////////////////////////////////////////////////////////////////////////////
10
11 // ============================================================================
12 // declarations
13 // ============================================================================
14
15 // ----------------------------------------------------------------------------
16 // headers
17 // ----------------------------------------------------------------------------
18
19 #if defined(__GNUG__) && !defined(NO_GCC_PRAGMA)
20 #pragma implementation "toplevelbase.h"
21 #endif
22
23 // For compilers that support precompilation, includes "wx.h".
24 #include "wx/wxprec.h"
25
26 #ifdef __BORLANDC__
27 #pragma hdrstop
28 #endif
29
30 #ifndef WX_PRECOMP
31 #include "wx/toplevel.h"
32 #include "wx/dcclient.h"
33 #include "wx/app.h"
34 #endif // WX_PRECOMP
35
36 // ----------------------------------------------------------------------------
37 // event table
38 // ----------------------------------------------------------------------------
39
40 BEGIN_EVENT_TABLE(wxTopLevelWindowBase, wxWindow)
41 EVT_CLOSE(wxTopLevelWindowBase::OnCloseWindow)
42 EVT_SIZE(wxTopLevelWindowBase::OnSize)
43 END_EVENT_TABLE()
44
45 // ============================================================================
46 // implementation
47 // ============================================================================
48
49 IMPLEMENT_DYNAMIC_CLASS(wxTopLevelWindow, wxWindow)
50
51 // ----------------------------------------------------------------------------
52 // construction/destruction
53 // ----------------------------------------------------------------------------
54
55 wxTopLevelWindowBase::wxTopLevelWindowBase()
56 {
57 // Unlike windows, top level windows are created hidden by default.
58 m_isShown = false;
59 }
60
61 wxTopLevelWindowBase::~wxTopLevelWindowBase()
62 {
63 // don't let wxTheApp keep any stale pointers to us
64 if ( wxTheApp && wxTheApp->GetTopWindow() == this )
65 wxTheApp->SetTopWindow(NULL);
66
67 bool shouldExit = IsLastBeforeExit();
68
69 wxTopLevelWindows.DeleteObject(this);
70
71 if ( shouldExit )
72 {
73 // then do it
74 wxTheApp->ExitMainLoop();
75 }
76 }
77
78 bool wxTopLevelWindowBase::Destroy()
79 {
80 // delayed destruction: the frame will be deleted during the next idle
81 // loop iteration
82 if ( !wxPendingDelete.Member(this) )
83 wxPendingDelete.Append(this);
84
85 if (wxTopLevelWindows.GetCount() > 1)
86 {
87 // Hide it immediately. This should
88 // not be done if this TLW is the
89 // only one left since we then would
90 // risk not to get any idle events
91 // at all anymore during which we
92 // could delete any pending events.
93 Hide();
94 }
95
96 return true;
97 }
98
99 bool wxTopLevelWindowBase::IsLastBeforeExit() const
100 {
101 // we exit the application if there are no more top level windows left
102 // normally but wxApp can prevent this from happening
103 return wxTopLevelWindows.GetCount() == 1 &&
104 wxTopLevelWindows.GetFirst()->GetData() == (wxWindow *)this &&
105 wxTheApp && wxTheApp->GetExitOnFrameDelete();
106 }
107
108 // ----------------------------------------------------------------------------
109 // wxTopLevelWindow geometry
110 // ----------------------------------------------------------------------------
111
112 void wxTopLevelWindowBase::GetRectForTopLevelChildren(int *x, int *y, int *w, int *h)
113 {
114 GetPosition(x,y);
115 GetSize(w,h);
116 }
117
118 wxSize wxTopLevelWindowBase::GetMaxSize() const
119 {
120 wxSize size( GetMaxWidth(), GetMaxHeight() );
121 int w, h;
122
123 wxClientDisplayRect( 0, 0, &w, &h );
124
125 if( size.GetWidth() == wxDefaultCoord )
126 size.SetWidth( w );
127
128 if( size.GetHeight() == wxDefaultCoord )
129 size.SetHeight( h );
130
131 return size;
132 }
133
134 /* static */
135 wxSize wxTopLevelWindowBase::GetDefaultSize()
136 {
137 wxSize size = wxGetClientDisplayRect().GetSize();
138
139 // create proportionally bigger windows on small screens
140 if ( size.x >= 1024 )
141 size.x = 400;
142 else if ( size.x >= 800 )
143 size.x = 300;
144 else if ( size.x >= 320 )
145 size.x = 240;
146
147 if ( size.y >= 768 )
148 size.y = 250;
149 else if ( size.y > 200 )
150 {
151 size.y *= 2;
152 size.y /= 3;
153 }
154
155 return size;
156 }
157
158 // ----------------------------------------------------------------------------
159 // wxTopLevelWindow size management: we exclude the areas taken by
160 // menu/status/toolbars from the client area, so the client area is what's
161 // really available for the frame contents
162 // ----------------------------------------------------------------------------
163
164 void wxTopLevelWindowBase::DoScreenToClient(int *x, int *y) const
165 {
166 wxWindow::DoScreenToClient(x, y);
167
168 // translate the wxWindow client coords to our client coords
169 wxPoint pt(GetClientAreaOrigin());
170 if ( x )
171 *x -= pt.x;
172 if ( y )
173 *y -= pt.y;
174 }
175
176 void wxTopLevelWindowBase::DoClientToScreen(int *x, int *y) const
177 {
178 // our client area origin (0, 0) may be really something like (0, 30) for
179 // wxWindow if we have a toolbar, account for it before translating
180 wxPoint pt(GetClientAreaOrigin());
181 if ( x )
182 *x += pt.x;
183 if ( y )
184 *y += pt.y;
185
186 wxWindow::DoClientToScreen(x, y);
187 }
188
189
190 // ----------------------------------------------------------------------------
191 // event handlers
192 // ----------------------------------------------------------------------------
193
194 // default resizing behaviour - if only ONE subwindow, resize to fill the
195 // whole client area
196 void wxTopLevelWindowBase::DoLayout()
197 {
198 // if we're using constraints or sizers - do use them
199 if ( GetAutoLayout() )
200 {
201 Layout();
202 }
203 else
204 {
205 // do we have _exactly_ one child?
206 wxWindow *child = (wxWindow *)NULL;
207 for ( wxWindowList::compatibility_iterator node = GetChildren().GetFirst();
208 node;
209 node = node->GetNext() )
210 {
211 wxWindow *win = node->GetData();
212
213 // exclude top level and managed windows (status bar isn't
214 // currently in the children list except under wxMac anyhow, but
215 // it makes no harm to test for it)
216 if ( !win->IsTopLevel() && !IsOneOfBars(win) )
217 {
218 if ( child )
219 {
220 return; // it's our second subwindow - nothing to do
221 }
222
223 child = win;
224 }
225 }
226
227 // do we have any children at all?
228 if ( child )
229 {
230 // exactly one child - set it's size to fill the whole frame
231 int clientW, clientH;
232 DoGetClientSize(&clientW, &clientH);
233
234 // for whatever reasons, wxGTK wants to have a small offset - it
235 // probably looks better with it?
236 #ifdef __WXGTK__
237 static const int ofs = 1;
238 #else
239 static const int ofs = 0;
240 #endif
241
242 child->SetSize(ofs, ofs, clientW - 2*ofs, clientH - 2*ofs);
243 }
244 }
245 }
246
247 // The default implementation for the close window event.
248 void wxTopLevelWindowBase::OnCloseWindow(wxCloseEvent& WXUNUSED(event))
249 {
250 Destroy();
251 }
252
253 bool wxTopLevelWindowBase::SendIconizeEvent(bool iconized)
254 {
255 wxIconizeEvent event(GetId(), iconized);
256 event.SetEventObject(this);
257
258 return GetEventHandler()->ProcessEvent(event);
259 }
260
261 // do the window-specific processing after processing the update event
262 void wxTopLevelWindowBase::DoUpdateWindowUI(wxUpdateUIEvent& event)
263 {
264 if ( event.GetSetEnabled() )
265 Enable(event.GetEnabled());
266
267 if ( event.GetSetText() )
268 {
269 if ( event.GetText() != GetTitle() )
270 SetTitle(event.GetText());
271 }
272 }
273
274 void wxTopLevelWindowBase::RequestUserAttention(int WXUNUSED(flags))
275 {
276 // it's probably better than do nothing, isn't it?
277 Raise();
278 }
279