src/msw/app.cpp

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        src/msw/app.cpp
   3 // Purpose:     wxApp
   4 // Author:      Julian Smart
   5 // Modified by:
   6 // Created:     04/01/98
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) Julian Smart
   9 // Licence:     wxWindows licence
  10 /////////////////////////////////////////////////////////////////////////////
  11
  12 // ===========================================================================
  13 // declarations
  14 // ===========================================================================
  15
  16 // ---------------------------------------------------------------------------
  17 // headers
  18 // ---------------------------------------------------------------------------
  19
  20 // For compilers that support precompilation, includes "wx.h".
  21 #include "wx/wxprec.h"
  22
  23 #if defined(__BORLANDC__)
  24     #pragma hdrstop
  25 #endif
  26
  27 #ifndef WX_PRECOMP
  28     #include "wx/msw/wrapcctl.h"
  29     #include "wx/dynarray.h"
  30     #include "wx/frame.h"
  31     #include "wx/app.h"
  32     #include "wx/utils.h"
  33     #include "wx/gdicmn.h"
  34     #include "wx/pen.h"
  35     #include "wx/brush.h"
  36     #include "wx/cursor.h"
  37     #include "wx/icon.h"
  38     #include "wx/palette.h"
  39     #include "wx/dc.h"
  40     #include "wx/dialog.h"
  41     #include "wx/msgdlg.h"
  42     #include "wx/intl.h"
  43     #include "wx/crt.h"
  44     #include "wx/log.h"
  45     #include "wx/module.h"
  46 #endif
  47
  48 #include "wx/apptrait.h"
  49 #include "wx/filename.h"
  50 #include "wx/dynlib.h"
  51 #include "wx/evtloop.h"
  52 #include "wx/thread.h"
  53 #include "wx/scopeguard.h"
  54 #include "wx/vector.h"
  55
  56 #include "wx/msw/private.h"
  57 #include "wx/msw/dc.h"
  58 #include "wx/msw/ole/oleutils.h"
  59 #include "wx/msw/private/timer.h"
  60
  61 #if wxUSE_TOOLTIPS
  62     #include "wx/tooltip.h"
  63 #endif // wxUSE_TOOLTIPS
  64
  65 // OLE is used for drag-and-drop, clipboard, OLE Automation..., but some
  66 // compilers don't support it (missing headers, libs, ...)
  67 #if defined(__GNUWIN32_OLD__) || defined(__SYMANTEC__)
  68     #undef wxUSE_OLE
  69
  70     #define  wxUSE_OLE 0
  71 #endif // broken compilers
  72
  73 #if defined(__POCKETPC__) || defined(__SMARTPHONE__)
  74     #include <ole2.h>
  75     #include <aygshell.h>
  76 #endif
  77
  78 #if wxUSE_OLE
  79     #include <ole2.h>
  80 #endif
  81
  82 #include <string.h>
  83 #include <ctype.h>
  84
  85 #include "wx/msw/missing.h"
  86
  87 // instead of including <shlwapi.h> which is not part of the core SDK and not
  88 // shipped at all with other compilers, we always define the parts of it we
  89 // need here ourselves
  90 //
  91 // NB: DLLVER_PLATFORM_WINDOWS will be defined if shlwapi.h had been somehow
  92 //     included already
  93 #ifndef DLLVER_PLATFORM_WINDOWS
  94     // hopefully we don't need to change packing as DWORDs should be already
  95     // correctly aligned
  96     struct DLLVERSIONINFO
  97     {
  98         DWORD cbSize;
  99         DWORD dwMajorVersion;                   // Major version
 100         DWORD dwMinorVersion;                   // Minor version
 101         DWORD dwBuildNumber;                    // Build number
 102         DWORD dwPlatformID;                     // DLLVER_PLATFORM_*
 103     };
 104
 105     typedef HRESULT (CALLBACK* DLLGETVERSIONPROC)(DLLVERSIONINFO *);
 106 #endif // defined(DLLVERSIONINFO)
 107
 108 #ifndef ATTACH_PARENT_PROCESS
 109     #define ATTACH_PARENT_PROCESS ((DWORD)-1)
 110 #endif
 111
 112 // ---------------------------------------------------------------------------
 113 // global variables
 114 // ---------------------------------------------------------------------------
 115
 116 #if !defined(__WXMICROWIN__) && !defined(__WXWINCE__)
 117 extern void wxSetKeyboardHook(bool doIt);
 118 #endif
 119
 120 namespace
 121 {
 122
 123 struct ClassRegInfo
 124 {
 125     // the base name of the class: this is used to construct the unique name in
 126     // RegisterClassWithUniqueNames()
 127     wxString basename;
 128
 129     // the name of the registered class with and without CS_[HV]REDRAW styles
 130     wxString regname,
 131              regnameNR;
 132 };
 133
 134 wxVector<ClassRegInfo> gs_regClassesInfo;
 135
 136 } // anonymous namespace
 137
 138 // ----------------------------------------------------------------------------
 139 // private functions
 140 // ----------------------------------------------------------------------------
 141
 142 LRESULT WXDLLEXPORT APIENTRY wxWndProc(HWND, UINT, WPARAM, LPARAM);
 143
 144 // ===========================================================================
 145 // wxGUIAppTraits implementation
 146 // ===========================================================================
 147
 148 // private class which we use to pass parameters from BeforeChildWaitLoop() to
 149 // AfterChildWaitLoop()
 150 struct ChildWaitLoopData
 151 {
 152     ChildWaitLoopData(wxWindowDisabler *wd_, wxWindow *winActive_)
 153     {
 154         wd = wd_;
 155         winActive = winActive_;
 156     }
 157
 158     wxWindowDisabler *wd;
 159     wxWindow *winActive;
 160 };
 161
 162 void *wxGUIAppTraits::BeforeChildWaitLoop()
 163 {
 164     /*
 165        We use a dirty hack here to disable all application windows (which we
 166        must do because otherwise the calls to wxYield() could lead to some very
 167        unexpected reentrancies in the users code) but to avoid losing
 168        focus/activation entirely when the child process terminates which would
 169        happen if we simply disabled everything using wxWindowDisabler. Indeed,
 170        remember that Windows will never activate a disabled window and when the
 171        last childs window is closed and Windows looks for a window to activate
 172        all our windows are still disabled. There is no way to enable them in
 173        time because we don't know when the childs windows are going to be
 174        closed, so the solution we use here is to keep one special tiny frame
 175        enabled all the time. Then when the child terminates it will get
 176        activated and when we close it below -- after reenabling all the other
 177        windows! -- the previously active window becomes activated again and
 178        everything is ok.
 179      */
 180     wxBeginBusyCursor();
 181
 182     // first disable all existing windows
 183     wxWindowDisabler *wd = new wxWindowDisabler;
 184
 185     // then create an "invisible" frame: it has minimal size, is positioned
 186     // (hopefully) outside the screen and doesn't appear on the taskbar
 187     wxWindow *winActive = new wxFrame
 188                     (
 189                         wxTheApp->GetTopWindow(),
 190                         wxID_ANY,
 191                         wxEmptyString,
 192                         wxPoint(32600, 32600),
 193                         wxSize(1, 1),
 194                         wxDEFAULT_FRAME_STYLE | wxFRAME_NO_TASKBAR
 195                     );
 196     winActive->Show();
 197
 198     return new ChildWaitLoopData(wd, winActive);
 199 }
 200
 201 void wxGUIAppTraits::AlwaysYield()
 202 {
 203     wxYield();
 204 }
 205
 206 void wxGUIAppTraits::AfterChildWaitLoop(void *dataOrig)
 207 {
 208     wxEndBusyCursor();
 209
 210     ChildWaitLoopData * const data = (ChildWaitLoopData *)dataOrig;
 211
 212     delete data->wd;
 213
 214     // finally delete the dummy frame and, as wd has been already destroyed and
 215     // the other windows reenabled, the activation is going to return to the
 216     // window which had had it before
 217     data->winActive->Destroy();
 218
 219     // also delete the temporary data object itself
 220     delete data;
 221 }
 222
 223 bool wxGUIAppTraits::DoMessageFromThreadWait()
 224 {
 225     // we should return false only if the app should exit, i.e. only if
 226     // Dispatch() determines that the main event loop should terminate
 227     wxEventLoopBase * const evtLoop = wxEventLoop::GetActive();
 228     if ( !evtLoop || !evtLoop->Pending() )
 229     {
 230         // no events means no quit event
 231         return true;
 232     }
 233
 234     return evtLoop->Dispatch();
 235 }
 236
 237 DWORD wxGUIAppTraits::WaitForThread(WXHANDLE hThread)
 238 {
 239     // if we don't have a running event loop, we shouldn't wait for the
 240     // messages as we never remove them from the message queue and so we enter
 241     // an infinite loop as MsgWaitForMultipleObjects() keeps returning
 242     // WAIT_OBJECT_0 + 1
 243     if ( !wxEventLoop::GetActive() )
 244         return DoSimpleWaitForThread(hThread);
 245
 246     return ::MsgWaitForMultipleObjects
 247              (
 248                1,                   // number of objects to wait for
 249                (HANDLE *)&hThread,  // the objects
 250                false,               // wait for any objects, not all
 251                INFINITE,            // no timeout
 252                QS_ALLINPUT |        // return as soon as there are any events
 253                QS_ALLPOSTMESSAGE
 254              );
 255 }
 256
 257 wxPortId wxGUIAppTraits::GetToolkitVersion(int *majVer, int *minVer) const
 258 {
 259     OSVERSIONINFO info;
 260     wxZeroMemory(info);
 261
 262     // on Windows, the toolkit version is the same of the OS version
 263     // as Windows integrates the OS kernel with the GUI toolkit.
 264     info.dwOSVersionInfoSize = sizeof(OSVERSIONINFO);
 265     if ( ::GetVersionEx(&info) )
 266     {
 267         if ( majVer )
 268             *majVer = info.dwMajorVersion;
 269         if ( minVer )
 270             *minVer = info.dwMinorVersion;
 271     }
 272
 273 #if defined(__WXHANDHELD__) || defined(__WXWINCE__)
 274     return wxPORT_WINCE;
 275 #else
 276     return wxPORT_MSW;
 277 #endif
 278 }
 279
 280 #if wxUSE_TIMER
 281
 282 wxTimerImpl *wxGUIAppTraits::CreateTimerImpl(wxTimer *timer)
 283 {
 284     return new wxMSWTimerImpl(timer);
 285 }
 286
 287 #endif // wxUSE_TIMER
 288
 289 wxEventLoopBase* wxGUIAppTraits::CreateEventLoop()
 290 {
 291     return new wxEventLoop;
 292 }
 293
 294 // ---------------------------------------------------------------------------
 295 // Stuff for using console from the GUI applications
 296 // ---------------------------------------------------------------------------
 297
 298 #ifndef __WXWINCE__
 299
 300 #include <wx/dynlib.h>
 301
 302 namespace
 303 {
 304
 305 /*
 306     Helper class to manipulate console from a GUI app.
 307
 308     Notice that console output is available in the GUI app only if:
 309     - AttachConsole() returns TRUE (which means it never works under pre-XP)
 310     - we have a valid STD_ERROR_HANDLE
 311     - command history hasn't been changed since our startup
 312
 313     To check if all these conditions are verified, you need to simple call
 314     IsOkToUse(). It will check the first two conditions above the first time it
 315     is called (and if this fails, the subsequent calls will return immediately)
 316     and also recheck the last one every time it is called.
 317  */
 318 class wxConsoleStderr
 319 {
 320 public:
 321     // default ctor does nothing, call Init() before using this class
 322     wxConsoleStderr()
 323     {
 324         m_hStderr = INVALID_HANDLE_VALUE;
 325         m_historyLen =
 326         m_dataLen =
 327         m_dataLine = 0;
 328
 329         m_ok = -1;
 330     }
 331
 332     ~wxConsoleStderr()
 333     {
 334         if ( m_hStderr != INVALID_HANDLE_VALUE )
 335         {
 336             if ( !::FreeConsole() )
 337             {
 338                 wxLogLastError(_T("FreeConsole"));
 339             }
 340         }
 341     }
 342
 343     // return true if we were successfully initialized and there had been no
 344     // console activity which would interfere with our output since then
 345     bool IsOkToUse() const
 346     {
 347         if ( m_ok == -1 )
 348         {
 349             wxConsoleStderr * const self = const_cast<wxConsoleStderr *>(this);
 350             self->m_ok = self->DoInit();
 351
 352             // no need to call IsHistoryUnchanged() as we just initialized
 353             // m_history anyhow
 354             return m_ok == 1;
 355         }
 356
 357         return m_ok && IsHistoryUnchanged();
 358     }
 359
 360
 361     // output the provided text on the console, return true if ok
 362     bool Write(const wxString& text);
 363
 364 private:
 365     // called by Init() once only to do the real initialization
 366     bool DoInit();
 367
 368     // retrieve the command line history into the provided buffer and return
 369     // its length
 370     int GetCommandHistory(wxWxCharBuffer& buf) const;
 371
 372     // check if the console history has changed
 373     bool IsHistoryUnchanged() const;
 374
 375     int m_ok;                   // initially -1, set to true or false by Init()
 376
 377     wxDynamicLibrary m_dllKernel32;
 378
 379     HANDLE m_hStderr;           // console handle, if it's valid we must call
 380                                 // FreeConsole() (even if m_ok != 1)
 381
 382     wxWxCharBuffer m_history;   // command history on startup
 383     int m_historyLen;           // length command history buffer
 384
 385     wxCharBuffer m_data;        // data between empty line and cursor position
 386     int m_dataLen;              // length data buffer
 387     int m_dataLine;             // line offset
 388
 389     typedef DWORD (WINAPI *GetConsoleCommandHistory_t)(LPTSTR sCommands,
 390                                                        DWORD nBufferLength,
 391                                                        LPCTSTR sExeName);
 392     typedef DWORD (WINAPI *GetConsoleCommandHistoryLength_t)(LPCTSTR sExeName);
 393
 394     GetConsoleCommandHistory_t m_pfnGetConsoleCommandHistory;
 395     GetConsoleCommandHistoryLength_t m_pfnGetConsoleCommandHistoryLength;
 396
 397     DECLARE_NO_COPY_CLASS(wxConsoleStderr)
 398 };
 399
 400 bool wxConsoleStderr::DoInit()
 401 {
 402     HANDLE hStderr = ::GetStdHandle(STD_ERROR_HANDLE);
 403
 404     if ( hStderr == INVALID_HANDLE_VALUE || !hStderr )
 405         return false;
 406
 407     if ( !m_dllKernel32.Load(_T("kernel32.dll")) )
 408         return false;
 409
 410     typedef BOOL (WINAPI *AttachConsole_t)(DWORD dwProcessId);
 411     AttachConsole_t wxDL_INIT_FUNC(pfn, AttachConsole, m_dllKernel32);
 412
 413     if ( !pfnAttachConsole || !pfnAttachConsole(ATTACH_PARENT_PROCESS) )
 414         return false;
 415
 416     // console attached, set m_hStderr now to ensure that we free it in the
 417     // dtor
 418     m_hStderr = hStderr;
 419
 420     wxDL_INIT_FUNC_AW(m_pfn, GetConsoleCommandHistory, m_dllKernel32);
 421     if ( !m_pfnGetConsoleCommandHistory )
 422         return false;
 423
 424     wxDL_INIT_FUNC_AW(m_pfn, GetConsoleCommandHistoryLength, m_dllKernel32);
 425     if ( !m_pfnGetConsoleCommandHistoryLength )
 426         return false;
 427
 428     // remember the current command history to be able to compare with it later
 429     // in IsHistoryUnchanged()
 430     m_historyLen = GetCommandHistory(m_history);
 431     if ( !m_history )
 432         return false;
 433
 434
 435     // now find the first blank line above the current position
 436     CONSOLE_SCREEN_BUFFER_INFO csbi;
 437
 438     if ( !::GetConsoleScreenBufferInfo(m_hStderr, &csbi) )
 439     {
 440         wxLogLastError(_T("GetConsoleScreenBufferInfo"));
 441         return false;
 442     }
 443
 444     COORD pos;
 445     pos.X = 0;
 446     pos.Y = csbi.dwCursorPosition.Y + 1;
 447
 448     // we decide that a line is empty if first 4 characters are spaces
 449     DWORD ret;
 450     char buf[4];
 451     do
 452     {
 453         pos.Y--;
 454         if ( !::ReadConsoleOutputCharacterA(m_hStderr, buf, WXSIZEOF(buf),
 455                                             pos, &ret) )
 456         {
 457             wxLogLastError(_T("ReadConsoleOutputCharacterA"));
 458             return false;
 459         }
 460     } while ( wxStrncmp("    ", buf, WXSIZEOF(buf)) != 0 );
 461
 462     // calculate line offset and length of data
 463     m_dataLine = csbi.dwCursorPosition.Y - pos.Y;
 464     m_dataLen = m_dataLine*csbi.dwMaximumWindowSize.X + csbi.dwCursorPosition.X;
 465
 466     if ( m_dataLen > 0 )
 467     {
 468         m_data.extend(m_dataLen);
 469         if ( !::ReadConsoleOutputCharacterA(m_hStderr, m_data.data(), m_dataLen,
 470                                             pos, &ret) )
 471         {
 472             wxLogLastError(_T("ReadConsoleOutputCharacterA"));
 473             return false;
 474         }
 475     }
 476
 477     return true;
 478 }
 479
 480 int wxConsoleStderr::GetCommandHistory(wxWxCharBuffer& buf) const
 481 {
 482     // these functions are internal and may only be called by cmd.exe
 483     static const wxChar *CMD_EXE = _T("cmd.exe");
 484
 485     const int len = m_pfnGetConsoleCommandHistoryLength(CMD_EXE);
 486     if ( len )
 487     {
 488         buf.extend(len);
 489
 490         int len2 = m_pfnGetConsoleCommandHistory(buf.data(), len, CMD_EXE);
 491
 492 #if !wxUSE_UNICODE
 493         // there seems to be a bug in the GetConsoleCommandHistoryA(), it
 494         // returns the length of Unicode string and not ANSI one
 495         len2 /= 2;
 496 #endif // !wxUSE_UNICODE
 497
 498         if ( len2 != len )
 499         {
 500             wxFAIL_MSG( _T("failed getting history?") );
 501         }
 502     }
 503
 504     return len;
 505 }
 506
 507 bool wxConsoleStderr::IsHistoryUnchanged() const
 508 {
 509     wxASSERT_MSG( m_ok == 1, _T("shouldn't be called if not initialized") );
 510
 511     // get (possibly changed) command history
 512     wxWxCharBuffer history;
 513     const int historyLen = GetCommandHistory(history);
 514
 515     // and compare it with the original one
 516     return historyLen == m_historyLen && history &&
 517                 memcmp(m_history, history, historyLen) == 0;
 518 }
 519
 520 bool wxConsoleStderr::Write(const wxString& text)
 521 {
 522     wxASSERT_MSG( m_hStderr != INVALID_HANDLE_VALUE,
 523                     _T("should only be called if Init() returned true") );
 524
 525     // get current position
 526     CONSOLE_SCREEN_BUFFER_INFO csbi;
 527     if ( !::GetConsoleScreenBufferInfo(m_hStderr, &csbi) )
 528     {
 529         wxLogLastError(_T("GetConsoleScreenBufferInfo"));
 530         return false;
 531     }
 532
 533     // and calculate new position (where is empty line)
 534     csbi.dwCursorPosition.X = 0;
 535     csbi.dwCursorPosition.Y -= m_dataLine;
 536
 537     if ( !::SetConsoleCursorPosition(m_hStderr, csbi.dwCursorPosition) )
 538     {
 539         wxLogLastError(_T("SetConsoleCursorPosition"));
 540         return false;
 541     }
 542
 543     DWORD ret;
 544     if ( !::FillConsoleOutputCharacter(m_hStderr, _T(' '), m_dataLen,
 545                                        csbi.dwCursorPosition, &ret) )
 546     {
 547         wxLogLastError(_T("FillConsoleOutputCharacter"));
 548         return false;
 549     }
 550
 551     if ( !::WriteConsole(m_hStderr, text.wx_str(), text.length(), &ret, NULL) )
 552     {
 553         wxLogLastError(_T("WriteConsole"));
 554         return false;
 555     }
 556
 557     WriteConsoleA(m_hStderr, m_data, m_dataLen, &ret, 0);
 558
 559     return true;
 560 }
 561
 562 wxConsoleStderr s_consoleStderr;
 563
 564 } // anonymous namespace
 565
 566 bool wxGUIAppTraits::CanUseStderr()
 567 {
 568     return s_consoleStderr.IsOkToUse();
 569 }
 570
 571 bool wxGUIAppTraits::WriteToStderr(const wxString& text)
 572 {
 573     return s_consoleStderr.IsOkToUse() && s_consoleStderr.Write(text);
 574 }
 575
 576 #endif // !__WXWINCE__
 577
 578 // ===========================================================================
 579 // wxApp implementation
 580 // ===========================================================================
 581
 582 int wxApp::m_nCmdShow = SW_SHOWNORMAL;
 583
 584 // ---------------------------------------------------------------------------
 585 // wxWin macros
 586 // ---------------------------------------------------------------------------
 587
 588 IMPLEMENT_DYNAMIC_CLASS(wxApp, wxEvtHandler)
 589
 590 BEGIN_EVENT_TABLE(wxApp, wxEvtHandler)
 591     EVT_IDLE(wxApp::OnIdle)
 592     EVT_END_SESSION(wxApp::OnEndSession)
 593     EVT_QUERY_END_SESSION(wxApp::OnQueryEndSession)
 594 END_EVENT_TABLE()
 595
 596 // class to ensure that wxAppBase::CleanUp() is called if our Initialize()
 597 // fails
 598 class wxCallBaseCleanup
 599 {
 600 public:
 601     wxCallBaseCleanup(wxApp *app) : m_app(app) { }
 602     ~wxCallBaseCleanup() { if ( m_app ) m_app->wxAppBase::CleanUp(); }
 603
 604     void Dismiss() { m_app = NULL; }
 605
 606 private:
 607     wxApp *m_app;
 608 };
 609
 610 //// Initialize
 611 bool wxApp::Initialize(int& argc, wxChar **argv)
 612 {
 613     if ( !wxAppBase::Initialize(argc, argv) )
 614         return false;
 615
 616     // ensure that base cleanup is done if we return too early
 617     wxCallBaseCleanup callBaseCleanup(this);
 618
 619 #if !defined(__WXMICROWIN__)
 620     InitCommonControls();
 621 #endif // !defined(__WXMICROWIN__)
 622
 623 #if defined(__SMARTPHONE__) || defined(__POCKETPC__)
 624     SHInitExtraControls();
 625 #endif
 626
 627 #ifndef __WXWINCE__
 628     // Don't show a message box if a function such as SHGetFileInfo
 629     // fails to find a device.
 630     SetErrorMode(SEM_FAILCRITICALERRORS|SEM_NOOPENFILEERRORBOX);
 631 #endif
 632
 633     wxOleInitialize();
 634
 635 #if !defined(__WXMICROWIN__) && !defined(__WXWINCE__)
 636     wxSetKeyboardHook(true);
 637 #endif
 638
 639     callBaseCleanup.Dismiss();
 640
 641     return true;
 642 }
 643
 644 // ---------------------------------------------------------------------------
 645 // Win32 window class registration
 646 // ---------------------------------------------------------------------------
 647
 648 /* static */
 649 const wxChar *wxApp::GetRegisteredClassName(const wxChar *name,
 650                                             int bgBrushCol,
 651                                             int extraStyles)
 652 {
 653     const size_t count = gs_regClassesInfo.size();
 654     for ( size_t n = 0; n < count; n++ )
 655     {
 656         if ( gs_regClassesInfo[n].basename == name )
 657             return gs_regClassesInfo[n].regname;
 658     }
 659
 660     // we need to register this class
 661     WNDCLASS wndclass;
 662     wxZeroMemory(wndclass);
 663
 664     wndclass.lpfnWndProc   = (WNDPROC)wxWndProc;
 665     wndclass.hInstance     = wxhInstance;
 666     wndclass.hCursor       = ::LoadCursor(NULL, IDC_ARROW);
 667     wndclass.hbrBackground = (HBRUSH)wxUIntToPtr(bgBrushCol + 1);
 668     wndclass.style         = CS_HREDRAW | CS_VREDRAW | CS_DBLCLKS | extraStyles;
 669
 670
 671     ClassRegInfo regClass;
 672     regClass.basename = name;
 673
 674     // constuct a unique suffix to allow registering the class with the same
 675     // base name in a main application using wxWidgets and a DLL using
 676     // wxWidgets loaded into its address space: as gs_regClassesInfo variable
 677     // is different in them, we're going to obtain a unique prefix by using its
 678     // address here
 679     regClass.regname = regClass.basename +
 680                             wxString::Format(wxT("@%p"), &gs_regClassesInfo);
 681     wndclass.lpszClassName = regClass.regname.wx_str();
 682     if ( !::RegisterClass(&wndclass) )
 683     {
 684         wxLogLastError(wxString::Format(wxT("RegisterClass(%s)"),
 685                        regClass.regname));
 686         return NULL;
 687     }
 688
 689     // NB: remember that code elsewhere supposes that no redraw class names
 690     //     use the same names as normal classes with "NR" suffix so we must put
 691     //     "NR" at the end instead of using more natural basename+"NR"+suffix
 692     regClass.regnameNR = regClass.regname + GetNoRedrawClassSuffix();
 693     wndclass.style &= ~(CS_HREDRAW | CS_VREDRAW);
 694     wndclass.lpszClassName = regClass.regnameNR.wx_str();
 695     if ( !::RegisterClass(&wndclass) )
 696     {
 697         wxLogLastError(wxString::Format(wxT("RegisterClass(%s)"),
 698                        regClass.regname));
 699         ::UnregisterClass(regClass.regname, wxhInstance);
 700         return NULL;
 701     }
 702
 703     gs_regClassesInfo.push_back(regClass);
 704
 705     // take care to return the pointer which will remain valid after the
 706     // function returns (it could be invalidated later if new elements are
 707     // added to the vector and it's reallocated but this shouldn't matter as
 708     // this pointer should be used right now, not stored)
 709     return gs_regClassesInfo.back().regname.wx_str();
 710 }
 711
 712 bool wxApp::IsRegisteredClassName(const wxString& name)
 713 {
 714     const size_t count = gs_regClassesInfo.size();
 715     for ( size_t n = 0; n < count; n++ )
 716     {
 717         if ( gs_regClassesInfo[n].regname == name ||
 718                 gs_regClassesInfo[n].regnameNR == name )
 719             return true;
 720     }
 721
 722     return false;
 723 }
 724
 725 void wxApp::UnregisterWindowClasses()
 726 {
 727     const size_t count = gs_regClassesInfo.size();
 728     for ( size_t n = 0; n < count; n++ )
 729     {
 730         const ClassRegInfo& regClass = gs_regClassesInfo[n];
 731         if ( !::UnregisterClass(regClass.regname, wxhInstance) )
 732         {
 733             wxLogLastError(wxString::Format(wxT("UnregisterClass(%s)"),
 734                            regClass.regname));
 735         }
 736
 737         if ( !::UnregisterClass(regClass.regnameNR, wxhInstance) )
 738         {
 739             wxLogLastError(wxString::Format(wxT("UnregisterClass(%s)"),
 740                            regClass.regnameNR));
 741         }
 742     }
 743
 744     gs_regClassesInfo.clear();
 745 }
 746
 747 void wxApp::CleanUp()
 748 {
 749     // all objects pending for deletion must be deleted first, otherwise
 750     // UnregisterWindowClasses() call wouldn't succeed (because windows
 751     // using the classes being unregistered still exist), so call the base
 752     // class method first and only then do our clean up
 753     wxAppBase::CleanUp();
 754
 755 #if !defined(__WXMICROWIN__) && !defined(__WXWINCE__)
 756     wxSetKeyboardHook(false);
 757 #endif
 758
 759     wxOleUninitialize();
 760
 761     // for an EXE the classes are unregistered when it terminates but DLL may
 762     // be loaded several times (load/unload/load) into the same process in
 763     // which case the registration will fail after the first time if we don't
 764     // unregister the classes now
 765     UnregisterWindowClasses();
 766 }
 767
 768 // ----------------------------------------------------------------------------
 769 // wxApp ctor/dtor
 770 // ----------------------------------------------------------------------------
 771
 772 wxApp::wxApp()
 773 {
 774     m_printMode = wxPRINT_WINDOWS;
 775 }
 776
 777 wxApp::~wxApp()
 778 {
 779 }
 780
 781 // ----------------------------------------------------------------------------
 782 // wxApp idle handling
 783 // ----------------------------------------------------------------------------
 784
 785 void wxApp::OnIdle(wxIdleEvent& WXUNUSED(event))
 786 {
 787 #if wxUSE_DC_CACHEING
 788     // automated DC cache management: clear the cached DCs and bitmap
 789     // if it's likely that the app has finished with them, that is, we
 790     // get an idle event and we're not dragging anything.
 791     if (!::GetKeyState(MK_LBUTTON) && !::GetKeyState(MK_MBUTTON) && !::GetKeyState(MK_RBUTTON))
 792         wxMSWDCImpl::ClearCache();
 793 #endif // wxUSE_DC_CACHEING
 794 }
 795
 796 void wxApp::WakeUpIdle()
 797 {
 798     // Send the top window a dummy message so idle handler processing will
 799     // start up again.  Doing it this way ensures that the idle handler
 800     // wakes up in the right thread (see also wxWakeUpMainThread() which does
 801     // the same for the main app thread only)
 802     wxWindow * const topWindow = wxTheApp->GetTopWindow();
 803     if ( topWindow )
 804     {
 805         HWND hwndTop = GetHwndOf(topWindow);
 806
 807         // Do not post WM_NULL if there's already a pending WM_NULL to avoid
 808         // overflowing the message queue.
 809         //
 810         // Notice that due to a limitation of PeekMessage() API (which handles
 811         // 0,0 range specially), we have to check the range from 0-1 instead.
 812         // This still makes it possible to overflow the queue with WM_NULLs by
 813         // interspersing the calles to WakeUpIdle() with windows creation but
 814         // it should be rather hard to do it accidentally.
 815         MSG msg;
 816         if ( !::PeekMessage(&msg, hwndTop, 0, 1, PM_NOREMOVE) ||
 817               ::PeekMessage(&msg, hwndTop, 1, 1, PM_NOREMOVE) )
 818         {
 819             if ( !::PostMessage(hwndTop, WM_NULL, 0, 0) )
 820             {
 821                 // should never happen
 822                 wxLogLastError(wxT("PostMessage(WM_NULL)"));
 823             }
 824         }
 825     }
 826 }
 827
 828 // ----------------------------------------------------------------------------
 829 // other wxApp event hanlders
 830 // ----------------------------------------------------------------------------
 831
 832 void wxApp::OnEndSession(wxCloseEvent& WXUNUSED(event))
 833 {
 834     // Windows will terminate the process soon after we return from
 835     // WM_ENDSESSION handler or when we delete our last window, so make sure we
 836     // at least execute our cleanup code before
 837
 838     // prevent the window from being destroyed when the corresponding wxTLW is
 839     // destroyed: this will result in a leak of a HWND, of course, but who
 840     // cares when the process is being killed anyhow
 841     if ( !wxTopLevelWindows.empty() )
 842         wxTopLevelWindows[0]->SetHWND(0);
 843
 844     const int rc = OnExit();
 845
 846     wxEntryCleanup();
 847
 848     // calling exit() instead of ExitProcess() or not doing anything at all and
 849     // being killed by Windows has the advantage of executing the dtors of
 850     // global objects
 851     exit(rc);
 852 }
 853
 854 // Default behaviour: close the application with prompts. The
 855 // user can veto the close, and therefore the end session.
 856 void wxApp::OnQueryEndSession(wxCloseEvent& event)
 857 {
 858     if (GetTopWindow())
 859     {
 860         if (!GetTopWindow()->Close(!event.CanVeto()))
 861             event.Veto(true);
 862     }
 863 }
 864
 865 // ----------------------------------------------------------------------------
 866 // system DLL versions
 867 // ----------------------------------------------------------------------------
 868
 869 // these functions have trivial inline implementations for CE
 870 #ifndef __WXWINCE__
 871
 872 #if wxUSE_DYNLIB_CLASS
 873
 874 namespace
 875 {
 876
 877 // helper function: retrieve the DLL version by using DllGetVersion(), returns
 878 // 0 if the DLL doesn't export such function
 879 int CallDllGetVersion(wxDynamicLibrary& dll)
 880 {
 881     // now check if the function is available during run-time
 882     wxDYNLIB_FUNCTION( DLLGETVERSIONPROC, DllGetVersion, dll );
 883     if ( !pfnDllGetVersion )
 884         return 0;
 885
 886     DLLVERSIONINFO dvi;
 887     dvi.cbSize = sizeof(dvi);
 888
 889     HRESULT hr = (*pfnDllGetVersion)(&dvi);
 890     if ( FAILED(hr) )
 891     {
 892         wxLogApiError(_T("DllGetVersion"), hr);
 893
 894         return 0;
 895     }
 896
 897     return 100*dvi.dwMajorVersion + dvi.dwMinorVersion;
 898 }
 899
 900 } // anonymous namespace
 901
 902 /* static */
 903 int wxApp::GetComCtl32Version()
 904 {
 905     // cache the result
 906     //
 907     // NB: this is MT-ok as in the worst case we'd compute s_verComCtl32 twice,
 908     //     but as its value should be the same both times it doesn't matter
 909     static int s_verComCtl32 = -1;
 910
 911     if ( s_verComCtl32 == -1 )
 912     {
 913         // we're prepared to handle the errors
 914         wxLogNull noLog;
 915
 916         // we don't want to load comctl32.dll, it should be already loaded but,
 917         // depending on the OS version and the presence of the manifest, it can
 918         // be either v5 or v6 and instead of trying to guess it just get the
 919         // handle of the already loaded version
 920         wxDynamicLibrary dllComCtl32(_T("comctl32.dll"),
 921                                      wxDL_VERBATIM |
 922                                      wxDL_QUIET |
 923                                      wxDL_GET_LOADED);
 924         if ( !dllComCtl32.IsLoaded() )
 925         {
 926             s_verComCtl32 = 0;
 927             return 0;
 928         }
 929
 930         // try DllGetVersion() for recent DLLs
 931         s_verComCtl32 = CallDllGetVersion(dllComCtl32);
 932
 933         // if DllGetVersion() is unavailable either during compile or
 934         // run-time, try to guess the version otherwise
 935         if ( !s_verComCtl32 )
 936         {
 937             // InitCommonControlsEx is unique to 4.70 and later
 938             void *pfn = dllComCtl32.GetSymbol(_T("InitCommonControlsEx"));
 939             if ( !pfn )
 940             {
 941                 // not found, must be 4.00
 942                 s_verComCtl32 = 400;
 943             }
 944             else // 4.70+
 945             {
 946                 // many symbols appeared in comctl32 4.71, could use any of
 947                 // them except may be DllInstall()
 948                 pfn = dllComCtl32.GetSymbol(_T("InitializeFlatSB"));
 949                 if ( !pfn )
 950                 {
 951                     // not found, must be 4.70
 952                     s_verComCtl32 = 470;
 953                 }
 954                 else
 955                 {
 956                     // found, must be 4.71 or later
 957                     s_verComCtl32 = 471;
 958                 }
 959             }
 960         }
 961
 962         // we shouldn't unload it here as we didn't really load it above
 963         dllComCtl32.Detach();
 964     }
 965
 966     return s_verComCtl32;
 967 }
 968
 969 /* static */
 970 int wxApp::GetShell32Version()
 971 {
 972     static int s_verShell32 = -1;
 973     if ( s_verShell32 == -1 )
 974     {
 975         // we're prepared to handle the errors
 976         wxLogNull noLog;
 977
 978         wxDynamicLibrary dllShell32(_T("shell32.dll"), wxDL_VERBATIM);
 979         if ( dllShell32.IsLoaded() )
 980         {
 981             s_verShell32 = CallDllGetVersion(dllShell32);
 982
 983             if ( !s_verShell32 )
 984             {
 985                 // there doesn't seem to be any way to distinguish between 4.00
 986                 // and 4.70 (starting from 4.71 we have DllGetVersion()) so
 987                 // just assume it is 4.0
 988                 s_verShell32 = 400;
 989             }
 990         }
 991         else // failed load the DLL?
 992         {
 993             s_verShell32 = 0;
 994         }
 995     }
 996
 997     return s_verShell32;
 998 }
 999
