src/common/toplvcmn.cpp

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        src/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 // For compilers that support precompilation, includes "wx.h".
  20 #include "wx/wxprec.h"
  21
  22 #ifdef __BORLANDC__
  23     #pragma hdrstop
  24 #endif
  25
  26 #include "wx/toplevel.h"
  27
  28 #ifndef WX_PRECOMP
  29     #include "wx/dcclient.h"
  30     #include "wx/app.h"
  31 #endif // WX_PRECOMP
  32
  33 #include "wx/display.h"
  34
  35 // ----------------------------------------------------------------------------
  36 // event table
  37 // ----------------------------------------------------------------------------
  38
  39 BEGIN_EVENT_TABLE(wxTopLevelWindowBase, wxWindow)
  40     EVT_CLOSE(wxTopLevelWindowBase::OnCloseWindow)
  41     EVT_SIZE(wxTopLevelWindowBase::OnSize)
  42     WX_EVENT_TABLE_CONTROL_CONTAINER(wxTopLevelWindowBase)
  43 END_EVENT_TABLE()
  44
  45 WX_DELEGATE_TO_CONTROL_CONTAINER(wxTopLevelWindowBase, wxWindow)
  46
  47 // ============================================================================
  48 // implementation
  49 // ============================================================================
  50
  51 IMPLEMENT_ABSTRACT_CLASS(wxTopLevelWindow, wxWindow)
  52
  53 // ----------------------------------------------------------------------------
  54 // construction/destruction
  55 // ----------------------------------------------------------------------------
  56
  57 wxTopLevelWindowBase::wxTopLevelWindowBase()
  58 {
  59     // Unlike windows, top level windows are created hidden by default.
  60     m_isShown = false;
  61
  62     WX_INIT_CONTROL_CONTAINER();
  63 }
  64
  65 wxTopLevelWindowBase::~wxTopLevelWindowBase()
  66 {
  67     // don't let wxTheApp keep any stale pointers to us
  68     if ( wxTheApp && wxTheApp->GetTopWindow() == this )
  69         wxTheApp->SetTopWindow(NULL);
  70
  71     wxTopLevelWindows.DeleteObject(this);
  72
  73     // delete any our top level children which are still pending for deletion
  74     // immediately: this could happen if a child (e.g. a temporary dialog
  75     // created with this window as parent) was Destroy()'d) while this window
  76     // was deleted directly (with delete, or maybe just because it was created
  77     // on the stack) immediately afterwards and before the child TLW was really
  78     // destroyed -- not destroying it now would leave it alive with a dangling
  79     // parent pointer and result in a crash later
  80     for ( wxObjectList::iterator i = wxPendingDelete.begin();
  81           i != wxPendingDelete.end();
  82           )
  83     {
  84         wxWindow * const win = wxDynamicCast(*i, wxWindow);
  85         if ( win && win->GetParent() == this )
  86         {
  87             wxPendingDelete.erase(i);
  88
  89             delete win;
  90
  91             // deleting it invalidated the list (and not only one node because
  92             // it could have resulted in deletion of other objects to)
  93             i = wxPendingDelete.begin();
  94         }
  95         else
  96         {
  97             ++i;
  98         }
  99     }
 100
 101     if ( IsLastBeforeExit() )
 102     {
 103         // no other (important) windows left, quit the app
 104         wxTheApp->ExitMainLoop();
 105     }
 106 }
 107
 108 bool wxTopLevelWindowBase::Destroy()
 109 {
 110     // delayed destruction: the frame will be deleted during the next idle
 111     // loop iteration
 112     if ( !wxPendingDelete.Member(this) )
 113         wxPendingDelete.Append(this);
 114
 115     // normally we want to hide the window immediately so that it doesn't get
 116     // stuck on the screen while it's being destroyed, however we shouldn't
 117     // hide the last visible window as then we might not get any idle events
 118     // any more as no events will be sent to the hidden window and without idle
 119     // events we won't prune wxPendingDelete list and the application won't
 120     // terminate
 121     for ( wxWindowList::const_iterator i = wxTopLevelWindows.begin(),
 122                                      end = wxTopLevelWindows.end();
 123           i != end;
 124           ++i )
 125     {
 126         wxTopLevelWindow * const win = static_cast<wxTopLevelWindow *>(*i);
 127         if ( win != this && win->IsShown() )
 128         {
 129             // there remains at least one other visible TLW, we can hide this
 130             // one
 131             Hide();
 132
 133             break;
 134         }
 135     }
 136
 137     return true;
 138 }
 139
 140 bool wxTopLevelWindowBase::IsLastBeforeExit() const
 141 {
 142     // first of all, automatically exiting the app on last window close can be
 143     // completely disabled at wxTheApp level
 144     if ( !wxTheApp || !wxTheApp->GetExitOnFrameDelete() )
 145         return false;
 146
 147     wxWindowList::const_iterator i;
 148     const wxWindowList::const_iterator end = wxTopLevelWindows.end();
 149
 150     // then decide whether we should exit at all
 151     for ( i = wxTopLevelWindows.begin(); i != end; ++i )
 152     {
 153         wxTopLevelWindow * const win = static_cast<wxTopLevelWindow *>(*i);
 154         if ( win->ShouldPreventAppExit() )
 155         {
 156             // there remains at least one important TLW, don't exit
 157             return false;
 158         }
 159     }
 160
 161     // if yes, close all the other windows: this could still fail
 162     for ( i = wxTopLevelWindows.begin(); i != end; ++i )
 163     {
 164         // don't close twice the windows which are already marked for deletion
 165         wxTopLevelWindow * const win = static_cast<wxTopLevelWindow *>(*i);
 166         if ( !wxPendingDelete.Member(win) && !win->Close() )
 167         {
 168             // one of the windows refused to close, don't exit
 169             //
 170             // NB: of course, by now some other windows could have been already
 171             //     closed but there is really nothing we can do about it as we
 172             //     have no way just to ask the window if it can close without
 173             //     forcing it to do it
 174             return false;
 175         }
 176     }
 177
 178     return true;
 179 }
 180
 181 // ----------------------------------------------------------------------------
 182 // wxTopLevelWindow geometry
 183 // ----------------------------------------------------------------------------
 184
 185 void wxTopLevelWindowBase::SetMinSize(const wxSize& minSize)
 186 {
 187     SetSizeHints(minSize, GetMaxSize());
 188 }
 189
 190 void wxTopLevelWindowBase::SetMaxSize(const wxSize& maxSize)
 191 {
 192     SetSizeHints(GetMinSize(), maxSize);
 193 }
 194
 195 void wxTopLevelWindowBase::GetRectForTopLevelChildren(int *x, int *y, int *w, int *h)
 196 {
 197     GetPosition(x,y);
 198     GetSize(w,h);
 199 }
 200
 201 /* static */
 202 wxSize wxTopLevelWindowBase::GetDefaultSize()
 203 {
 204     wxSize size = wxGetClientDisplayRect().GetSize();
 205
 206     // create proportionally bigger windows on small screens
 207     if ( size.x >= 1024 )
 208         size.x = 400;
 209     else if ( size.x >= 800 )
 210         size.x = 300;
 211     else if ( size.x >= 320 )
 212         size.x = 240;
 213
 214     if ( size.y >= 768 )
 215         size.y = 250;
 216     else if ( size.y > 200 )
 217     {
 218         size.y *= 2;
 219         size.y /= 3;
 220     }
 221
 222     return size;
 223 }
 224
 225 void wxTopLevelWindowBase::DoCentre(int dir)
 226 {
 227     // on some platforms centering top level windows is impossible
 228     // because they are always maximized by guidelines or limitations
 229     if(IsAlwaysMaximized())
 230         return;
 231
 232     // we need the display rect anyhow so store it first: notice that we should
 233     // be centered on the same display as our parent window, the display of
 234     // this window itself is not really defined yet
 235     int nDisplay = wxDisplay::GetFromWindow(GetParent() ? GetParent() : this);
 236     wxDisplay dpy(nDisplay == wxNOT_FOUND ? 0 : nDisplay);
 237     const wxRect rectDisplay(dpy.GetClientArea());
 238
 239     // what should we centre this window on?
 240     wxRect rectParent;
 241     if ( !(dir & wxCENTRE_ON_SCREEN) && GetParent() )
 242     {
 243         // centre on parent window: notice that we need screen coordinates for
 244         // positioning this TLW
 245         rectParent = GetParent()->GetScreenRect();
 246
 247         // if the parent is entirely off screen (happens at least with MDI
 248         // parent frame under Mac but could happen elsewhere too if the frame
 249         // was hidden/moved away for some reason), don't use it as otherwise
 250         // this window wouldn't be visible at all
 251         if ( !rectDisplay.Contains(rectParent.GetTopLeft()) &&
 252                 !rectParent.Contains(rectParent.GetBottomRight()) )
 253         {
 254             // this is enough to make IsEmpty() test below pass
 255             rectParent.width = 0;
 256         }
 257     }
 258
 259     if ( rectParent.IsEmpty() )
 260     {
 261         // we were explicitly asked to centre this window on the entire screen
 262         // or if we have no parent anyhow and so can't centre on it
 263         rectParent = rectDisplay;
 264     }
 265
 266     // centering maximized window on screen is no-op
 267     if((rectParent == rectDisplay) && IsMaximized())
 268         return;
 269
 270     if ( !(dir & wxBOTH) )
 271         dir |= wxBOTH; // if neither is specified, center in both directions
 272
 273     // the new window rect candidate
 274     wxRect rect = GetRect().CentreIn(rectParent, dir & ~wxCENTRE_ON_SCREEN);
 275
 276     // we don't want to place the window off screen if Centre() is called as
 277     // this is (almost?) never wanted and it would be very difficult to prevent
 278     // it from happening from the user code if we didn't check for it here
 279     if ( !rectDisplay.Contains(rect.GetTopLeft()) )
 280     {
 281         // move the window just enough to make the corner visible
 282         int dx = rectDisplay.GetLeft() - rect.GetLeft();
 283         int dy = rectDisplay.GetTop() - rect.GetTop();
 284         rect.Offset(dx > 0 ? dx : 0, dy > 0 ? dy : 0);
 285     }
 286
 287     if ( !rectDisplay.Contains(rect.GetBottomRight()) )
 288     {
 289         // do the same for this corner too
 290         int dx = rectDisplay.GetRight() - rect.GetRight();
 291         int dy = rectDisplay.GetBottom() - rect.GetBottom();
 292         rect.Offset(dx < 0 ? dx : 0, dy < 0 ? dy : 0);
 293     }
 294
 295     // the window top left and bottom right corner are both visible now and
 296     // although the window might still be not entirely on screen (with 2
 297     // staggered displays for example) we wouldn't be able to improve the
 298     // layout much in such case, so we stop here
 299
 300     // -1 could be valid coordinate here if there are several displays
 301     SetSize(rect, wxSIZE_ALLOW_MINUS_ONE);
 302 }
 303
 304 // ----------------------------------------------------------------------------
 305 // wxTopLevelWindow size management: we exclude the areas taken by
 306 // menu/status/toolbars from the client area, so the client area is what's
 307 // really available for the frame contents
 308 // ----------------------------------------------------------------------------
 309
 310 void wxTopLevelWindowBase::DoScreenToClient(int *x, int *y) const
 311 {
 312     wxWindow::DoScreenToClient(x, y);
 313
 314     // translate the wxWindow client coords to our client coords
 315     wxPoint pt(GetClientAreaOrigin());
 316     if ( x )
 317         *x -= pt.x;
 318     if ( y )
 319         *y -= pt.y;
 320 }
 321
 322 void wxTopLevelWindowBase::DoClientToScreen(int *x, int *y) const
 323 {
 324     // our client area origin (0, 0) may be really something like (0, 30) for
 325     // wxWindow if we have a toolbar, account for it before translating
 326     wxPoint pt(GetClientAreaOrigin());
 327     if ( x )
 328         *x += pt.x;
 329     if ( y )
 330         *y += pt.y;
 331
 332     wxWindow::DoClientToScreen(x, y);
 333 }
 334
 335 bool wxTopLevelWindowBase::IsAlwaysMaximized() const
 336 {
 337 #if defined(__SMARTPHONE__) || defined(__POCKETPC__)
 338     return true;
 339 #else
 340     return false;
 341 #endif
 342 }
 343
 344 // ----------------------------------------------------------------------------
 345 // icons
 346 // ----------------------------------------------------------------------------
 347
 348 wxIcon wxTopLevelWindowBase::GetIcon() const
 349 {
 350     return m_icons.IsEmpty() ? wxIcon() : m_icons.GetIcon( -1 );
 351 }
 352
 353 void wxTopLevelWindowBase::SetIcon(const wxIcon& icon)
 354 {
 355     // passing wxNullIcon to SetIcon() is possible (it means that we shouldn't
 356     // have any icon), but adding an invalid icon to wxIconBundle is not
 357     wxIconBundle icons;
 358     if ( icon.Ok() )
 359         icons.AddIcon(icon);
 360
 361     SetIcons(icons);
 362 }
 363
 364 // ----------------------------------------------------------------------------
 365 // event handlers
 366 // ----------------------------------------------------------------------------
 367
 368 // default resizing behaviour - if only ONE subwindow, resize to fill the
 369 // whole client area
 370 void wxTopLevelWindowBase::DoLayout()
 371 {
 372     // if we're using constraints or sizers - do use them
 373     if ( GetAutoLayout() )
 374     {
 375         Layout();
 376     }
 377     else
 378     {
 379         // do we have _exactly_ one child?
 380         wxWindow *child = (wxWindow *)NULL;
 381         for ( wxWindowList::compatibility_iterator node = GetChildren().GetFirst();
 382               node;
 383               node = node->GetNext() )
 384         {
 385             wxWindow *win = node->GetData();
 386
 387             // exclude top level and managed windows (status bar isn't
 388             // currently in the children list except under wxMac anyhow, but
 389             // it makes no harm to test for it)
 390             if ( !win->IsTopLevel() && !IsOneOfBars(win) )
 391             {
 392                 if ( child )
 393                 {
 394                     return;     // it's our second subwindow - nothing to do
 395                 }
 396
 397                 child = win;
 398             }
 399         }
 400
 401         // do we have any children at all?
 402         if ( child && child->IsShown() )
 403         {
 404             // exactly one child - set it's size to fill the whole frame
 405             int clientW, clientH;
 406             DoGetClientSize(&clientW, &clientH);
 407
 408             child->SetSize(0, 0, clientW, clientH);
 409         }
 410     }
 411 }
 412
 413 // The default implementation for the close window event.
 414 void wxTopLevelWindowBase::OnCloseWindow(wxCloseEvent& WXUNUSED(event))
 415 {
 416     Destroy();
 417 }
 418
 419 bool wxTopLevelWindowBase::SendIconizeEvent(bool iconized)
 420 {
 421     wxIconizeEvent event(GetId(), iconized);
 422     event.SetEventObject(this);
 423
 424     return GetEventHandler()->ProcessEvent(event);
 425 }
 426
 427 // do the window-specific processing after processing the update event
 428 void wxTopLevelWindowBase::DoUpdateWindowUI(wxUpdateUIEvent& event)
 429 {
 430     // call inherited, but skip the wxControl's version, and call directly the
 431     // wxWindow's one instead, because the only reason why we are overriding this
 432     // function is that we want to use SetTitle() instead of wxControl::SetLabel()
 433     wxWindowBase::DoUpdateWindowUI(event);
 434
 435     // update title
 436     if ( event.GetSetText() )
 437     {
 438         if ( event.GetText() != GetTitle() )
 439             SetTitle(event.GetText());
 440     }
 441 }
 442
 443 void wxTopLevelWindowBase::RequestUserAttention(int WXUNUSED(flags))
 444 {
 445     // it's probably better than do nothing, isn't it?
 446     Raise();
 447 }