src/msw/dialog.cpp

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        src/msw/dialog.cpp
   3 // Purpose:     wxDialog class
   4 // Author:      Julian Smart
   5 // Modified by:
   6 // Created:     01/02/97
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) Julian Smart and Markus Holzem
   9 // Licence:     wxWindows licence
  10 /////////////////////////////////////////////////////////////////////////////
  11
  12 // ============================================================================
  13 // declarations
  14 // ============================================================================
  15
  16 // ----------------------------------------------------------------------------
  17 // headers
  18 // ----------------------------------------------------------------------------
  19
  20 #ifdef __GNUG__
  21     #pragma implementation "dialog.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/dialog.h"
  33     #include "wx/utils.h"
  34     #include "wx/frame.h"
  35     #include "wx/app.h"
  36     #include "wx/settings.h"
  37     #include "wx/intl.h"
  38     #include "wx/log.h"
  39 #endif
  40
  41 #include "wx/msw/private.h"
  42 #include "wx/log.h"
  43
  44 #if wxUSE_COMMON_DIALOGS
  45     #include <commdlg.h>
  46 #endif
  47
  48 // ----------------------------------------------------------------------------
  49 // constants
  50 // ----------------------------------------------------------------------------
  51
  52 // default dialog pos and size
  53
  54 #define wxDIALOG_DEFAULT_X 300
  55 #define wxDIALOG_DEFAULT_Y 300
  56
  57 #define wxDIALOG_DEFAULT_WIDTH 500
  58 #define wxDIALOG_DEFAULT_HEIGHT 500
  59
  60 // ----------------------------------------------------------------------------
  61 // globals
  62 // ----------------------------------------------------------------------------
  63
  64 // all objects to be deleted during next idle processing - from window.cpp
  65 extern wxList WXDLLEXPORT wxPendingDelete;
  66
  67 // all frames and modeless dialogs - not static, used in frame.cpp, mdi.cpp &c
  68 wxWindowList wxModelessWindows;
  69
  70 // all modal dialogs currently shown
  71 static wxWindowList wxModalDialogs;
  72
  73 // ----------------------------------------------------------------------------
  74 // wxWin macros
  75 // ----------------------------------------------------------------------------
  76
  77 IMPLEMENT_DYNAMIC_CLASS(wxDialog, wxPanel)
  78
  79 BEGIN_EVENT_TABLE(wxDialog, wxPanel)
  80     EVT_BUTTON(wxID_OK, wxDialog::OnOK)
  81     EVT_BUTTON(wxID_APPLY, wxDialog::OnApply)
  82     EVT_BUTTON(wxID_CANCEL, wxDialog::OnCancel)
  83
  84     EVT_CHAR_HOOK(wxDialog::OnCharHook)
  85
  86     EVT_SYS_COLOUR_CHANGED(wxDialog::OnSysColourChanged)
  87
  88     EVT_CLOSE(wxDialog::OnCloseWindow)
  89 END_EVENT_TABLE()
  90
  91 // ============================================================================
  92 // implementation
  93 // ============================================================================
  94
  95 // ----------------------------------------------------------------------------
  96 // wxDialog construction
  97 // ----------------------------------------------------------------------------
  98
  99 void wxDialog::Init()
 100 {
 101     m_oldFocus = (wxWindow *)NULL;
 102
 103     m_isShown = FALSE;
 104
 105     m_windowDisabler = (wxWindowDisabler *)NULL;
 106
 107     SetBackgroundColour(wxSystemSettings::GetSystemColour(wxSYS_COLOUR_3DFACE));
 108 }
 109
 110 bool wxDialog::Create(wxWindow *parent, wxWindowID id,
 111                       const wxString& title,
 112                       const wxPoint& pos,
 113                       const wxSize& size,
 114                       long style,
 115                       const wxString& name)
 116 {
 117     Init();
 118
 119     m_oldFocus = FindFocus();
 120
 121     SetName(name);
 122
 123     wxTopLevelWindows.Append(this);
 124
 125     //  windowFont = wxTheFontList->FindOrCreateFont(11, wxSWISS, wxNORMAL, wxNORMAL);
 126
 127     if (parent) parent->AddChild(this);
 128
 129     if ( id == -1 )
 130         m_windowId = (int)NewControlId();
 131     else
 132         m_windowId = id;
 133
 134     int x = pos.x;
 135     int y = pos.y;
 136     int width = size.x;
 137     int height = size.y;
 138
 139     if (x < 0)
 140         x = wxDIALOG_DEFAULT_X;
 141     if (y < 0)
 142         y = wxDIALOG_DEFAULT_Y;
 143
 144     m_windowStyle = style;
 145
 146     if (width < 0)
 147         width = wxDIALOG_DEFAULT_WIDTH;
 148     if (height < 0)
 149         height = wxDIALOG_DEFAULT_HEIGHT;
 150
 151     // All dialogs should really have this style
 152     m_windowStyle |= wxTAB_TRAVERSAL;
 153
 154     WXDWORD extendedStyle = MakeExtendedStyle(m_windowStyle);
 155     if (m_windowStyle & wxSTAY_ON_TOP)
 156         extendedStyle |= WS_EX_TOPMOST;
 157
 158 #ifndef __WIN16__
 159     if (m_exStyle & wxDIALOG_EX_CONTEXTHELP)
 160         extendedStyle |= WS_EX_CONTEXTHELP;
 161 #endif
 162     // Allows creation of dialogs with & without captions under MSWindows,
 163     // resizeable or not (but a resizeable dialog always has caption -
 164     // otherwise it would look too strange)
 165     const wxChar *dlg;
 166     if ( style & wxRESIZE_BORDER )
 167         dlg = wxT("wxResizeableDialog");
 168     else if ( style & wxCAPTION )
 169         dlg = wxT("wxCaptionDialog");
 170     else
 171         dlg = wxT("wxNoCaptionDialog");
 172     MSWCreate(m_windowId, parent, NULL, this, NULL,
 173               x, y, width, height,
 174               0, // style is not used if we have dlg template
 175               dlg,
 176               extendedStyle);
 177
 178     HWND hwnd = (HWND)GetHWND();
 179
 180     if ( !hwnd )
 181     {
 182         wxFAIL_MSG(_("Failed to create dialog. You probably forgot to include wx/msw/wx.rc in your resources."));
 183
 184         return FALSE;
 185     }
 186
 187     SubclassWin(GetHWND());
 188
 189     SetWindowText(hwnd, title);
 190     SetFont(wxSystemSettings::GetSystemFont(wxSYS_DEFAULT_GUI_FONT));
 191
 192     return TRUE;
 193 }
 194
 195 void wxDialog::SetModal(bool flag)
 196 {
 197     if ( flag )
 198     {
 199         m_windowStyle |= wxDIALOG_MODAL;
 200
 201         wxModelessWindows.DeleteObject(this);
 202     }
 203     else
 204     {
 205         m_windowStyle &= ~wxDIALOG_MODAL;
 206
 207         wxModelessWindows.Append(this);
 208     }
 209 }
 210
 211 wxDialog::~wxDialog()
 212 {
 213     m_isBeingDeleted = TRUE;
 214
 215     wxTopLevelWindows.DeleteObject(this);
 216
 217     // this will also reenable all the other windows for a modal dialog
 218     Show(FALSE);
 219
 220     if ( !IsModal() )
 221         wxModelessWindows.DeleteObject(this);
 222
 223     // If this is the last top-level window, exit.
 224     if ( wxTheApp && (wxTopLevelWindows.Number() == 0) )
 225     {
 226         wxTheApp->SetTopWindow(NULL);
 227
 228         if ( wxTheApp->GetExitOnFrameDelete() )
 229         {
 230             ::PostQuitMessage(0);
 231         }
 232     }
 233 }
 234
 235 // ----------------------------------------------------------------------------
 236 // kbd handling
 237 // ----------------------------------------------------------------------------
 238
 239 // By default, pressing escape cancels the dialog
 240 void wxDialog::OnCharHook(wxKeyEvent& event)
 241 {
 242     if (GetHWND())
 243     {
 244         // "Esc" works as an accelerator for the "Cancel" button, but it
 245         // shouldn't close the dialog which doesn't have any cancel button
 246         if ( (event.m_keyCode == WXK_ESCAPE) && FindWindow(wxID_CANCEL) )
 247         {
 248             wxCommandEvent cancelEvent(wxEVT_COMMAND_BUTTON_CLICKED, wxID_CANCEL);
 249             cancelEvent.SetEventObject( this );
 250             GetEventHandler()->ProcessEvent(cancelEvent);
 251
 252             // ensure that there is another message for this window so the
 253             // ShowModal loop will exit and won't get stuck in GetMessage().
 254             ::PostMessage(GetHwnd(), WM_NULL, 0, 0);
 255
 256             return;
 257         }
 258     }
 259
 260     // We didn't process this event.
 261     event.Skip();
 262 }
 263
 264 // ----------------------------------------------------------------------------
 265 // Windows dialog boxes can't be iconized
 266 // ----------------------------------------------------------------------------
 267
 268 void wxDialog::Iconize(bool WXUNUSED(iconize))
 269 {
 270 }
 271
 272 bool wxDialog::IsIconized() const
 273 {
 274     return FALSE;
 275 }
 276
 277 // ----------------------------------------------------------------------------
 278 // size/position handling
 279 // ----------------------------------------------------------------------------
 280
 281 void wxDialog::DoSetClientSize(int width, int height)
 282 {
 283     HWND hWnd = (HWND) GetHWND();
 284     RECT rect;
 285     ::GetClientRect(hWnd, &rect);
 286
 287     RECT rect2;
 288     GetWindowRect(hWnd, &rect2);
 289
 290     // Find the difference between the entire window (title bar and all)
 291     // and the client area; add this to the new client size to move the
 292     // window
 293     int actual_width = rect2.right - rect2.left - rect.right + width;
 294     int actual_height = rect2.bottom - rect2.top - rect.bottom + height;
 295
 296     MoveWindow(hWnd, rect2.left, rect2.top, actual_width, actual_height, TRUE);
 297
 298     wxSizeEvent event(wxSize(actual_width, actual_height), m_windowId);
 299     event.SetEventObject( this );
 300     GetEventHandler()->ProcessEvent(event);
 301 }
 302
 303 void wxDialog::DoGetPosition(int *x, int *y) const
 304 {
 305     RECT rect;
 306     GetWindowRect(GetHwnd(), &rect);
 307
 308     if ( x )
 309         *x = rect.left;
 310     if ( y )
 311         *y = rect.top;
 312 }
 313
 314 // ----------------------------------------------------------------------------
 315 // showing the dialogs
 316 // ----------------------------------------------------------------------------
 317
 318 bool wxDialog::IsModal() const
 319 {
 320     return (GetWindowStyleFlag() & wxDIALOG_MODAL) != 0;
 321 }
 322
 323 bool wxDialog::IsModalShowing() const
 324 {
 325     return wxModalDialogs.Find((wxDialog *)this) != NULL; // const_cast
 326 }
 327
 328 void wxDialog::DoShowModal()
 329 {
 330     wxCHECK_RET( !IsModalShowing(), _T("DoShowModal() called twice") );
 331     wxCHECK_RET( IsModal(), _T("can't DoShowModal() modeless dialog") );
 332
 333     wxModalDialogs.Append(this);
 334
 335     wxWindow *parent = GetParent();
 336
 337     wxWindow* oldFocus = m_oldFocus;
 338
 339     // We have to remember the HWND because we need to check
 340     // the HWND still exists (oldFocus can be garbage when the dialog
 341     // exits, if it has been destroyed)
 342     HWND hwndOldFocus = 0;
 343     if (oldFocus)
 344         hwndOldFocus = (HWND) oldFocus->GetHWND();
 345
 346     // remember where the focus was
 347     if ( !oldFocus )
 348     {
 349         oldFocus = parent;
 350         if ( parent )
 351             hwndOldFocus = GetHwndOf(parent);
 352     }
 353
 354     // disable all other app windows
 355     wxASSERT_MSG( !m_windowDisabler, _T("disabling windows twice?") );
 356
 357     m_windowDisabler = new wxWindowDisabler(this);
 358
 359     // enter the modal loop
 360     while ( IsModalShowing() )
 361     {
 362 #if wxUSE_THREADS
 363         wxMutexGuiLeaveOrEnter();
 364 #endif // wxUSE_THREADS
 365
 366         while ( !wxTheApp->Pending() && wxTheApp->ProcessIdle() )
 367             ;
 368
 369         // a message came or no more idle processing to do
 370         wxTheApp->DoMessage();
 371     }
 372
 373 #if 0 //def __WIN32__
 374     if ( parent )
 375         ::SetActiveWindow(GetHwndOf(parent));
 376 #endif // __WIN32__
 377
 378     // and restore focus
 379     // Note that this code MUST NOT access the dialog object's data
 380     // in case the object has been deleted (which will be the case
 381     // for a modal dialog that has been destroyed before calling EndModal).
 382     if ( oldFocus && (oldFocus != this) && ::IsWindow(hwndOldFocus))
 383     {
 384         // This is likely to prove that the object still exists
 385         if (wxFindWinFromHandle((WXHWND) hwndOldFocus) == oldFocus)
 386             oldFocus->SetFocus();
 387     }
 388 }
 389
 390 bool wxDialog::Show(bool show)
 391 {
 392     if ( !show )
 393     {
 394         // if we had disabled other app windows, reenable them back now because
 395         // if they stay disabled Windows will activate another window (one
 396         // which is enabled, anyhow) and we will lose activation
 397         if ( m_windowDisabler )
 398         {
 399             delete m_windowDisabler;
 400             m_windowDisabler = NULL;
 401         }
 402     }
 403
 404     // ShowModal() may be called for already shown dialog
 405     if ( !wxDialogBase::Show(show) && !(show && IsModal()) )
 406     {
 407         // nothing to do
 408         return FALSE;
 409     }
 410
 411     if ( show )
 412     {
 413         // usually will result in TransferDataToWindow() being called
 414         InitDialog();
 415     }
 416
 417     if ( IsModal() )
 418     {
 419         if ( show )
 420         {
 421             // modal dialog needs a parent window, so try to find one
 422             if ( !GetParent() )
 423             {
 424                 wxWindow *parent = wxTheApp->GetTopWindow();
 425                 if ( parent && parent != this && parent->IsShown() )
 426                 {
 427                     // use it
 428                     m_parent = parent;
 429                 }
 430             }
 431
 432             DoShowModal();
 433         }
 434         else // end of modal dialog
 435         {
 436             // this will cause IsModalShowing() return FALSE and our local
 437             // message loop will terminate
 438             wxModalDialogs.DeleteObject(this);
 439         }
 440     }
 441
 442     return TRUE;
 443 }
 444
 445 // a special version for Show(TRUE) for modal dialogs which returns return code
 446 int wxDialog::ShowModal()
 447 {
 448     if ( !IsModal() )
 449     {
 450         SetModal(TRUE);
 451     }
 452
 453     Show(TRUE);
 454
 455     return GetReturnCode();
 456 }
 457
 458 // NB: this function (surprizingly) may be called for both modal and modeless
 459 //     dialogs and should work for both of them
 460 void wxDialog::EndModal(int retCode)
 461 {
 462     SetReturnCode(retCode);
 463
 464     Show(FALSE);
 465 }
 466
 467 // ----------------------------------------------------------------------------
 468 // wxWin event handlers
 469 // ----------------------------------------------------------------------------
 470
 471 // Standard buttons
 472 void wxDialog::OnOK(wxCommandEvent& event)
 473 {
 474   if ( Validate() && TransferDataFromWindow() )
 475   {
 476       EndModal(wxID_OK);
 477   }
 478 }
 479
 480 void wxDialog::OnApply(wxCommandEvent& event)
 481 {
 482     if ( Validate() )
 483         TransferDataFromWindow();
 484
 485     // TODO probably need to disable the Apply button until things change again
 486 }
 487
 488 void wxDialog::OnCancel(wxCommandEvent& event)
 489 {
 490     EndModal(wxID_CANCEL);
 491 }
 492
 493 void wxDialog::OnCloseWindow(wxCloseEvent& event)
 494 {
 495     // We'll send a Cancel message by default, which may close the dialog.
 496     // Check for looping if the Cancel event handler calls Close().
 497
 498     // Note that if a cancel button and handler aren't present in the dialog,
 499     // nothing will happen when you close the dialog via the window manager, or
 500     // via Close(). We wouldn't want to destroy the dialog by default, since
 501     // the dialog may have been created on the stack. However, this does mean
 502     // that calling dialog->Close() won't delete the dialog unless the handler
 503     // for wxID_CANCEL does so. So use Destroy() if you want to be sure to
 504     // destroy the dialog. The default OnCancel (above) simply ends a modal
 505     // dialog, and hides a modeless dialog.
 506
 507     // VZ: this is horrible and MT-unsafe. Can't we reuse some of these global
 508     //     lists here? don't dare to change it now, but should be done later!
 509     static wxList closing;
 510
 511     if ( closing.Member(this) )
 512         return;
 513
 514     closing.Append(this);
 515
 516     wxCommandEvent cancelEvent(wxEVT_COMMAND_BUTTON_CLICKED, wxID_CANCEL);
 517     cancelEvent.SetEventObject( this );
 518     GetEventHandler()->ProcessEvent(cancelEvent); // This may close the dialog
 519
 520     closing.DeleteObject(this);
 521 }
 522
 523 // Destroy the window (delayed, if a managed window)
 524 bool wxDialog::Destroy()
 525 {
 526     wxCHECK_MSG( !wxPendingDelete.Member(this), FALSE,
 527                  _T("wxDialog destroyed twice") );
 528
 529     wxPendingDelete.Append(this);
 530
 531     return TRUE;
 532 }
 533
 534 void wxDialog::OnSysColourChanged(wxSysColourChangedEvent& event)
 535 {
 536 #if wxUSE_CTL3D
 537     Ctl3dColorChange();
 538 #else
 539     SetBackgroundColour(wxSystemSettings::GetSystemColour(wxSYS_COLOUR_3DFACE));
 540     Refresh();
 541 #endif
 542 }
 543
 544 // ---------------------------------------------------------------------------
 545 // dialog window proc
 546 // ---------------------------------------------------------------------------
 547
 548 long wxDialog::MSWWindowProc(WXUINT message, WXWPARAM wParam, WXLPARAM lParam)
 549 {
 550     long rc = 0;
 551     bool processed = FALSE;
 552
 553     switch ( message )
 554     {
 555 #if 0 // now that we got owner window right it doesn't seem to be needed
 556         case WM_ACTIVATE:
 557             switch ( LOWORD(wParam) )
 558             {
 559                 case WA_ACTIVE:
 560                 case WA_CLICKACTIVE:
 561                     if ( IsModalShowing() && GetParent() )
 562                     {
 563                         // bring the owner window to top as the standard dialog
 564                         // boxes do
 565                         if ( !::SetWindowPos
 566                                 (
 567                                     GetHwndOf(GetParent()),
 568                                     GetHwnd(),
 569                                     0, 0,
 570                                     0, 0,
 571                                     SWP_NOACTIVATE |
 572                                     SWP_NOMOVE |
 573                                     SWP_NOSIZE
 574                                 ) )
 575                         {
 576                             wxLogLastError(wxT("SetWindowPos(SWP_NOACTIVATE)"));
 577                         }
 578                     }
 579                     // fall through to process it normally as well
 580             }
 581             break;
 582 #endif // 0
 583
 584         case WM_CLOSE:
 585             // if we can't close, tell the system that we processed the
 586             // message - otherwise it would close us
 587             processed = !Close();
 588             break;
 589
 590         case WM_SETCURSOR:
 591             // we want to override the busy cursor for modal dialogs:
 592             // typically, wxBeginBusyCursor() is called and then a modal dialog
 593             // is shown, but the modal dialog shouldn't have hourglass cursor
 594             if ( IsModalShowing() && wxIsBusy() )
 595             {
 596                 // set our cursor for all windows (but see below)
 597                 wxCursor cursor = m_cursor;
 598                 if ( !cursor.Ok() )
 599                     cursor = wxCURSOR_ARROW;
 600
 601                 ::SetCursor(GetHcursorOf(cursor));
 602
 603                 // in any case, stop here and don't let wxWindow process this
 604                 // message (it would set the busy cursor)
 605                 processed = TRUE;
 606
 607                 // but return FALSE to tell the child window (if the event
 608                 // comes from one of them and not from ourselves) that it can
 609                 // set its own cursor if it has one: thus, standard controls
 610                 // (e.g. text ctrl) still have correct cursors in a dialog
 611                 // invoked while wxIsBusy()
 612                 rc = FALSE;
 613             }
 614             break;
 615     }
 616
 617     if ( !processed )
 618         rc = wxWindow::MSWWindowProc(message, wParam, lParam);
 619
 620     return rc;
 621 }
 622
 623 #if wxUSE_CTL3D
 624
 625 // Define for each class of dialog and control
 626 WXHBRUSH wxDialog::OnCtlColor(WXHDC WXUNUSED(pDC),
 627                               WXHWND WXUNUSED(pWnd),
 628                               WXUINT WXUNUSED(nCtlColor),
 629                               WXUINT message,
 630                               WXWPARAM wParam,
 631                               WXLPARAM lParam)
 632 {
 633     return (WXHBRUSH)Ctl3dCtlColorEx(message, wParam, lParam);
 634 }
 635
 636 #endif // wxUSE_CTL3D
 637