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