1000 #else // !wxUSE_DYNLIB_CLASS
1001
1002 /* static */
1003 int wxApp::GetComCtl32Version()
1004 {
1005     return 0;
1006 }
1007
1008 /* static */
1009 int wxApp::GetShell32Version()
1010 {
1011     return 0;
1012 }
1013
1014 #endif // wxUSE_DYNLIB_CLASS/!wxUSE_DYNLIB_CLASS
1015
1016 #endif // !__WXWINCE__
1017
1018 // ----------------------------------------------------------------------------
1019 // Yield to incoming messages
1020 // ----------------------------------------------------------------------------
1021
1022 bool wxApp::Yield(bool onlyIfNeeded)
1023 {
1024     // MT-FIXME
1025     static bool s_inYield = false;
1026
1027     if ( s_inYield )
1028     {
1029         if ( !onlyIfNeeded )
1030         {
1031             wxFAIL_MSG( wxT("wxYield called recursively" ) );
1032         }
1033
1034         return false;
1035     }
1036
1037     // set the flag and don't forget to reset it before returning
1038     s_inYield = true;
1039     wxON_BLOCK_EXIT_SET(s_inYield, false);
1040
1041
1042 #if wxUSE_LOG
1043     // disable log flushing from here because a call to wxYield() shouldn't
1044     // normally result in message boxes popping up &c
1045     wxLog::Suspend();
1046
1047     // ensure the logs will be flashed again when we exit
1048     wxON_BLOCK_EXIT0(wxLog::Resume);
1049 #endif // wxUSE_LOG
1050
1051
1052     // we don't want to process WM_QUIT from here - it should be processed in
1053     // the main event loop in order to stop it
1054     wxEventLoopGuarantor dummyLoopIfNeeded;
1055     MSG msg;
1056     while ( PeekMessage(&msg, (HWND)0, 0, 0, PM_NOREMOVE) &&
1057             msg.message != WM_QUIT )
1058     {
1059 #if wxUSE_THREADS
1060         wxMutexGuiLeaveOrEnter();
1061 #endif // wxUSE_THREADS
1062
1063         if ( !wxTheApp->Dispatch() )
1064             break;
1065     }
1066
1067     // if there are pending events, we must process them.
1068     ProcessPendingEvents();
1069
1070     return true;
1071 }
1072
1073 #if wxUSE_EXCEPTIONS
1074
1075 // ----------------------------------------------------------------------------
1076 // exception handling
1077 // ----------------------------------------------------------------------------
1078
1079 bool wxApp::OnExceptionInMainLoop()
1080 {
1081     // ask the user about what to do: use the Win32 API function here as it
1082     // could be dangerous to use any wxWidgets code in this state
1083     switch (
1084             ::MessageBox
1085               (
1086                 NULL,
1087                 _T("An unhandled exception occurred. Press \"Abort\" to \
1088 terminate the program,\r\n\
1089 \"Retry\" to exit the program normally and \"Ignore\" to try to continue."),
1090                 _T("Unhandled exception"),
1091                 MB_ABORTRETRYIGNORE |
1092                 MB_ICONERROR|
1093                 MB_TASKMODAL
1094               )
1095            )
1096     {
1097         case IDABORT:
1098             throw;
1099
1100         default:
1101             wxFAIL_MSG( _T("unexpected MessageBox() return code") );
1102             // fall through
1103
1104         case IDRETRY:
1105             return false;
1106
1107         case IDIGNORE:
1108             return true;
1109     }
1110 }
1111
1112 #endif // wxUSE_EXCEPTIONS