1 /////////////////////////////////////////////////////////////////////////////
2 // Name: src/common/toplvcmn.cpp
3 // Purpose: common (for all platforms) wxTopLevelWindow functions
4 // Author: Julian Smart, Vadim Zeitlin
7 // Copyright: (c) 1998 Robert Roebling and Julian Smart
8 // Licence: wxWindows licence
9 /////////////////////////////////////////////////////////////////////////////
11 // ============================================================================
13 // ============================================================================
15 // ----------------------------------------------------------------------------
17 // ----------------------------------------------------------------------------
19 // For compilers that support precompilation, includes "wx.h".
20 #include "wx/wxprec.h"
26 #include "wx/toplevel.h"
29 #include "wx/dcclient.h"
33 #include "wx/display.h"
35 // ----------------------------------------------------------------------------
37 // ----------------------------------------------------------------------------
39 BEGIN_EVENT_TABLE(wxTopLevelWindowBase
, wxWindow
)
40 EVT_CLOSE(wxTopLevelWindowBase::OnCloseWindow
)
41 EVT_SIZE(wxTopLevelWindowBase::OnSize
)
44 // ============================================================================
46 // ============================================================================
48 IMPLEMENT_ABSTRACT_CLASS(wxTopLevelWindow
, wxWindow
)
50 // ----------------------------------------------------------------------------
51 // construction/destruction
52 // ----------------------------------------------------------------------------
54 wxTopLevelWindowBase::wxTopLevelWindowBase()
56 // Unlike windows, top level windows are created hidden by default.
59 m_winTmpDefault
= NULL
;
62 wxTopLevelWindowBase::~wxTopLevelWindowBase()
64 // don't let wxTheApp keep any stale pointers to us
65 if ( wxTheApp
&& wxTheApp
->GetTopWindow() == this )
66 wxTheApp
->SetTopWindow(NULL
);
68 wxTopLevelWindows
.DeleteObject(this);
70 if ( IsLastBeforeExit() )
72 // no other (important) windows left, quit the app
73 wxTheApp
->ExitMainLoop();
77 bool wxTopLevelWindowBase::Destroy()
79 // delayed destruction: the frame will be deleted during the next idle
81 if ( !wxPendingDelete
.Member(this) )
82 wxPendingDelete
.Append(this);
84 if (wxTopLevelWindows
.GetCount() > 1)
86 // Hide it immediately. This should
87 // not be done if this TLW is the
88 // only one left since we then would
89 // risk not to get any idle events
90 // at all anymore during which we
91 // could delete any pending events.
98 bool wxTopLevelWindowBase::IsLastBeforeExit() const
100 // first of all, automatically exiting the app on last window close can be
101 // completely disabled at wxTheApp level
102 if ( !wxTheApp
|| !wxTheApp
->GetExitOnFrameDelete() )
105 wxWindowList::const_iterator i
;
106 const wxWindowList::const_iterator end
= wxTopLevelWindows
.end();
108 // then decide whether we should exit at all
109 for ( i
= wxTopLevelWindows
.begin(); i
!= end
; ++i
)
111 wxTopLevelWindow
* const win
= wx_static_cast(wxTopLevelWindow
*, *i
);
112 if ( win
->ShouldPreventAppExit() )
114 // there remains at least one important TLW, don't exit
119 // if yes, close all the other windows: this could still fail
120 for ( i
= wxTopLevelWindows
.begin(); i
!= end
; ++i
)
122 // don't close twice the windows which are already marked for deletion
123 wxTopLevelWindow
* const win
= wx_static_cast(wxTopLevelWindow
*, *i
);
124 if ( !wxPendingDelete
.Member(win
) && !win
->Close() )
126 // one of the windows refused to close, don't exit
128 // NB: of course, by now some other windows could have been already
129 // closed but there is really nothing we can do about it as we
130 // have no way just to ask the window if it can close without
131 // forcing it to do it
139 // ----------------------------------------------------------------------------
140 // wxTopLevelWindow geometry
141 // ----------------------------------------------------------------------------
143 void wxTopLevelWindowBase::SetMinSize(const wxSize
& minSize
)
145 SetSizeHints( minSize
.x
, minSize
.y
, GetMaxWidth(), GetMaxHeight() );
148 void wxTopLevelWindowBase::SetMaxSize(const wxSize
& maxSize
)
150 SetSizeHints( GetMinWidth(), GetMinHeight(), maxSize
.x
, maxSize
.y
);
153 // set the min/max size of the window
154 void wxTopLevelWindowBase::DoSetSizeHints(int minW
, int minH
,
156 int WXUNUSED(incW
), int WXUNUSED(incH
))
158 // setting min width greater than max width leads to infinite loops under
159 // X11 and generally doesn't make any sense, so don't allow it
160 wxCHECK_RET( (minW
== wxDefaultCoord
|| maxW
== wxDefaultCoord
|| minW
<= maxW
) &&
161 (minH
== wxDefaultCoord
|| maxH
== wxDefaultCoord
|| minH
<= maxH
),
162 _T("min width/height must be less than max width/height!") );
170 void wxTopLevelWindowBase::GetRectForTopLevelChildren(int *x
, int *y
, int *w
, int *h
)
177 wxSize
wxTopLevelWindowBase::GetDefaultSize()
179 wxSize size
= wxGetClientDisplayRect().GetSize();
181 // create proportionally bigger windows on small screens
182 if ( size
.x
>= 1024 )
184 else if ( size
.x
>= 800 )
186 else if ( size
.x
>= 320 )
191 else if ( size
.y
> 200 )
200 void wxTopLevelWindowBase::DoCentre(int dir
)
202 // on some platforms centering top level windows is impossible
203 // because they are always maximized by guidelines or limitations
204 if(IsAlwaysMaximized())
207 // we need the display rect anyhow so store it first
208 int nDisplay
= wxDisplay::GetFromWindow(this);
209 wxDisplay
dpy(nDisplay
== wxNOT_FOUND
? 0 : nDisplay
);
210 const wxRect
rectDisplay(dpy
.GetClientArea());
212 // what should we centre this window on?
214 if ( !(dir
& wxCENTRE_ON_SCREEN
) && GetParent() )
216 // centre on parent window: notice that we need screen coordinates for
217 // positioning this TLW
218 rectParent
= GetParent()->GetScreenRect();
220 // if the parent is entirely off screen (happens at least with MDI
221 // parent frame under Mac but could happen elsewhere too if the frame
222 // was hidden/moved away for some reason), don't use it as otherwise
223 // this window wouldn't be visible at all
224 if ( !rectDisplay
.Contains(rectParent
.GetTopLeft()) &&
225 !rectParent
.Contains(rectParent
.GetBottomRight()) )
227 // this is enough to make IsEmpty() test below pass
228 rectParent
.width
= 0;
232 if ( rectParent
.IsEmpty() )
234 // we were explicitly asked to centre this window on the entire screen
235 // or if we have no parent anyhow and so can't centre on it
236 rectParent
= rectDisplay
;
239 // centering maximized window on screen is no-op
240 if((rectParent
== rectDisplay
) && IsMaximized())
243 // the new window rect candidate
244 wxRect rect
= GetRect().CentreIn(rectParent
, dir
);
246 // we don't want to place the window off screen if Centre() is called as
247 // this is (almost?) never wanted and it would be very difficult to prevent
248 // it from happening from the user code if we didn't check for it here
249 if ( rectDisplay
.Contains(rect
.GetTopLeft()) )
251 if ( !rectDisplay
.Contains(rect
.GetBottomRight()) )
253 // move the window just enough for the bottom right corner to
255 int dx
= rectDisplay
.GetRight() - rect
.GetRight();
256 int dy
= rectDisplay
.GetBottom() - rect
.GetBottom();
257 rect
.Offset(dx
< 0 ? dx
: 0, dy
< 0 ? dy
: 0);
259 //else: the window top left and bottom right corner are both visible,
260 // although the window might still be not entirely on screen (with
261 // 2 staggered displays for example) we wouldn't be able to
262 // improve the layout much in such case, so just leave it as is
264 else // make top left corner visible
266 if ( rect
.x
< rectDisplay
.x
)
267 rect
.x
= rectDisplay
.x
;
269 if ( rect
.y
< rectDisplay
.y
)
270 rect
.y
= rectDisplay
.y
;
273 // -1 could be valid coordinate here if there are several displays
274 SetSize(rect
, wxSIZE_ALLOW_MINUS_ONE
);
277 // ----------------------------------------------------------------------------
278 // wxTopLevelWindow size management: we exclude the areas taken by
279 // menu/status/toolbars from the client area, so the client area is what's
280 // really available for the frame contents
281 // ----------------------------------------------------------------------------
283 void wxTopLevelWindowBase::DoScreenToClient(int *x
, int *y
) const
285 wxWindow::DoScreenToClient(x
, y
);
287 // translate the wxWindow client coords to our client coords
288 wxPoint
pt(GetClientAreaOrigin());
295 void wxTopLevelWindowBase::DoClientToScreen(int *x
, int *y
) const
297 // our client area origin (0, 0) may be really something like (0, 30) for
298 // wxWindow if we have a toolbar, account for it before translating
299 wxPoint
pt(GetClientAreaOrigin());
305 wxWindow::DoClientToScreen(x
, y
);
308 bool wxTopLevelWindowBase::IsAlwaysMaximized() const
310 #if defined(__SMARTPHONE__) || defined(__POCKETPC__)
317 // ----------------------------------------------------------------------------
319 // ----------------------------------------------------------------------------
321 // default resizing behaviour - if only ONE subwindow, resize to fill the
323 void wxTopLevelWindowBase::DoLayout()
325 // if we're using constraints or sizers - do use them
326 if ( GetAutoLayout() )
332 // do we have _exactly_ one child?
333 wxWindow
*child
= (wxWindow
*)NULL
;
334 for ( wxWindowList::compatibility_iterator node
= GetChildren().GetFirst();
336 node
= node
->GetNext() )
338 wxWindow
*win
= node
->GetData();
340 // exclude top level and managed windows (status bar isn't
341 // currently in the children list except under wxMac anyhow, but
342 // it makes no harm to test for it)
343 if ( !win
->IsTopLevel() && !IsOneOfBars(win
) )
347 return; // it's our second subwindow - nothing to do
354 // do we have any children at all?
355 if ( child
&& child
->IsShown() )
357 // exactly one child - set it's size to fill the whole frame
358 int clientW
, clientH
;
359 DoGetClientSize(&clientW
, &clientH
);
361 child
->SetSize(0, 0, clientW
, clientH
);
366 // The default implementation for the close window event.
367 void wxTopLevelWindowBase::OnCloseWindow(wxCloseEvent
& WXUNUSED(event
))
372 bool wxTopLevelWindowBase::SendIconizeEvent(bool iconized
)
374 wxIconizeEvent
event(GetId(), iconized
);
375 event
.SetEventObject(this);
377 return GetEventHandler()->ProcessEvent(event
);
380 // do the window-specific processing after processing the update event
381 void wxTopLevelWindowBase::DoUpdateWindowUI(wxUpdateUIEvent
& event
)
383 // call inherited, but skip the wxControl's version, and call directly the
384 // wxWindow's one instead, because the only reason why we are overriding this
385 // function is that we want to use SetTitle() instead of wxControl::SetLabel()
386 wxWindowBase::DoUpdateWindowUI(event
);
389 if ( event
.GetSetText() )
391 if ( event
.GetText() != GetTitle() )
392 SetTitle(event
.GetText());
396 void wxTopLevelWindowBase::RequestUserAttention(int WXUNUSED(flags
))
398 // it's probably better than do nothing, isn't it?
402 void wxTopLevelWindowBase::RemoveChild(wxWindowBase
*child
)
404 if ( child
== m_winDefault
)
407 if ( child
== m_winTmpDefault
)
408 m_winTmpDefault
= NULL
;
410 wxWindow::RemoveChild(child
);