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