src/msw/toplevel.cpp

   1 ///////////////////////////////////////////////////////////////////////////////
   2 // Name:        msw/toplevel.cpp
   3 // Purpose:     implements wxTopLevelWindow for MSW
   4 // Author:      Vadim Zeitlin
   5 // Modified by:
   6 // Created:     24.09.01
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) 2001 SciTech Software, Inc. (www.scitechsoft.com)
   9 // License:     wxWindows license
  10 ///////////////////////////////////////////////////////////////////////////////
  11
  12 // ============================================================================
  13 // declarations
  14 // ============================================================================
  15
  16 // ----------------------------------------------------------------------------
  17 // headers
  18 // ----------------------------------------------------------------------------
  19
  20 #ifdef __GNUG__
  21     #pragma implementation "toplevel.h"
  22 #endif
  23
  24 // For compilers that support precompilation, includes "wx.h".
  25 #include "wx/wxprec.h"
  26
  27 #ifdef __BORLANDC__
  28     #pragma hdrstop
  29 #endif
  30
  31 #ifndef WX_PRECOMP
  32     #include "wx/app.h"
  33     #include "wx/toplevel.h"
  34     #include "wx/string.h"
  35     #include "wx/log.h"
  36     #include "wx/intl.h"
  37     #include "wx/frame.h"
  38 #endif //WX_PRECOMP
  39
  40 #include "wx/msw/private.h"
  41
  42 // ----------------------------------------------------------------------------
  43 // stubs for missing functions under MicroWindows
  44 // ----------------------------------------------------------------------------
  45
  46 #ifdef __WXMICROWIN__
  47
  48 // static inline bool IsIconic(HWND WXUNUSED(hwnd)) { return FALSE; }
  49 static inline bool IsZoomed(HWND WXUNUSED(hwnd)) { return FALSE; }
  50
  51 #endif // __WXMICROWIN__
  52
  53 // ----------------------------------------------------------------------------
  54 // globals
  55 // ----------------------------------------------------------------------------
  56
  57 // list of all frames and modeless dialogs
  58 wxWindowList wxModelessWindows;
  59
  60 // the name of the default wxWindows class
  61 extern const wxChar *wxCanvasClassName;
  62
  63 // ============================================================================
  64 // wxTopLevelWindowMSW implementation
  65 // ============================================================================
  66
  67 // Dialog window proc
  68 LONG APIENTRY _EXPORT
  69 wxDlgProc(HWND WXUNUSED(hWnd), UINT message, WPARAM WXUNUSED(wParam), LPARAM WXUNUSED(lParam))
  70 {
  71     if ( message == WM_INITDIALOG )
  72     {
  73         // for this message, returning TRUE tells system to set focus to the
  74         // first control in the dialog box
  75         return TRUE;
  76     }
  77     else
  78     {
  79         // for all the other ones, FALSE means that we didn't process the
  80         // message
  81         return FALSE;
  82     }
  83 }
  84
  85 // ----------------------------------------------------------------------------
  86 // wxTopLevelWindowMSW creation
  87 // ----------------------------------------------------------------------------
  88
  89 void wxTopLevelWindowMSW::Init()
  90 {
  91     m_iconized =
  92     m_maximizeOnShow = FALSE;
  93
  94     // unlike (almost?) all other windows, frames are created hidden
  95     m_isShown = FALSE;
  96
  97     // Data to save/restore when calling ShowFullScreen
  98     m_fsStyle = 0;
  99     m_fsOldWindowStyle = 0;
 100     m_fsIsMaximized = FALSE;
 101     m_fsIsShowing = FALSE;
 102 }
 103
 104 long wxTopLevelWindowMSW::MSWGetCreateWindowFlags(long *exflags) const
 105 {
 106     long style = GetWindowStyle();
 107
 108     // first select the kind of window being created
 109     long msflags;
 110     if ( style & wxFRAME_TOOL_WINDOW )
 111         msflags = WS_POPUP;
 112     else
 113         msflags = WS_OVERLAPPED;
 114
 115     // border and caption styles
 116     if ( style & wxRESIZE_BORDER )
 117         msflags |= WS_THICKFRAME;
 118     else if ( !(style & wxBORDER_NONE) )
 119         msflags |= WS_BORDER;
 120
 121     if ( style & wxCAPTION )
 122         msflags |= WS_CAPTION;
 123
 124     // if we don't set WS_POPUP, Windows assumes WS_OVERLAPPED and creates a
 125     // window with both caption and border
 126     if ( msflags & (WS_CAPTION | WS_BORDER) != WS_CAPTION | WS_BORDER )
 127     {
 128         msflags |= WS_POPUP;
 129     }
 130
 131     // next translate the individual flags
 132     if ( style & wxMINIMIZE_BOX )
 133         msflags |= WS_MINIMIZEBOX;
 134     if ( style & wxMAXIMIZE_BOX )
 135         msflags |= WS_MAXIMIZEBOX;
 136     if ( style & wxSYSTEM_MENU )
 137         msflags |= WS_SYSMENU;
 138     if ( style & wxMINIMIZE )
 139         msflags |= WS_MINIMIZE;
 140     if ( style & wxMAXIMIZE )
 141         msflags |= WS_MAXIMIZE;
 142
 143     if ( style & wxCLIP_CHILDREN )
 144         msflags |= WS_CLIPCHILDREN;
 145
 146     // Keep this here because it saves recoding this function in wxTinyFrame
 147 #if wxUSE_ITSY_BITSY && !defined(__WIN32__)
 148     if ( style & wxTINY_CAPTION_VERT )
 149         msflags |= IBS_VERTCAPTION;
 150     if ( style & wxTINY_CAPTION_HORIZ )
 151         msflags |= IBS_HORZCAPTION;
 152 #else
 153     if ( style & (wxTINY_CAPTION_VERT | wxTINY_CAPTION_HORIZ) )
 154         msflags |= WS_CAPTION;
 155 #endif
 156
 157     if ( exflags )
 158     {
 159         *exflags = MakeExtendedStyle(style);
 160
 161 #if !defined(__WIN16__) && !defined(__SC__)
 162         if ( !(GetExtraStyle() & wxTOPLEVEL_EX_DIALOG) )
 163         {
 164             // make all frames appear in the win9x shell taskbar unless
 165             // wxFRAME_TOOL_WINDOW or wxFRAME_NO_TASKBAR is given - without
 166             // giving them WS_EX_APPWINDOW style, the child (i.e. owned) frames
 167             // wouldn't appear in it
 168             if ( (style & wxFRAME_TOOL_WINDOW) || (style & wxFRAME_NO_TASKBAR) )
 169                 *exflags |= WS_EX_TOOLWINDOW;
 170             else if ( !(style & wxFRAME_NO_TASKBAR) )
 171                 *exflags |= WS_EX_APPWINDOW;
 172         }
 173 #endif // !Win16
 174
 175         if ( style & wxSTAY_ON_TOP )
 176             *exflags |= WS_EX_TOPMOST;
 177
 178 #ifdef __WIN32__
 179         if ( m_exStyle & wxFRAME_EX_CONTEXTHELP )
 180             *exflags |= WS_EX_CONTEXTHELP;
 181 #endif // __WIN32__
 182     }
 183
 184     return msflags;
 185 }
 186
 187 bool wxTopLevelWindowMSW::CreateDialog(const wxChar *dlgTemplate,
 188                                        const wxString& title,
 189                                        const wxPoint& pos,
 190                                        const wxSize& size)
 191 {
 192 #ifdef __WXMICROWIN__
 193     // no dialogs support under MicroWin yet
 194     return CreateFrame(title, pos, size);
 195 #else // !__WXMICROWIN__
 196     wxWindow *parent = GetParent();
 197
 198     // for the dialogs without wxDIALOG_NO_PARENT style, use the top level
 199     // app window as parent - this avoids creating modal dialogs without
 200     // parent
 201     if ( !parent && !(GetWindowStyleFlag() & wxDIALOG_NO_PARENT) )
 202     {
 203         parent = wxTheApp->GetTopWindow();
 204
 205         if ( parent )
 206         {
 207             // don't use transient windows as parents, this is dangerous as it
 208             // can lead to a crash if the parent is destroyed before the child
 209             //
 210             // also don't use the window which is currently hidden as then the
 211             // dialog would be hidden as well
 212             if ( (parent->GetExtraStyle() & wxWS_EX_TRANSIENT) ||
 213                     !parent->IsShown() )
 214             {
 215                 parent = NULL;
 216             }
 217         }
 218     }
 219
 220     m_hWnd = (WXHWND)::CreateDialog(wxGetInstance(),
 221                                     dlgTemplate,
 222                                     parent ? GetHwndOf(parent) : NULL,
 223                                     (DLGPROC)wxDlgProc);
 224
 225     if ( !m_hWnd )
 226     {
 227         wxFAIL_MSG(_("Did you forget to include wx/msw/wx.rc in your resources?"));
 228
 229         wxLogSysError(_("Can't create dialog using template '%s'"), dlgTemplate);
 230
 231         return FALSE;
 232     }
 233
 234     long exflags;
 235     (void)MSWGetCreateWindowFlags(&exflags);
 236
 237     if ( exflags )
 238     {
 239         ::SetWindowLong(GetHwnd(), GWL_EXSTYLE, exflags);
 240         ::SetWindowPos(GetHwnd(), NULL, 0, 0, 0, 0,
 241                        SWP_NOSIZE |
 242                        SWP_NOMOVE |
 243                        SWP_NOZORDER |
 244                        SWP_NOACTIVATE);
 245     }
 246
 247 #if defined(__WIN95__)
 248     // For some reason, the system menu is activated when we use the
 249     // WS_EX_CONTEXTHELP style, so let's set a reasonable icon
 250     if ( exflags & WS_EX_CONTEXTHELP )
 251     {
 252         wxFrame *winTop = wxDynamicCast(wxTheApp->GetTopWindow(), wxFrame);
 253         if ( winTop )
 254         {
 255             wxIcon icon = winTop->GetIcon();
 256             if ( icon.Ok() )
 257             {
 258                 ::SendMessage(GetHwnd(), WM_SETICON,
 259                               (WPARAM)TRUE,
 260                               (LPARAM)GetHiconOf(icon));
 261             }
 262         }
 263     }
 264 #endif // __WIN95__
 265
 266     // move the dialog to its initial position without forcing repainting
 267     int x, y, w, h;
 268     if ( !MSWGetCreateWindowCoords(pos, size, x, y, w, h) )
 269     {
 270         x =
 271         w = (int)CW_USEDEFAULT;
 272     }
 273
 274     // we can't use CW_USEDEFAULT here as we're not calling CreateWindow()
 275     // and passing CW_USEDEFAULT to MoveWindow() results in resizing the
 276     // window to (0, 0) size which breaks quite a lot of things, e.g. the
 277     // sizer calculation in wxSizer::Fit()
 278     if ( w == (int)CW_USEDEFAULT )
 279     {
 280         // the exact number doesn't matter, the dialog will be resized
 281         // again soon anyhow but it should be big enough to allow
 282         // calculation relying on "totalSize - clientSize > 0" work, i.e.
 283         // at least greater than the title bar height
 284         w =
 285         h = 100;
 286     }
 287
 288     if ( x == (int)CW_USEDEFAULT )
 289     {
 290         // centre it on the screen - what else can we do?
 291         wxSize sizeDpy = wxGetDisplaySize();
 292
 293         x = (sizeDpy.x - w) / 2;
 294         y = (sizeDpy.y - h) / 2;
 295     }
 296
 297     if ( !::MoveWindow(GetHwnd(), x, y, w, h, FALSE) )
 298     {
 299         wxLogLastError(wxT("MoveWindow"));
 300     }
 301
 302     if ( !title.empty() )
 303     {
 304         ::SetWindowText(GetHwnd(), title);
 305     }
 306
 307     SubclassWin(m_hWnd);
 308
 309     return TRUE;
 310 #endif // __WXMICROWIN__/!__WXMICROWIN__
 311 }
 312
 313 bool wxTopLevelWindowMSW::CreateFrame(const wxString& title,
 314                                       const wxPoint& pos,
 315                                       const wxSize& size)
 316 {
 317     long exflags;
 318     long flags = MSWGetCreateWindowFlags(&exflags);
 319
 320     return MSWCreate(wxCanvasClassName, title, pos, size, flags, exflags);
 321 }
 322
 323 bool wxTopLevelWindowMSW::Create(wxWindow *parent,
 324                                  wxWindowID id,
 325                                  const wxString& title,
 326                                  const wxPoint& pos,
 327                                  const wxSize& size,
 328                                  long style,
 329                                  const wxString& name)
 330 {
 331     // init our fields
 332     Init();
 333
 334     m_windowStyle = style;
 335
 336     SetName(name);
 337
 338     m_windowId = id == -1 ? NewControlId() : id;
 339
 340     wxTopLevelWindows.Append(this);
 341
 342     if ( parent )
 343         parent->AddChild(this);
 344
 345     if ( GetExtraStyle() & wxTOPLEVEL_EX_DIALOG )
 346     {
 347         // TODO: it would be better to construct the dialog template in memory
 348         //       during run-time than to rely on the limited number of
 349         //       templates in wx.rc because:
 350         //          a) you wouldn't have to include wx.rc in all wxWin programs
 351         //             (and the number of complaints about it would dtop)
 352         //          b) we'd be able to provide more templates simply, i.e.
 353         //             we could generate the templates for all style
 354         //             combinations
 355
 356         // we have different dialog templates to allows creation of dialogs
 357         // with & without captions under MSWindows, resizeable or not (but a
 358         // resizeable dialog always has caption - otherwise it would look too
 359         // strange)
 360         const wxChar *dlgTemplate;
 361         if ( style & wxRESIZE_BORDER )
 362             dlgTemplate = wxT("wxResizeableDialog");
 363         else if ( style & wxCAPTION )
 364             dlgTemplate = wxT("wxCaptionDialog");
 365         else
 366             dlgTemplate = wxT("wxNoCaptionDialog");
 367
 368         return CreateDialog(dlgTemplate, title, pos, size);
 369     }
 370     else // !dialog
 371     {
 372         return CreateFrame(title, pos, size);
 373     }
 374 }
 375
 376 wxTopLevelWindowMSW::~wxTopLevelWindowMSW()
 377 {
 378     wxTopLevelWindows.DeleteObject(this);
 379
 380     if ( wxModelessWindows.Find(this) )
 381         wxModelessWindows.DeleteObject(this);
 382
 383     // If this is the last top-level window, exit.
 384     if ( wxTheApp && (wxTopLevelWindows.Number() == 0) )
 385     {
 386         wxTheApp->SetTopWindow(NULL);
 387
 388         if ( wxTheApp->GetExitOnFrameDelete() )
 389         {
 390             ::PostQuitMessage(0);
 391         }
 392     }
 393 }
 394
 395 // ----------------------------------------------------------------------------
 396 // wxTopLevelWindowMSW showing
 397 // ----------------------------------------------------------------------------
 398
 399 void wxTopLevelWindowMSW::DoShowWindow(int nShowCmd)
 400 {
 401     ::ShowWindow(GetHwnd(), nShowCmd);
 402
 403     m_iconized = nShowCmd == SW_MINIMIZE;
 404 }
 405
 406 bool wxTopLevelWindowMSW::Show(bool show)
 407 {
 408     // don't use wxWindow version as we want to call DoShowWindow() ourselves
 409     if ( !wxWindowBase::Show(show) )
 410         return FALSE;
 411
 412     int nShowCmd;
 413     if ( show )
 414     {
 415         if ( m_maximizeOnShow )
 416         {
 417             // show and maximize
 418             nShowCmd = SW_MAXIMIZE;
 419
 420             m_maximizeOnShow = FALSE;
 421         }
 422         else // just show
 423         {
 424             nShowCmd = SW_SHOW;
 425         }
 426     }
 427     else // hide
 428     {
 429         nShowCmd = SW_HIDE;
 430     }
 431
 432     DoShowWindow(nShowCmd);
 433
 434     if ( show )
 435     {
 436         ::BringWindowToTop(GetHwnd());
 437
 438         wxActivateEvent event(wxEVT_ACTIVATE, TRUE, m_windowId);
 439         event.SetEventObject( this );
 440         GetEventHandler()->ProcessEvent(event);
 441     }
 442     else // hide
 443     {
 444         // Try to highlight the correct window (the parent)
 445         if ( GetParent() )
 446         {
 447             HWND hWndParent = GetHwndOf(GetParent());
 448             if (hWndParent)
 449                 ::BringWindowToTop(hWndParent);
 450         }
 451     }
 452
 453     return TRUE;
 454 }
 455
 456 // ----------------------------------------------------------------------------
 457 // wxTopLevelWindowMSW maximize/minimize
 458 // ----------------------------------------------------------------------------
 459
 460 void wxTopLevelWindowMSW::Maximize(bool maximize)
 461 {
 462     if ( IsShown() )
 463     {
 464         // just maximize it directly
 465         DoShowWindow(maximize ? SW_MAXIMIZE : SW_RESTORE);
 466     }
 467     else // hidden
 468     {
 469         // we can't maximize the hidden frame because it shows it as well, so
 470         // just remember that we should do it later in this case
 471         m_maximizeOnShow = TRUE;
 472     }
 473 }
 474
 475 bool wxTopLevelWindowMSW::IsMaximized() const
 476 {
 477     return ::IsZoomed(GetHwnd()) != 0;
 478 }
 479
 480 void wxTopLevelWindowMSW::Iconize(bool iconize)
 481 {
 482     DoShowWindow(iconize ? SW_MINIMIZE : SW_RESTORE);
 483 }
 484
 485 bool wxTopLevelWindowMSW::IsIconized() const
 486 {
 487     // also update the current state
 488     ((wxTopLevelWindowMSW *)this)->m_iconized = ::IsIconic(GetHwnd()) != 0;
 489
 490     return m_iconized;
 491 }
 492
 493 void wxTopLevelWindowMSW::Restore()
 494 {
 495     DoShowWindow(SW_RESTORE);
 496 }
 497
 498 // ----------------------------------------------------------------------------
 499 // wxTopLevelWindowMSW fullscreen
 500 // ----------------------------------------------------------------------------
 501
 502 bool wxTopLevelWindowMSW::ShowFullScreen(bool show, long style)
 503 {
 504     if (show)
 505     {
 506         if (IsFullScreen())
 507             return FALSE;
 508
 509         m_fsIsShowing = TRUE;
 510         m_fsStyle = style;
 511
 512         // zap the frame borders
 513
 514         // save the 'normal' window style
 515         m_fsOldWindowStyle = GetWindowLong((HWND)GetHWND(), GWL_STYLE);
 516
 517         // save the old position, width & height, maximize state
 518         m_fsOldSize = GetRect();
 519         m_fsIsMaximized = IsMaximized();
 520
 521         // decide which window style flags to turn off
 522         LONG newStyle = m_fsOldWindowStyle;
 523         LONG offFlags = 0;
 524
 525         if (style & wxFULLSCREEN_NOBORDER)
 526             offFlags |= WS_BORDER | WS_THICKFRAME;
 527         if (style & wxFULLSCREEN_NOCAPTION)
 528             offFlags |= (WS_CAPTION | WS_SYSMENU);
 529
 530         newStyle &= (~offFlags);
 531
 532         // change our window style to be compatible with full-screen mode
 533         ::SetWindowLong((HWND)GetHWND(), GWL_STYLE, newStyle);
 534
 535         // resize to the size of the desktop
 536         int width, height;
 537
 538         RECT rect = wxGetWindowRect(::GetDesktopWindow());
 539         width = rect.right - rect.left;
 540         height = rect.bottom - rect.top;
 541
 542         SetSize(width, height);
 543
 544         // now flush the window style cache and actually go full-screen
 545         SetWindowPos((HWND)GetHWND(), HWND_TOP, 0, 0, width, height, SWP_FRAMECHANGED);
 546
 547         wxSizeEvent event(wxSize(width, height), GetId());
 548         GetEventHandler()->ProcessEvent(event);
 549
 550         return TRUE;
 551     }
 552     else
 553     {
 554         if (!IsFullScreen())
 555             return FALSE;
 556
 557         m_fsIsShowing = FALSE;
 558
 559         Maximize(m_fsIsMaximized);
 560         SetWindowLong((HWND)GetHWND(),GWL_STYLE, m_fsOldWindowStyle);
 561         SetWindowPos((HWND)GetHWND(),HWND_TOP,m_fsOldSize.x, m_fsOldSize.y,
 562             m_fsOldSize.width, m_fsOldSize.height, SWP_FRAMECHANGED);
 563
 564         return TRUE;
 565     }
 566 }
 567
 568 // ----------------------------------------------------------------------------
 569 // wxTopLevelWindowMSW misc
 570 // ----------------------------------------------------------------------------
 571
 572 void wxTopLevelWindowMSW::SetIcon(const wxIcon& icon)
 573 {
 574     // this sets m_icon
 575     wxTopLevelWindowBase::SetIcon(icon);
 576
 577 #if defined(__WIN95__) && !defined(__WXMICROWIN__)
 578     if ( m_icon.Ok() )
 579     {
 580         ::SendMessage(GetHwnd(), WM_SETICON,
 581                       (WPARAM)TRUE, (LPARAM)GetHiconOf(m_icon));
 582     }
 583 #endif // __WIN95__
 584 }
 585
 586 bool wxTopLevelWindowMSW::EnableCloseButton(bool enable)
 587 {
 588 #ifndef __WXMICROWIN__
 589     // get system (a.k.a. window) menu
 590     HMENU hmenu = ::GetSystemMenu(GetHwnd(), FALSE /* get it */);
 591     if ( !hmenu )
 592     {
 593         wxLogLastError(_T("GetSystemMenu"));
 594
 595         return FALSE;
 596     }
 597
 598     // enabling/disabling the close item from it also automatically
 599     // disables/enables the close title bar button
 600     if ( ::EnableMenuItem(hmenu, SC_CLOSE,
 601                           MF_BYCOMMAND |
 602                           (enable ? MF_ENABLED : MF_GRAYED)) == -1 )
 603     {
 604         wxLogLastError(_T("EnableMenuItem(SC_CLOSE)"));
 605
 606         return FALSE;
 607     }
 608
 609     // update appearance immediately
 610     if ( !::DrawMenuBar(GetHwnd()) )
 611     {
 612         wxLogLastError(_T("DrawMenuBar"));
 613     }
 614 #endif // !__WXMICROWIN__
 615
 616     return TRUE;
 617 }
 618