Several corrections to wxDocManager fields documentation.

[wxWidgets.git] / src / msw / app.cpp

diff --git a/src/msw/app.cpp b/src/msw/app.cpp
index 300ec55493318d9e44e4d752c243aaafb65754e3..8df236020fc881019c00bcc13610558a0910381d 100644 (file)
--- a/src/msw/app.cpp
+++ b/src/msw/app.cpp
@@ -1,928 +1,868 @@
 /////////////////////////////////////////////////////////////////////////////
 /////////////////////////////////////////////////////////////////////////////

-// Name:        app.cpp
+// Name:        src/msw/app.cpp

 // Purpose:     wxApp
 // Author:      Julian Smart
 // Modified by:
 // Created:     04/01/98
 // RCS-ID:      $Id$
 // Purpose:     wxApp
 // Author:      Julian Smart
 // Modified by:
 // Created:     04/01/98
 // RCS-ID:      $Id$

-// Copyright:   (c) Julian Smart and Markus Holzem
-// Licence:     wxWindows license
+// Copyright:   (c) Julian Smart
+// Licence:     wxWindows licence

 /////////////////////////////////////////////////////////////////////////////
 
 /////////////////////////////////////////////////////////////////////////////
 

-#ifdef __GNUG__
-#pragma implementation "app.h"
-#endif
+// ===========================================================================
+// declarations
+// ===========================================================================
+
+// ---------------------------------------------------------------------------
+// headers
+// ---------------------------------------------------------------------------

 
 // For compilers that support precompilation, includes "wx.h".
 #include "wx/wxprec.h"
 
 #if defined(__BORLANDC__)
 
 // For compilers that support precompilation, includes "wx.h".
 #include "wx/wxprec.h"
 
 #if defined(__BORLANDC__)

-#pragma hdrstop
+    #pragma hdrstop

 #endif
 
 #ifndef WX_PRECOMP
 #endif
 
 #ifndef WX_PRECOMP

-  #include "wx/frame.h"
-  #include "wx/app.h"
-  #include "wx/utils.h"
-  #include "wx/gdicmn.h"
-  #include "wx/pen.h"
-  #include "wx/brush.h"
-  #include "wx/cursor.h"
-  #include "wx/icon.h"
-  #include "wx/palette.h"
-  #include "wx/dc.h"
-  #include "wx/dialog.h"
-  #include "wx/msgdlg.h"
+    #include "wx/msw/wrapcctl.h"
+    #include "wx/dynarray.h"
+    #include "wx/frame.h"
+    #include "wx/app.h"
+    #include "wx/utils.h"
+    #include "wx/gdicmn.h"
+    #include "wx/pen.h"
+    #include "wx/brush.h"
+    #include "wx/cursor.h"
+    #include "wx/icon.h"
+    #include "wx/palette.h"
+    #include "wx/dc.h"
+    #include "wx/dialog.h"
+    #include "wx/msgdlg.h"
+    #include "wx/intl.h"
+    #include "wx/crt.h"
+    #include "wx/log.h"
+    #include "wx/module.h"

 #endif
 
 #endif
 

+#include "wx/apptrait.h"
+#include "wx/filename.h"
+#include "wx/dynlib.h"
+#include "wx/evtloop.h"
+#include "wx/thread.h"
+#include "wx/scopeguard.h"
+#include "wx/vector.h"
+

 #include "wx/msw/private.h"
 #include "wx/msw/private.h"

-#include "wx/log.h"
-#include "wx/module.h"
+#include "wx/msw/dc.h"
+#include "wx/msw/ole/oleutils.h"
+#include "wx/msw/private/timer.h"

 
 

-#if wxUSE_WX_RESOURCES
-  #include "wx/resource.h"
-#endif
+#if wxUSE_TOOLTIPS
+    #include "wx/tooltip.h"
+#endif // wxUSE_TOOLTIPS

 
 

-#include <string.h>
-#include <ctype.h>
+// OLE is used for drag-and-drop, clipboard, OLE Automation..., but some
+// compilers don't support it (missing headers, libs, ...)
+#if defined(__GNUWIN32_OLD__) || defined(__SYMANTEC__)
+    #undef wxUSE_OLE

 
 

-#if defined(__WIN95__) && !defined(__GNUWIN32__)
-  #include <commctrl.h>
-#endif
+    #define  wxUSE_OLE 0
+#endif // broken compilers

 
 

-// use debug CRT functions for memory leak detections in VC++ if we're not
-// using wxWindows own methods
-#if defined(__WXDEBUG__) && defined(_MSC_VER) && !wxUSE_GLOBAL_MEMORY_OPERATORS && !defined(__NO_VC_CRTDBG__)
-    #define wxUSE_VC_CRTDBG
-#else
-    #undef wxUSE_VC_CRTDBG
+#if defined(__POCKETPC__) || defined(__SMARTPHONE__)
+    #include <ole2.h>
+    #include <aygshell.h>

 #endif
 
 #endif
 

-#ifdef wxUSE_VC_CRTDBG
-  // VC++ uses this macro as debug/release mode indicator
-  #ifndef _DEBUG
-    #define _DEBUG
-  #endif
-
-  /* Need to undef new if including crtdbg.h */
-  #ifdef new
-  #undef new
-  #endif
-
-  #include <crtdbg.h>
-
-  #if defined(__WXDEBUG__) && wxUSE_GLOBAL_MEMORY_OPERATORS && wxUSE_DEBUG_NEW_ALWAYS
-  #define new new(__FILE__,__LINE__)
-  #endif
-
+#if wxUSE_OLE
+    #include <ole2.h>

 #endif
 
 #endif
 

-extern char *wxBuffer;
-extern char *wxOsVersion;
-extern wxList *wxWinHandleList;
-extern wxList wxPendingDelete;
-extern void wxSetKeyboardHook(bool doIt);
-extern wxCursor *g_globalCursor;
+#include <string.h>
+#include <ctype.h>

 
 

-HINSTANCE wxhInstance = 0;
-static MSG s_currentMsg;
-wxApp *wxTheApp = NULL;
+#include "wx/msw/missing.h"
+
+// instead of including <shlwapi.h> which is not part of the core SDK and not
+// shipped at all with other compilers, we always define the parts of it we
+// need here ourselves
+//
+// NB: DLLVER_PLATFORM_WINDOWS will be defined if shlwapi.h had been somehow
+//     included already
+#ifndef DLLVER_PLATFORM_WINDOWS
+    // hopefully we don't need to change packing as DWORDs should be already
+    // correctly aligned
+    struct DLLVERSIONINFO
+    {
+        DWORD cbSize;
+        DWORD dwMajorVersion;                   // Major version
+        DWORD dwMinorVersion;                   // Minor version
+        DWORD dwBuildNumber;                    // Build number
+        DWORD dwPlatformID;                     // DLLVER_PLATFORM_*
+    };
+
+    typedef HRESULT (CALLBACK* DLLGETVERSIONPROC)(DLLVERSIONINFO *);
+#endif // defined(DLLVERSIONINFO)
+
+#ifndef ATTACH_PARENT_PROCESS
+    #define ATTACH_PARENT_PROCESS ((DWORD)-1)
+#endif

 
 

-// @@ why not const? and not static?
-char wxFrameClassName[]         = "wxFrameClass";
-char wxMDIFrameClassName[]      = "wxMDIFrameClass";
-char wxMDIChildFrameClassName[] = "wxMDIChildFrameClass";
-char wxPanelClassName[]         = "wxPanelClass";
-char wxCanvasClassName[]        = "wxCanvasClass";
+// ---------------------------------------------------------------------------
+// global variables
+// ---------------------------------------------------------------------------

 
 

-HICON wxSTD_FRAME_ICON = NULL;
-HICON wxSTD_MDICHILDFRAME_ICON = NULL;
-HICON wxSTD_MDIPARENTFRAME_ICON = NULL;
+#if !defined(__WXMICROWIN__) && !defined(__WXWINCE__)
+extern void wxSetKeyboardHook(bool doIt);
+#endif

 
 

-HICON wxDEFAULT_FRAME_ICON = NULL;
-HICON wxDEFAULT_MDICHILDFRAME_ICON = NULL;
-HICON wxDEFAULT_MDIPARENTFRAME_ICON = NULL;
+// because of mingw32 4.3 bug this struct can't be inside the namespace below:
+// see http://article.gmane.org/gmane.comp.lib.wxwidgets.devel/110282
+struct ClassRegInfo
+{
+    ClassRegInfo(const wxChar *name)
+        : regname(name),
+          regnameNR(regname + wxApp::GetNoRedrawClassSuffix())
+    {
+    }

 
 

-HBRUSH wxDisableButtonBrush = 0;
+    // the name of the registered class with and without CS_[HV]REDRAW styles
+    wxString regname;
+    wxString regnameNR;
+};

 
 

-LRESULT APIENTRY wxWndProc(HWND, UINT, WPARAM, LPARAM);
+namespace
+{

 
 

-#if !USE_SHARED_LIBRARY
-  IMPLEMENT_DYNAMIC_CLASS(wxApp, wxEvtHandler)
+wxVector<ClassRegInfo> gs_regClassesInfo;

 
 

-  BEGIN_EVENT_TABLE(wxApp, wxEvtHandler)
-      EVT_IDLE(wxApp::OnIdle)
-      EVT_END_SESSION(wxApp::OnEndSession)
-      EVT_QUERY_END_SESSION(wxApp::OnQueryEndSession)
-  END_EVENT_TABLE()
-#endif
+} // anonymous namespace

 
 

-long wxApp::sm_lastMessageTime = 0;
+// ----------------------------------------------------------------------------
+// private functions
+// ----------------------------------------------------------------------------

 
 

-#ifdef __WIN95__
-  static HINSTANCE gs_hRichEdit = NULL;
-#endif
+LRESULT WXDLLEXPORT APIENTRY wxWndProc(HWND, UINT, WPARAM, LPARAM);

 
 

-//// Initialize
+// ===========================================================================
+// wxGUIAppTraits implementation
+// ===========================================================================

 
 

-bool wxApp::Initialize()
+// private class which we use to pass parameters from BeforeChildWaitLoop() to
+// AfterChildWaitLoop()
+struct ChildWaitLoopData

 {
 {

-    // Some people may wish to use this, but
-    // probably it shouldn't be here by default.
-#ifdef __WXDEBUG__
-//    wxRedirectIOToConsole();
-#endif
+    ChildWaitLoopData(wxWindowDisabler *wd_, wxWindow *winActive_)
+    {
+        wd = wd_;
+        winActive = winActive_;
+    }

 
 

-    wxBuffer = new char[1500];
+    wxWindowDisabler *wd;
+    wxWindow *winActive;
+};

 
 

-#ifdef wxUSE_VC_CRTDBG
-    // do check for memory leaks on program exit
-    // (another useful flag is _CRTDBG_DELAY_FREE_MEM_DF which doesn't free
-    //  deallocated memory which may be used to simulate low-memory condition)
-    _CrtSetDbgFlag(_CrtSetDbgFlag(_CRTDBG_REPORT_FLAG) | _CRTDBG_LEAK_CHECK_DF);
-#endif // debug build under MS VC++
+void *wxGUIAppTraits::BeforeChildWaitLoop()
+{
+    /*
+       We use a dirty hack here to disable all application windows (which we
+       must do because otherwise the calls to wxYield() could lead to some very
+       unexpected reentrancies in the users code) but to avoid losing
+       focus/activation entirely when the child process terminates which would
+       happen if we simply disabled everything using wxWindowDisabler. Indeed,
+       remember that Windows will never activate a disabled window and when the
+       last childs window is closed and Windows looks for a window to activate
+       all our windows are still disabled. There is no way to enable them in
+       time because we don't know when the childs windows are going to be
+       closed, so the solution we use here is to keep one special tiny frame
+       enabled all the time. Then when the child terminates it will get
+       activated and when we close it below -- after reenabling all the other
+       windows! -- the previously active window becomes activated again and
+       everything is ok.
+     */
+    wxBeginBusyCursor();
+
+    // first disable all existing windows
+    wxWindowDisabler *wd = new wxWindowDisabler;
+
+    // then create an "invisible" frame: it has minimal size, is positioned
+    // (hopefully) outside the screen and doesn't appear on the taskbar
+    wxWindow *winActive = new wxFrame
+                    (
+                        wxTheApp->GetTopWindow(),
+                        wxID_ANY,
+                        wxEmptyString,
+                        wxPoint(32600, 32600),
+                        wxSize(1, 1),
+                        wxDEFAULT_FRAME_STYLE | wxFRAME_NO_TASKBAR
+                    );
+    winActive->Show();
+
+    return new ChildWaitLoopData(wd, winActive);
+}

 
 

-    wxClassInfo::InitializeClasses();
+void wxGUIAppTraits::AfterChildWaitLoop(void *dataOrig)
+{
+    wxEndBusyCursor();

 
 

-#if wxUSE_RESOURCES
-    wxGetResource("wxWindows", "OsVersion", &wxOsVersion);
-#endif
+    ChildWaitLoopData * const data = (ChildWaitLoopData *)dataOrig;

 
 

-    wxTheColourDatabase = new wxColourDatabase(wxKEY_STRING);
-    wxTheColourDatabase->Initialize();
+    delete data->wd;

 
 

-    wxInitializeStockLists();
-    wxInitializeStockObjects();
+    // finally delete the dummy frame and, as wd has been already destroyed and
+    // the other windows reenabled, the activation is going to return to the
+    // window which had had it before
+    data->winActive->Destroy();

 
 

-#if wxUSE_WX_RESOURCES
-    wxInitializeResourceSystem();
-#endif
+    // also delete the temporary data object itself
+    delete data;
+}

 
 

-    wxBitmap::InitStandardHandlers();
+#if wxUSE_THREADS
+bool wxGUIAppTraits::DoMessageFromThreadWait()
+{
+    // we should return false only if the app should exit, i.e. only if
+    // Dispatch() determines that the main event loop should terminate
+    wxEventLoopBase * const evtLoop = wxEventLoop::GetActive();
+    if ( !evtLoop || !evtLoop->Pending() )
+    {
+        // no events means no quit event
+        return true;
+    }

 
 

-#if defined(__WIN95__)
-    InitCommonControls();
-    gs_hRichEdit = LoadLibrary("RICHED32.DLL");
+    return evtLoop->Dispatch();
+}

 
 

-    if (gs_hRichEdit == NULL)
+DWORD wxGUIAppTraits::WaitForThread(WXHANDLE hThread, int flags)
+{
+    // We only ever dispatch messages from the main thread and, additionally,
+    // even from the main thread we shouldn't wait for the message if we don't
+    // have a running event loop as we would never remove them from the message
+    // queue then and so we would enter an infinite loop as
+    // MsgWaitForMultipleObjects() keeps returning WAIT_OBJECT_0 + 1.
+    if ( flags == wxTHREAD_WAIT_BLOCK ||
+            !wxIsMainThread() ||
+                !wxEventLoop::GetActive() )

     {
     {

-      wxMessageBox("Could not initialise Rich Edit DLL");
+        // Simple blocking wait.
+        return DoSimpleWaitForThread(hThread);

     }
     }

-#endif

 
 

-    int iMsg = 96;
-                       
-   // for OLE, enlarge message queue to be as large as possible
-   while (!SetMessageQueue(iMsg) && (iMsg -= 8));
+    return ::MsgWaitForMultipleObjects
+             (
+               1,                   // number of objects to wait for
+               (HANDLE *)&hThread,  // the objects
+               false,               // wait for any objects, not all
+               INFINITE,            // no timeout
+               QS_ALLINPUT |        // return as soon as there are any events
+               QS_ALLPOSTMESSAGE
+             );
+}
+#endif // wxUSE_THREADS
+
+wxPortId wxGUIAppTraits::GetToolkitVersion(int *majVer, int *minVer) const
+{
+    OSVERSIONINFO info;
+    wxZeroMemory(info);

 
 

-/*
-    DWORD dwOleVer;
-    dwOleVer = CoBuildVersion();
-       
-    // check the OLE library version
-    if (rmm != HIWORD(dwOleVer))
+    // on Windows, the toolkit version is the same of the OS version
+    // as Windows integrates the OS kernel with the GUI toolkit.
+    info.dwOSVersionInfoSize = sizeof(OSVERSIONINFO);
+    if ( ::GetVersionEx(&info) )

     {
     {

-        wxMessageBox("Incorrect version of OLE libraries.");
-        return FALSE;
+        if ( majVer )
+            *majVer = info.dwMajorVersion;
+        if ( minVer )
+            *minVer = info.dwMinorVersion;

     }
     }

-*/

 
 

-#ifndef __GNUWIN32__
-    // we need to initialize OLE library
-    if ( FAILED(::OleInitialize(NULL)) )
-      wxFatalError(_("Cannot initialize OLE"));
+#if defined(__WXHANDHELD__) || defined(__WXWINCE__)
+    return wxPORT_WINCE;
+#else
+    return wxPORT_MSW;

 #endif
 #endif

+}

 
 

-#if CTL3D
-    if (!Ctl3dRegister(wxhInstance))
-      wxFatalError("Cannot register CTL3D");
+#if wxUSE_TIMER

 
 

-    Ctl3dAutoSubclass(wxhInstance);
-#endif
+wxTimerImpl *wxGUIAppTraits::CreateTimerImpl(wxTimer *timer)
+{
+    return new wxMSWTimerImpl(timer);
+}

 
 

-    g_globalCursor = new wxCursor;
+#endif // wxUSE_TIMER

 
 

-    wxSTD_FRAME_ICON = LoadIcon(wxhInstance, "wxSTD_FRAME");
-    wxSTD_MDIPARENTFRAME_ICON = LoadIcon(wxhInstance, "wxSTD_MDIPARENTFRAME");
-    wxSTD_MDICHILDFRAME_ICON = LoadIcon(wxhInstance, "wxSTD_MDICHILDFRAME");
+wxEventLoopBase* wxGUIAppTraits::CreateEventLoop()
+{
+    return new wxEventLoop;
+}

 
 

-    wxDEFAULT_FRAME_ICON = LoadIcon(wxhInstance, "wxDEFAULT_FRAME");
-    wxDEFAULT_MDIPARENTFRAME_ICON = LoadIcon(wxhInstance, "wxDEFAULT_MDIPARENTFRAME");
-    wxDEFAULT_MDICHILDFRAME_ICON = LoadIcon(wxhInstance, "wxDEFAULT_MDICHILDFRAME");
+// ---------------------------------------------------------------------------
+// Stuff for using console from the GUI applications
+// ---------------------------------------------------------------------------

 
 

-    RegisterWindowClasses();
+#ifndef __WXWINCE__

 
 

-    // Create the brush for disabling bitmap buttons
+#if wxUSE_DYNLIB_CLASS

 
 

-    LOGBRUSH lb ;
-    lb.lbStyle = BS_PATTERN;
-    lb.lbHatch = (int)LoadBitmap( wxhInstance, "wxDISABLE_BUTTON_BITMAP" ) ;
-    wxDisableButtonBrush = ::CreateBrushIndirect( & lb ) ;
-    ::DeleteObject( (HGDIOBJ)lb.lbHatch ) ;
+#include <wx/dynlib.h>

 
 

-#if wxUSE_PENWINDOWS
-    wxRegisterPenWin();
-#endif
+namespace
+{

 
 

-    wxWinHandleList = new wxList(wxKEY_INTEGER);
+/*
+    Helper class to manipulate console from a GUI app.

 
 

-    // This is to foil optimizations in Visual C++ that
-    // throw out dummy.obj.
-#if (_MSC_VER >= 800) && !defined(WXMAKINGDLL)
-    extern char wxDummyChar;
-    if (wxDummyChar) wxDummyChar++;
-#endif
+    Notice that console output is available in the GUI app only if:
+    - AttachConsole() returns TRUE (which means it never works under pre-XP)
+    - we have a valid STD_ERROR_HANDLE
+    - command history hasn't been changed since our startup

 
 

-    wxSetKeyboardHook(TRUE);
+    To check if all these conditions are verified, you need to simple call
+    IsOkToUse(). It will check the first two conditions above the first time it
+    is called (and if this fails, the subsequent calls will return immediately)
+    and also recheck the last one every time it is called.
+ */
+class wxConsoleStderr
+{
+public:
+    // default ctor does nothing, call Init() before using this class
+    wxConsoleStderr()
+    {
+        m_hStderr = INVALID_HANDLE_VALUE;
+        m_historyLen =
+        m_dataLen =
+        m_dataLine = 0;

 
 

-    wxModule::RegisterModules();
-    if (!wxModule::InitializeModules())
-        return FALSE;
-    return TRUE;
-}
+        m_ok = -1;
+    }

 
 

-//// RegisterWindowClasses
+    ~wxConsoleStderr()
+    {
+        if ( m_hStderr != INVALID_HANDLE_VALUE )
+        {
+            if ( !::FreeConsole() )
+            {
+                wxLogLastError(wxT("FreeConsole"));
+            }
+        }
+    }

 
 

-bool wxApp::RegisterWindowClasses()
-{
-///////////////////////////////////////////////////////////////////////
-// Register the frame window class.
-  WNDCLASS wndclass;   // Structure used to register Windows class.
-
-  wndclass.style         = CS_HREDRAW | CS_VREDRAW;
-  wndclass.lpfnWndProc   = (WNDPROC)wxWndProc;
-  wndclass.cbClsExtra    = 0;
-  wndclass.cbWndExtra    = sizeof( DWORD ); // was 4
-  wndclass.hInstance     = wxhInstance;
-  wndclass.hIcon         = NULL;        // wxSTD_FRAME_ICON;
-  wndclass.hCursor       = LoadCursor( NULL, IDC_ARROW );
-  wndclass.hbrBackground =  (HBRUSH)(COLOR_APPWORKSPACE+1) ;
-//  wndclass.hbrBackground = GetStockObject( WHITE_BRUSH );
-  wndclass.lpszMenuName  = NULL;
-#ifdef _MULTIPLE_INSTANCES
-  sprintf( wxFrameClassName,"wxFrameClass%d", wxhInstance );
-#endif
-  wndclass.lpszClassName = wxFrameClassName;
-
-  if (!RegisterClass( &wndclass ))
-  {
-    // wxFatalError("Can't register Frame Window class");
-  }
-
-///////////////////////////////////////////////////////////////////////
-// Register the MDI frame window class.
-  WNDCLASS wndclass1;   // Structure used to register Windows class.
-
-  wndclass1.style         = CS_HREDRAW | CS_VREDRAW;
-  wndclass1.lpfnWndProc   = (WNDPROC)wxWndProc;
-  wndclass1.cbClsExtra    = 0;
-  wndclass1.cbWndExtra    = sizeof( DWORD ); // was 4
-  wndclass1.hInstance     = wxhInstance;
-  wndclass1.hIcon         = NULL; // wxSTD_MDIPARENTFRAME_ICON;
-  wndclass1.hCursor       = LoadCursor( NULL, IDC_ARROW );
-//  wndclass1.hbrBackground =  (HBRUSH)(COLOR_APPWORKSPACE+1) ;
-  wndclass1.hbrBackground = NULL;
-  wndclass1.lpszMenuName  = NULL;
-
-  wndclass1.lpszClassName = wxMDIFrameClassName;
-  if (!RegisterClass( &wndclass1 ))
-  {
-//    wxFatalError("Can't register MDI Frame window class");
-//  return FALSE;
-  }
-
-///////////////////////////////////////////////////////////////////////
-// Register the MDI child frame window class.
-  WNDCLASS wndclass4;   // Structure used to register Windows class.
-
-  wndclass4.style         = CS_HREDRAW | CS_VREDRAW;
-  wndclass4.lpfnWndProc   = (WNDPROC)wxWndProc;
-  wndclass4.cbClsExtra    = 0;
-  wndclass4.cbWndExtra    = sizeof( DWORD ); // was 4
-  wndclass4.hInstance     = wxhInstance;
-  wndclass4.hIcon         = NULL;       // wxSTD_MDICHILDFRAME_ICON;
-  wndclass4.hCursor       = LoadCursor( NULL, IDC_ARROW );
-  // TODO: perhaps this should be NULL so that Windows doesn't
-  // paint the background itself (would OnEraseBackground duplicate
-  // this?)
-  wndclass4.hbrBackground =  (HBRUSH)(COLOR_WINDOW+1) ;
-//  wndclass4.hbrBackground = NULL;
-  wndclass4.lpszMenuName  = NULL;
-  wndclass4.lpszClassName = wxMDIChildFrameClassName;
-
-  if (!RegisterClass( &wndclass4 ))
-  {
-//   wxFatalError("Can't register MDI child frame window class");
-//   return FALSE;
-  }
-
-///////////////////////////////////////////////////////////////////////
-// Register the panel window class.
-  WNDCLASS wndclass2;   // Structure used to register Windows class.
-  memset(&wndclass2, 0, sizeof(WNDCLASS));   // start with NULL defaults
-  // Use CS_OWNDC to avoid messing about restoring the context
-  // for every graphic operation.
-  wndclass2.style         = CS_HREDRAW | CS_VREDRAW;
-  wndclass2.lpfnWndProc   = (WNDPROC)wxWndProc;
-  wndclass2.cbClsExtra    = 0;
-  wndclass2.cbWndExtra    = sizeof( DWORD ); // was 4
-  wndclass2.hInstance     = wxhInstance;
-  wndclass2.hIcon         = NULL;
-  wndclass2.hCursor       = NULL;
-//  wndclass2.hbrBackground = (HBRUSH)(COLOR_BTNFACE+1) ;
-  wndclass2.hbrBackground = (HBRUSH) GetStockObject( LTGRAY_BRUSH );
-  wndclass2.lpszMenuName  = NULL;
-  wndclass2.lpszClassName = wxPanelClassName;
-  if (!RegisterClass( &wndclass2 ))
-  {
-//   wxFatalError("Can't register Panel Window class");
-//   return FALSE;
-  }
-
-///////////////////////////////////////////////////////////////////////
-// Register the canvas and textsubwindow class name
-  WNDCLASS wndclass3;   // Structure used to register Windows class.
-  memset(&wndclass3, 0, sizeof(WNDCLASS));   // start with NULL defaults
-  // Use CS_OWNDC to avoid messing about restoring the context
-  // for every graphic operation.
-//  wndclass3.style         = CS_HREDRAW | CS_VREDRAW | CS_OWNDC | CS_DBLCLKS ;
-  // wxWin 2.0
-  wndclass3.style         = CS_HREDRAW | CS_VREDRAW | CS_DBLCLKS ;
-  wndclass3.lpfnWndProc   = (WNDPROC)wxWndProc;
-  wndclass3.cbClsExtra    = 0;
-  wndclass3.cbWndExtra    = sizeof( DWORD ); // was 4
-  wndclass3.hInstance     = wxhInstance;
-  wndclass3.hIcon         = NULL;
-  wndclass3.hCursor       = NULL;
-//  wndclass3.hbrBackground = (HBRUSH)(COLOR_WINDOW+1) ;
-  wndclass3.hbrBackground = NULL;
-  wndclass3.lpszMenuName  = NULL;
-  wndclass3.lpszClassName = wxCanvasClassName;
-  if (!RegisterClass( &wndclass3))
-  {
-//   wxFatalError("Can't register Canvas class");
-//   return FALSE;
-  }
-
-  return TRUE;
-}
+    // return true if we were successfully initialized and there had been no
+    // console activity which would interfere with our output since then
+    bool IsOkToUse() const
+    {
+        if ( m_ok == -1 )
+        {
+            wxConsoleStderr * const self = const_cast<wxConsoleStderr *>(this);
+            self->m_ok = self->DoInit();

 
 

-//// Convert Windows to argc, argv style
+            // no need to call IsHistoryUnchanged() as we just initialized
+            // m_history anyhow
+            return m_ok == 1;
+        }

 
 

-void wxApp::ConvertToStandardCommandArgs(char* lpCmdLine)
-{
-    wxStringList args;
+        return m_ok && IsHistoryUnchanged();
+    }

 
 

-    wxString cmdLine(lpCmdLine);
-    int count = 0;

 
 

-    // Get application name
-    char name[260]; // 260 is MAX_PATH value from windef.h
-    ::GetModuleFileName(wxhInstance, name, WXSIZEOF(name));
+    // output the provided text on the console, return true if ok
+    bool Write(const wxString& text);

 
 

-    // GNUWIN32 already fills in the first arg with the application name.
-#if !defined(__GNUWIN32__)
-    args.Add(name);
-    count ++;
-#endif
+private:
+    // called by Init() once only to do the real initialization
+    bool DoInit();

 
 

-    strcpy(name, wxFileNameFromPath(name));
-    wxStripExtension(name);
-    wxTheApp->SetAppName(name);
+    // retrieve the command line history into the provided buffer and return
+    // its length
+    int GetCommandHistory(wxWxCharBuffer& buf) const;

 
 

-    // Break up string
-    // Treat strings enclosed in double-quotes as single arguments
-    int i = 0;
-    int len = cmdLine.Length();
-    while (i < len)
-    {
-        // Skip whitespace
-        while ((i < len) && isspace(cmdLine.GetChar(i)))
-            i ++;
+    // check if the console history has changed
+    bool IsHistoryUnchanged() const;

 
 

-        if (i < len)
-        {
-            if (cmdLine.GetChar(i) == '"') // We found the start of a string
-            {
-                i ++;
-                int first = i;
-                while ((i < len) && (cmdLine.GetChar(i) != '"'))
-                    i ++;
+    int m_ok;                   // initially -1, set to true or false by Init()

 
 

-                wxString arg(cmdLine.Mid(first, (i - first)));
+    wxDynamicLibrary m_dllKernel32;

 
 

-                args.Add(arg);
-                count ++;
+    HANDLE m_hStderr;           // console handle, if it's valid we must call
+                                // FreeConsole() (even if m_ok != 1)

 
 

-                if (i < len)
-                    i ++; // Skip past 2nd quote
-            }
-            else // Unquoted argument
-            {
-                int first = i;
-                while ((i < len) && !isspace(cmdLine.GetChar(i)))
-                    i ++;
+    wxWxCharBuffer m_history;   // command history on startup
+    int m_historyLen;           // length command history buffer

 
 

-                wxString arg(cmdLine.Mid(first, (i - first)));
+    wxCharBuffer m_data;        // data between empty line and cursor position
+    int m_dataLen;              // length data buffer
+    int m_dataLine;             // line offset

 
 

-                args.Add(arg);
-                count ++;
-            }
-        }
-    }
+    typedef DWORD (WINAPI *GetConsoleCommandHistory_t)(LPTSTR sCommands,
+                                                       DWORD nBufferLength,
+                                                       LPCTSTR sExeName);
+    typedef DWORD (WINAPI *GetConsoleCommandHistoryLength_t)(LPCTSTR sExeName);

 
 

-    wxTheApp->argv = new char*[count + 1];
-    for (i = 0; i < count; i++)
-    {
-        wxString arg(args[i]);
-        wxTheApp->argv[i] = copystring((const char*)arg);
-    }
-    wxTheApp->argv[count] = NULL; // argv[] is a NULL-terminated list
-    wxTheApp->argc = count;
-}
+    GetConsoleCommandHistory_t m_pfnGetConsoleCommandHistory;
+    GetConsoleCommandHistoryLength_t m_pfnGetConsoleCommandHistoryLength;

 
 

-//// Cleans up any wxWindows internal structures left lying around
+    wxDECLARE_NO_COPY_CLASS(wxConsoleStderr);
+};

 
 

-void wxApp::CleanUp()
+bool wxConsoleStderr::DoInit()

 {
 {

-  //// COMMON CLEANUP
-  wxModule::CleanUpModules();
+    HANDLE hStderr = ::GetStdHandle(STD_ERROR_HANDLE);

 
 

-#if wxUSE_WX_RESOURCES
-  wxCleanUpResourceSystem();
+    if ( hStderr == INVALID_HANDLE_VALUE || !hStderr )
+        return false;

 
 

-//  wxDefaultResourceTable->ClearTable();
-#endif
+    if ( !m_dllKernel32.Load(wxT("kernel32.dll")) )
+        return false;

 
 

-  // Indicate that the cursor can be freed,
-  // so that cursor won't be deleted by deleting
-  // the bitmap list before g_globalCursor goes out
-  // of scope (double deletion of the cursor).
-  wxSetCursor(wxNullCursor);
-  delete g_globalCursor;
+    typedef BOOL (WINAPI *AttachConsole_t)(DWORD dwProcessId);
+    AttachConsole_t wxDL_INIT_FUNC(pfn, AttachConsole, m_dllKernel32);

 
 

-  wxDeleteStockObjects() ;
+    if ( !pfnAttachConsole || !pfnAttachConsole(ATTACH_PARENT_PROCESS) )
+        return false;

 
 

-  // Destroy all GDI lists, etc.
-  wxDeleteStockLists();
+    // console attached, set m_hStderr now to ensure that we free it in the
+    // dtor
+    m_hStderr = hStderr;

 
 

-  delete wxTheColourDatabase;
-  wxTheColourDatabase = NULL;
+    wxDL_INIT_FUNC_AW(m_pfn, GetConsoleCommandHistory, m_dllKernel32);
+    if ( !m_pfnGetConsoleCommandHistory )
+        return false;

 
 

-  wxBitmap::CleanUpHandlers();
+    wxDL_INIT_FUNC_AW(m_pfn, GetConsoleCommandHistoryLength, m_dllKernel32);
+    if ( !m_pfnGetConsoleCommandHistoryLength )
+        return false;

 
 

-  delete[] wxBuffer;
-  wxBuffer = NULL;
+    // remember the current command history to be able to compare with it later
+    // in IsHistoryUnchanged()
+    m_historyLen = GetCommandHistory(m_history);
+    if ( !m_history )
+        return false;

 
 

-  //// WINDOWS-SPECIFIC CLEANUP

 
 

-  wxSetKeyboardHook(FALSE);
+    // now find the first blank line above the current position
+    CONSOLE_SCREEN_BUFFER_INFO csbi;

 
 

-#ifdef __WIN95__
-  if (gs_hRichEdit != NULL)
-    FreeLibrary(gs_hRichEdit);
-#endif
+    if ( !::GetConsoleScreenBufferInfo(m_hStderr, &csbi) )
+    {
+        wxLogLastError(wxT("GetConsoleScreenBufferInfo"));
+        return false;
+    }

 
 

-#if wxUSE_PENWINDOWS
-  wxCleanUpPenWin();
-#endif
+    COORD pos;
+    pos.X = 0;
+    pos.Y = csbi.dwCursorPosition.Y + 1;

 
 

-  if (wxSTD_FRAME_ICON)
-    DestroyIcon(wxSTD_FRAME_ICON);
-  if (wxSTD_MDICHILDFRAME_ICON)
-    DestroyIcon(wxSTD_MDICHILDFRAME_ICON);
-  if (wxSTD_MDIPARENTFRAME_ICON)
-    DestroyIcon(wxSTD_MDIPARENTFRAME_ICON);
-
-  if (wxDEFAULT_FRAME_ICON)
-    DestroyIcon(wxDEFAULT_FRAME_ICON);
-  if (wxDEFAULT_MDICHILDFRAME_ICON)
-    DestroyIcon(wxDEFAULT_MDICHILDFRAME_ICON);
-  if (wxDEFAULT_MDIPARENTFRAME_ICON)
-    DestroyIcon(wxDEFAULT_MDIPARENTFRAME_ICON);
-
-  if ( wxDisableButtonBrush )
-    ::DeleteObject( wxDisableButtonBrush ) ;
-
-#ifndef __GNUWIN32__
-  ::OleUninitialize();
-#endif
+    // we decide that a line is empty if first 4 characters are spaces
+    DWORD ret;
+    char buf[4];
+    do
+    {
+        pos.Y--;
+        if ( !::ReadConsoleOutputCharacterA(m_hStderr, buf, WXSIZEOF(buf),
+                                            pos, &ret) )
+        {
+            wxLogLastError(wxT("ReadConsoleOutputCharacterA"));
+            return false;
+        }
+    } while ( wxStrncmp("    ", buf, WXSIZEOF(buf)) != 0 );

 
 

-#if CTL3D
-  Ctl3dUnregister(wxhInstance);
-#endif
+    // calculate line offset and length of data
+    m_dataLine = csbi.dwCursorPosition.Y - pos.Y;
+    m_dataLen = m_dataLine*csbi.dwMaximumWindowSize.X + csbi.dwCursorPosition.X;

 
 

-  if (wxWinHandleList)
-    delete wxWinHandleList ;
-
-  wxClassInfo::CleanUpClasses();
-
-  delete wxTheApp;
-  wxTheApp = NULL;
-
-#if (defined(__WXDEBUG__) && wxUSE_MEMORY_TRACING) || wxUSE_DEBUG_CONTEXT
-  // At this point we want to check if there are any memory
-  // blocks that aren't part of the wxDebugContext itself,
-  // as a special case. Then when dumping we need to ignore
-  // wxDebugContext, too.
-  if (wxDebugContext::CountObjectsLeft() > 0)
-  {
-      wxLogDebug("There were memory leaks.");
-      wxDebugContext::Dump();
-      wxDebugContext::PrintStatistics();
-  }
-//  wxDebugContext::SetStream(NULL, NULL);
-#endif
+    if ( m_dataLen > 0 )
+    {
+        m_data.extend(m_dataLen);
+        if ( !::ReadConsoleOutputCharacterA(m_hStderr, m_data.data(), m_dataLen,
+                                            pos, &ret) )
+        {
+            wxLogLastError(wxT("ReadConsoleOutputCharacterA"));
+            return false;
+        }
+    }

 
 

-  // do it as the very last thing because everything else can log messages
-  wxLog::DontCreateOnDemand();
-  delete wxLog::SetActiveTarget(NULL);
+    return true;

 }
 
 }
 

-#if !defined(_WINDLL) || (defined(_WINDLL) && defined(WXMAKINGDLL))
-
-//// Main wxWindows entry point
-int wxEntry(WXHINSTANCE hInstance,
-            WXHINSTANCE WXUNUSED(hPrevInstance),
-            char *lpCmdLine,
-            int nCmdShow,
-            bool enterLoop)
+int wxConsoleStderr::GetCommandHistory(wxWxCharBuffer& buf) const

 {
 {

-#ifndef __WXDEBUG__ // take everything into a try-except block in release build
-  try {
-#endif
+    // these functions are internal and may only be called by cmd.exe
+    static const wxChar *CMD_EXE = wxT("cmd.exe");

 
 

-  wxhInstance = (HINSTANCE) hInstance;
+    const int len = m_pfnGetConsoleCommandHistoryLength(CMD_EXE);
+    if ( len )
+    {
+        buf.extend(len);

 
 

-  if (!wxApp::Initialize())
-    return 0;
+        int len2 = m_pfnGetConsoleCommandHistory(buf.data(), len, CMD_EXE);

 
 

-  // create the application object or ensure that one already exists
-  if (!wxTheApp)
-  {
-    // The app may have declared a global application object, but we recommend
-    // the IMPLEMENT_APP macro is used instead, which sets an initializer
-    // function for delayed, dynamic app object construction.
-    wxCHECK_MSG( wxApp::GetInitializerFunction(), 0,
-                 "No initializer - use IMPLEMENT_APP macro." );
-
-    wxTheApp = (*wxApp::GetInitializerFunction()) ();
-  }
-
-  wxCHECK_MSG( wxTheApp, 0, "You have to define an instance of wxApp!" );
-
-  // save the WinMain() parameters
-  wxTheApp->ConvertToStandardCommandArgs(lpCmdLine);
-  wxTheApp->m_nCmdShow = nCmdShow;
-
-  // GUI-specific initialisation. In fact on Windows we don't have any,
-  // but this call is provided for compatibility across platforms.
-  wxTheApp->OnInitGui() ;
-
-  int retValue = 0;
-
-  if ( wxTheApp->OnInit() )
-  {
-      if ( enterLoop )
-      {
-          retValue = wxTheApp->OnRun();
-      }
-  }
-  //else: app initialization failed, so we skipped OnRun()
-
-  wxWindow *topWindow = wxTheApp->GetTopWindow();
-  if ( topWindow )
-  {
-      // Forcibly delete the window.
-      if ( topWindow->IsKindOf(CLASSINFO(wxFrame)) ||
-           topWindow->IsKindOf(CLASSINFO(wxDialog)) )
-      {
-          topWindow->Close(TRUE);
-          wxTheApp->DeletePendingObjects();
-      }
-      else
-      {
-          delete topWindow;
-          wxTheApp->SetTopWindow(NULL);
-      }
-  }
-
-  wxTheApp->OnExit();
-
-  // flush the logged messages if any
-  wxLog *pLog = wxLog::GetActiveTarget();
-  if ( pLog != NULL && pLog->HasPendingMessages() )
-    pLog->Flush();
-
-
-  wxApp::CleanUp();
-
-  return retValue;
-#ifndef __WXDEBUG__ // catch exceptions only in release build
-  }
-  except ( EXCEPTION_EXECUTE_HANDLER ) {
-    /*
-    if ( wxTheApp )
-      wxTheApp->OnFatalException();
-    */
+#if !wxUSE_UNICODE
+        // there seems to be a bug in the GetConsoleCommandHistoryA(), it
+        // returns the length of Unicode string and not ANSI one
+        len2 /= 2;
+#endif // !wxUSE_UNICODE

 
 

-    ::ExitProcess(3); // the same exit code as abort()
-  }
-#endif //debug
+        if ( len2 != len )
+        {
+            wxFAIL_MSG( wxT("failed getting history?") );
+        }
+    }
+
+    return len;

 }
 
 }
 

-#else /*  _WINDLL  */
+bool wxConsoleStderr::IsHistoryUnchanged() const
+{
+    wxASSERT_MSG( m_ok == 1, wxT("shouldn't be called if not initialized") );

 
 

-//// Entry point for DLLs
+    // get (possibly changed) command history
+    wxWxCharBuffer history;
+    const int historyLen = GetCommandHistory(history);

 
 

-int wxEntry(WXHINSTANCE hInstance)
-{
-  wxhInstance = (HINSTANCE) hInstance;
-  wxApp::Initialize();
+    // and compare it with the original one
+    return historyLen == m_historyLen && history &&
+                memcmp(m_history, history, historyLen) == 0;
+}

 
 

-  // The app may have declared a global application object, but we recommend
-  // the IMPLEMENT_APP macro is used instead, which sets an initializer function
-  // for delayed, dynamic app object construction.
+bool wxConsoleStderr::Write(const wxString& text)
+{
+    wxASSERT_MSG( m_hStderr != INVALID_HANDLE_VALUE,
+                    wxT("should only be called if Init() returned true") );

 
 

-  if (!wxTheApp)
-  {
-    if (!wxApp::GetInitializerFunction())
+    // get current position
+    CONSOLE_SCREEN_BUFFER_INFO csbi;
+    if ( !::GetConsoleScreenBufferInfo(m_hStderr, &csbi) )

     {
     {

-      MessageBox(NULL, "No initializer - use IMPLEMENT_APP macro.", "wxWindows Error", MB_APPLMODAL | MB_ICONSTOP | MB_OK);
-    return 0;
+        wxLogLastError(wxT("GetConsoleScreenBufferInfo"));
+        return false;

     }
 
     }
 

-    wxTheApp = (* wxApp::GetInitializerFunction()) ();
-  }
+    // and calculate new position (where is empty line)
+    csbi.dwCursorPosition.X = 0;
+    csbi.dwCursorPosition.Y -= m_dataLine;

 
 

-  if (!wxTheApp) {
-    MessageBox(NULL, "You have to define an instance of wxApp!", "wxWindows Error", MB_APPLMODAL | MB_ICONSTOP | MB_OK);
-    return 0;
-  }
-
-  wxTheApp->argc = 0;
-  wxTheApp->argv = NULL;
+    if ( !::SetConsoleCursorPosition(m_hStderr, csbi.dwCursorPosition) )
+    {
+        wxLogLastError(wxT("SetConsoleCursorPosition"));
+        return false;
+    }

 
 

-  wxTheApp->OnInitGui();
+    DWORD ret;
+    if ( !::FillConsoleOutputCharacter(m_hStderr, wxT(' '), m_dataLen,
+                                       csbi.dwCursorPosition, &ret) )
+    {
+        wxLogLastError(wxT("FillConsoleOutputCharacter"));
+        return false;
+    }

 
 

-  wxTheApp->OnInit();
+    if ( !::WriteConsole(m_hStderr, text.wx_str(), text.length(), &ret, NULL) )
+    {
+        wxLogLastError(wxT("WriteConsole"));
+        return false;
+    }

 
 

-  if (wxTheApp->GetTopWindow() && wxTheApp->GetTopWindow()->GetHWND()) {
-    wxTheApp->GetTopWindow()->Show(TRUE);
-  }
+    WriteConsoleA(m_hStderr, m_data, m_dataLen, &ret, 0);

 
 

-  return 1;
+    return true;

 }
 }

-#endif // _WINDLL

 
 

-//// Static member initialization
+wxConsoleStderr s_consoleStderr;

 
 

-wxAppInitializerFunction wxApp::m_appInitFn = (wxAppInitializerFunction) NULL;
+} // anonymous namespace

 
 

-wxApp::wxApp()
+bool wxGUIAppTraits::CanUseStderr()

 {
 {

-  m_topWindow = NULL;
-  wxTheApp = this;
-  m_className = "";
-  m_wantDebugOutput = TRUE ;
-  m_appName = "";
-  argc = 0;
-  argv = NULL;
-#ifdef __WXMSW__
-  m_printMode = wxPRINT_WINDOWS;
-#else
-  m_printMode = wxPRINT_POSTSCRIPT;
-#endif
-  m_exitOnFrameDelete = TRUE;
-  m_auto3D = TRUE;
+    return s_consoleStderr.IsOkToUse();

 }
 
 }
 

-wxApp::~wxApp()
+bool wxGUIAppTraits::WriteToStderr(const wxString& text)

 {
 {

-  // Delete command-line args
-  int i;
-  for (i = 0; i < argc; i++)
-  {
-    delete[] argv[i];
-  }
-  delete[] argv;
+    return s_consoleStderr.IsOkToUse() && s_consoleStderr.Write(text);

 }
 
 }
 

-bool wxApp::Initialized()
+#else // !wxUSE_DYNLIB_CLASS
+
+bool wxGUIAppTraits::CanUseStderr()

 {
 {

-#ifndef _WINDLL
-  if (GetTopWindow())
-    return TRUE;
-  else
-    return FALSE;
-#endif
-#ifdef _WINDLL // Assume initialized if DLL (no way of telling)
-  return TRUE;
-#endif
+    return false;

 }
 
 }
 

-/*
- * Get and process a message, returning FALSE if WM_QUIT
- * received.
- *
- */
-bool wxApp::DoMessage()
+bool wxGUIAppTraits::WriteToStderr(const wxString& WXUNUSED(text))

 {
 {

-  if (!::GetMessage(&s_currentMsg, (HWND) NULL, 0, 0))
-  {
-    return FALSE;
-  }
-
-  // Process the message
-  if (!ProcessMessage((WXMSG *)&s_currentMsg))
-  {
-    ::TranslateMessage(&s_currentMsg);
-    wxApp::sm_lastMessageTime = s_currentMsg.time; /* MATTHEW: timeStamp impl. */
-    ::DispatchMessage(&s_currentMsg);
-  }
-  return TRUE;
+    return false;

 }
 
 }
 

-/*
- * Keep trying to process messages until WM_QUIT
- * received.
- *
- * If there are messages to be processed, they will all be
- * processed and OnIdle will not be called.
- * When there are no more messages, OnIdle is called.
- * If OnIdle requests more time,
- * it will be repeatedly called so long as there are no pending messages.
- * A 'feature' of this is that once OnIdle has decided that no more processing
- * is required, then it won't get processing time until further messages
- * are processed (it'll sit in DoMessage).
- */
+#endif // wxUSE_DYNLIB_CLASS/!wxUSE_DYNLIB_CLASS

 
 

-int wxApp::MainLoop()
-{
-  m_keepGoing = TRUE;
-  while (m_keepGoing)
-  {
-    while (!::PeekMessage(&s_currentMsg, 0, 0, 0, PM_NOREMOVE) &&
-           ProcessIdle()) {}
-    if (!DoMessage())
-      m_keepGoing = FALSE;
-  }
-
-  return s_currentMsg.wParam;
-}
+#endif // !__WXWINCE__

 
 

-// Returns TRUE if more time is needed.
-bool wxApp::ProcessIdle()
-{
-    wxIdleEvent event;
-    event.SetEventObject(this);
-    ProcessEvent(event);
+// ===========================================================================
+// wxApp implementation
+// ===========================================================================

 
 

-    return event.MoreRequested();
-}
+int wxApp::m_nCmdShow = SW_SHOWNORMAL;

 
 

-void wxApp::ExitMainLoop()
-{
-  m_keepGoing = FALSE;
-}
+// ---------------------------------------------------------------------------
+// wxWin macros
+// ---------------------------------------------------------------------------
+
+IMPLEMENT_DYNAMIC_CLASS(wxApp, wxEvtHandler)

 
 

-bool wxApp::Pending()
+BEGIN_EVENT_TABLE(wxApp, wxEvtHandler)
+    EVT_IDLE(wxApp::OnIdle)
+    EVT_END_SESSION(wxApp::OnEndSession)
+    EVT_QUERY_END_SESSION(wxApp::OnQueryEndSession)
+END_EVENT_TABLE()
+
+// class to ensure that wxAppBase::CleanUp() is called if our Initialize()
+// fails
+class wxCallBaseCleanup

 {
 {

-  return (::PeekMessage(&s_currentMsg, 0, 0, 0, PM_NOREMOVE) != 0) ;
-}
+public:
+    wxCallBaseCleanup(wxApp *app) : m_app(app) { }
+    ~wxCallBaseCleanup() { if ( m_app ) m_app->wxAppBase::CleanUp(); }

 
 

-void wxApp::Dispatch()
+    void Dismiss() { m_app = NULL; }
+
+private:
+    wxApp *m_app;
+};
+
+//// Initialize
+bool wxApp::Initialize(int& argc, wxChar **argv)

 {
 {

-    if (!DoMessage())
-      m_keepGoing = FALSE;
+    if ( !wxAppBase::Initialize(argc, argv) )
+        return false;
+
+    // ensure that base cleanup is done if we return too early
+    wxCallBaseCleanup callBaseCleanup(this);
+
+#if !defined(__WXMICROWIN__)
+    InitCommonControls();
+#endif // !defined(__WXMICROWIN__)
+
+#if defined(__SMARTPHONE__) || defined(__POCKETPC__)
+    SHInitExtraControls();
+#endif
+
+#ifndef __WXWINCE__
+    // Don't show a message box if a function such as SHGetFileInfo
+    // fails to find a device.
+    SetErrorMode(SEM_FAILCRITICALERRORS|SEM_NOOPENFILEERRORBOX);
+#endif
+
+    wxOleInitialize();
+
+#if !defined(__WXMICROWIN__) && !defined(__WXWINCE__)
+    wxSetKeyboardHook(true);
+#endif
+
+    callBaseCleanup.Dismiss();
+
+    return true;

 }
 
 }
 

-/*
- * Give all windows a chance to preprocess
- * the message. Some may have accelerator tables, or have
- * MDI complications.
- */
-bool wxApp::ProcessMessage(WXMSG *Msg)
+// ---------------------------------------------------------------------------
+// Win32 window class registration
+// ---------------------------------------------------------------------------
+
+/* static */
+const wxChar *wxApp::GetRegisteredClassName(const wxChar *name,
+                                            int bgBrushCol,
+                                            int extraStyles)

 {
 {

-  MSG *msg = (MSG *)Msg;
+    const size_t count = gs_regClassesInfo.size();
+    for ( size_t n = 0; n < count; n++ )
+    {
+        if ( gs_regClassesInfo[n].regname == name )
+            return gs_regClassesInfo[n].regname.c_str();
+    }

 
 

-  HWND hWnd;
+    // we need to register this class
+    WNDCLASS wndclass;
+    wxZeroMemory(wndclass);

 
 

-  // Try translations first; find the youngest window with
-  // a translation table.
-  for (hWnd = msg->hwnd; hWnd != NULL; hWnd = ::GetParent(hWnd))
-  {
-    wxWindow *wnd = wxFindWinFromHandle((WXHWND) hWnd);
-    if (wnd)
+    wndclass.lpfnWndProc   = (WNDPROC)wxWndProc;
+    wndclass.hInstance     = wxGetInstance();
+    wndclass.hCursor       = ::LoadCursor(NULL, IDC_ARROW);
+    wndclass.hbrBackground = (HBRUSH)wxUIntToPtr(bgBrushCol + 1);
+    wndclass.style         = CS_HREDRAW | CS_VREDRAW | CS_DBLCLKS | extraStyles;
+
+
+    ClassRegInfo regClass(name);
+    wndclass.lpszClassName = regClass.regname.wx_str();
+    if ( !::RegisterClass(&wndclass) )

     {
     {

-       if (wnd->MSWTranslateMessage(Msg))
-         return TRUE;
+        wxLogLastError(wxString::Format(wxT("RegisterClass(%s)"),
+                       regClass.regname));
+        return NULL;

     }
     }

-  }

 
 

-  // Anyone for a non-translation message? Try youngest descendants first.
-  for (hWnd = msg->hwnd; hWnd != NULL; hWnd = ::GetParent(hWnd))
-  {
-    wxWindow *wnd = wxFindWinFromHandle((WXHWND) hWnd);
-    if (wnd)
+    wndclass.style &= ~(CS_HREDRAW | CS_VREDRAW);
+    wndclass.lpszClassName = regClass.regnameNR.wx_str();
+    if ( !::RegisterClass(&wndclass) )

     {
     {

-       if (wnd->MSWProcessMessage(Msg))
-         return TRUE;
+        wxLogLastError(wxString::Format(wxT("RegisterClass(%s)"),
+                       regClass.regname));
+        ::UnregisterClass(regClass.regname.c_str(), wxGetInstance());
+        return NULL;

     }
     }

-  }
-  return FALSE;
+
+    gs_regClassesInfo.push_back(regClass);
+
+    // take care to return the pointer which will remain valid after the
+    // function returns (it could be invalidated later if new elements are
+    // added to the vector and it's reallocated but this shouldn't matter as
+    // this pointer should be used right now, not stored)
+    return gs_regClassesInfo.back().regname.wx_str();

 }
 
 }
 

-void wxApp::OnIdle(wxIdleEvent& event)
+bool wxApp::IsRegisteredClassName(const wxString& name)

 {
 {

-  static bool inOnIdle = FALSE;
+    const size_t count = gs_regClassesInfo.size();
+    for ( size_t n = 0; n < count; n++ )
+    {
+        if ( gs_regClassesInfo[n].regname == name ||
+                gs_regClassesInfo[n].regnameNR == name )
+            return true;
+    }

 
 

-  // Avoid recursion (via ProcessEvent default case)
-  if (inOnIdle)
-    return;
+    return false;
+}

 
 

-  inOnIdle = TRUE;
+void wxApp::UnregisterWindowClasses()
+{
+    const size_t count = gs_regClassesInfo.size();
+    for ( size_t n = 0; n < count; n++ )
+    {
+        const ClassRegInfo& regClass = gs_regClassesInfo[n];
+        if ( !::UnregisterClass(regClass.regname.c_str(), wxGetInstance()) )
+        {
+            wxLogLastError(wxString::Format(wxT("UnregisterClass(%s)"),
+                           regClass.regname));
+        }

 
 

-  // 'Garbage' collection of windows deleted with Close().
-  DeletePendingObjects();
+        if ( !::UnregisterClass(regClass.regnameNR.c_str(), wxGetInstance()) )
+        {
+            wxLogLastError(wxString::Format(wxT("UnregisterClass(%s)"),
+                           regClass.regnameNR));
+        }
+    }

 
 

-  // flush the logged messages if any
-  wxLog *pLog = wxLog::GetActiveTarget();
-  if ( pLog != NULL && pLog->HasPendingMessages() )
-    pLog->Flush();
+    gs_regClassesInfo.clear();
+}

 
 

-  // Send OnIdle events to all windows
-  bool needMore = SendIdleEvents();
-//  bool needMore = FALSE;
+void wxApp::CleanUp()
+{
+    // all objects pending for deletion must be deleted first, otherwise
+    // UnregisterWindowClasses() call wouldn't succeed (because windows
+    // using the classes being unregistered still exist), so call the base
+    // class method first and only then do our clean up
+    wxAppBase::CleanUp();
+
+#if !defined(__WXMICROWIN__) && !defined(__WXWINCE__)
+    wxSetKeyboardHook(false);
+#endif

 
 

-  if (needMore)
-    event.RequestMore(TRUE);
+    wxOleUninitialize();

 
 

-  inOnIdle = FALSE;
+    // for an EXE the classes are unregistered when it terminates but DLL may
+    // be loaded several times (load/unload/load) into the same process in
+    // which case the registration will fail after the first time if we don't
+    // unregister the classes now
+    UnregisterWindowClasses();

 }
 
 }
 

-// Send idle event to all top-level windows
-bool wxApp::SendIdleEvents()
+// ----------------------------------------------------------------------------
+// wxApp ctor/dtor
+// ----------------------------------------------------------------------------
+
+wxApp::wxApp()

 {
 {

-    bool needMore = FALSE;
-  wxNode* node = wxTopLevelWindows.First();
-  while (node)
-  {
-    wxWindow* win = (wxWindow*) node->Data();
-    if (SendIdleEvents(win))
-            needMore = TRUE;
-
-    node = node->Next();
-  }
-    return needMore;
+    m_printMode = wxPRINT_WINDOWS;

 }
 
 }
 

-// Send idle event to window and all subwindows
-bool wxApp::SendIdleEvents(wxWindow* win)
+wxApp::~wxApp()

 {
 {

-  bool needMore = FALSE;
-
-  wxIdleEvent event;
-  event.SetEventObject(win);
-  win->GetEventHandler()->ProcessEvent(event);
+}

 
 

-  if (event.MoreRequested())
-    needMore = TRUE;
+// ----------------------------------------------------------------------------
+// wxApp idle handling
+// ----------------------------------------------------------------------------

 
 

-  wxNode* node = win->GetChildren().First();
-  while (node)
-  {
-    wxWindow* win = (wxWindow*) node->Data();
-    if (SendIdleEvents(win))
-      needMore = TRUE;
+void wxApp::OnIdle(wxIdleEvent& WXUNUSED(event))
+{
+#if wxUSE_DC_CACHEING
+    // automated DC cache management: clear the cached DCs and bitmap
+    // if it's likely that the app has finished with them, that is, we
+    // get an idle event and we're not dragging anything.
+    if (!::GetKeyState(MK_LBUTTON) && !::GetKeyState(MK_MBUTTON) && !::GetKeyState(MK_RBUTTON))
+        wxMSWDCImpl::ClearCache();
+#endif // wxUSE_DC_CACHEING
+}

 
 

-    node = node->Next();
-  }
-  return needMore ;
+void wxApp::WakeUpIdle()
+{
+    // Send the top window a dummy message so idle handler processing will
+    // start up again.  Doing it this way ensures that the idle handler
+    // wakes up in the right thread (see also wxWakeUpMainThread() which does
+    // the same for the main app thread only)
+    wxWindow * const topWindow = wxTheApp->GetTopWindow();
+    if ( topWindow )
+    {
+        HWND hwndTop = GetHwndOf(topWindow);
+
+        // Do not post WM_NULL if there's already a pending WM_NULL to avoid
+        // overflowing the message queue.
+        //
+        // Notice that due to a limitation of PeekMessage() API (which handles
+        // 0,0 range specially), we have to check the range from 0-1 instead.
+        // This still makes it possible to overflow the queue with WM_NULLs by
+        // interspersing the calles to WakeUpIdle() with windows creation but
+        // it should be rather hard to do it accidentally.
+        MSG msg;
+        if ( !::PeekMessage(&msg, hwndTop, 0, 1, PM_NOREMOVE) ||
+              ::PeekMessage(&msg, hwndTop, 1, 1, PM_NOREMOVE) )
+        {
+            if ( !::PostMessage(hwndTop, WM_NULL, 0, 0) )
+            {
+                // should never happen
+                wxLogLastError(wxT("PostMessage(WM_NULL)"));
+            }
+        }
+    }
+#if wxUSE_THREADS
+    else
+        wxWakeUpMainThread();
+#endif // wxUSE_THREADS

 }
 
 }
 

-void wxApp::DeletePendingObjects()
+// ----------------------------------------------------------------------------
+// other wxApp event hanlders
+// ----------------------------------------------------------------------------
+
+void wxApp::OnEndSession(wxCloseEvent& WXUNUSED(event))

 {
 {

-  wxNode *node = wxPendingDelete.First();
-  while (node)
-  {
-    wxObject *obj = (wxObject *)node->Data();
+    // Windows will terminate the process soon after we return from
+    // WM_ENDSESSION handler or when we delete our last window, so make sure we
+    // at least execute our cleanup code before

 
 

-    delete obj;
+    // prevent the window from being destroyed when the corresponding wxTLW is
+    // destroyed: this will result in a leak of a HWND, of course, but who
+    // cares when the process is being killed anyhow
+    if ( !wxTopLevelWindows.empty() )
+        wxTopLevelWindows[0]->SetHWND(0);

 
 

-    if (wxPendingDelete.Member(obj))
-      delete node;
+    const int rc = OnExit();

 
 

-    // Deleting one object may have deleted other pending
-    // objects, so start from beginning of list again.
-    node = wxPendingDelete.First();
-  }
-}
+    wxEntryCleanup();

 
 

-void wxApp::OnEndSession(wxCloseEvent& event)
-{
-    if (GetTopWindow())
-        GetTopWindow()->Close(TRUE);
+    // calling exit() instead of ExitProcess() or not doing anything at all and
+    // being killed by Windows has the advantage of executing the dtors of
+    // global objects
+    exit(rc);

 }
 
 // Default behaviour: close the application with prompts. The
 }
 
 // Default behaviour: close the application with prompts. The


@@ -932,96 +872,194 @@ void wxApp::OnQueryEndSession(wxCloseEvent& event)
     if (GetTopWindow())
     {
         if (!GetTopWindow()->Close(!event.CanVeto()))
     if (GetTopWindow())
     {
         if (!GetTopWindow()->Close(!event.CanVeto()))

-            event.Veto(TRUE);
+            event.Veto(true);

     }
 }
 
     }
 }
 

-wxLog* wxApp::CreateLogTarget()
+// ----------------------------------------------------------------------------
+// system DLL versions
+// ----------------------------------------------------------------------------
+
+// these functions have trivial inline implementations for CE
+#ifndef __WXWINCE__
+
+#if wxUSE_DYNLIB_CLASS
+
+namespace

 {
 {

-    return new wxLogGui;
-}

 
 

-wxWindow* wxApp::GetTopWindow() const
+// helper function: retrieve the DLL version by using DllGetVersion(), returns
+// 0 if the DLL doesn't export such function
+int CallDllGetVersion(wxDynamicLibrary& dll)

 {
 {

-    if (m_topWindow)
-        return m_topWindow;
-    else if (wxTopLevelWindows.Number() > 0)
-        return (wxWindow*) wxTopLevelWindows.First()->Data();
-    else
-        return NULL;
+    // now check if the function is available during run-time
+    wxDYNLIB_FUNCTION( DLLGETVERSIONPROC, DllGetVersion, dll );
+    if ( !pfnDllGetVersion )
+        return 0;
+
+    DLLVERSIONINFO dvi;
+    dvi.cbSize = sizeof(dvi);
+
+    HRESULT hr = (*pfnDllGetVersion)(&dvi);
+    if ( FAILED(hr) )
+    {
+        wxLogApiError(wxT("DllGetVersion"), hr);
+
+        return 0;
+    }
+
+    return 100*dvi.dwMajorVersion + dvi.dwMinorVersion;

 }
 
 }
 

-int wxApp::GetComCtl32Version() const
+} // anonymous namespace
+
+/* static */
+int wxApp::GetComCtl32Version()

 {
 {

-    // have we loaded COMCTL32 yet?
-    HMODULE theModule = ::GetModuleHandle("COMCTL32");
-    int version = 0;
+    // cache the result
+    //
+    // NB: this is MT-ok as in the worst case we'd compute s_verComCtl32 twice,
+    //     but as its value should be the same both times it doesn't matter
+    static int s_verComCtl32 = -1;

 
 

-    // if so, then we can check for the version
-    if (theModule)
+    if ( s_verComCtl32 == -1 )

     {
     {

-        // InitCommonControlsEx is unique to 4.7 and later
-        FARPROC theProc = ::GetProcAddress(theModule, "InitCommonControlsEx");
+        // we're prepared to handle the errors
+        wxLogNull noLog;
+
+        // we don't want to load comctl32.dll, it should be already loaded but,
+        // depending on the OS version and the presence of the manifest, it can
+        // be either v5 or v6 and instead of trying to guess it just get the
+        // handle of the already loaded version
+        wxLoadedDLL dllComCtl32(wxT("comctl32.dll"));
+        if ( !dllComCtl32.IsLoaded() )
+        {
+            s_verComCtl32 = 0;
+            return 0;
+        }
+
+        // try DllGetVersion() for recent DLLs
+        s_verComCtl32 = CallDllGetVersion(dllComCtl32);

 
 

-        if (! theProc)
-        {                    // not found, must be 4.00
-      version = 400;
+        // if DllGetVersion() is unavailable either during compile or
+        // run-time, try to guess the version otherwise
+        if ( !s_verComCtl32 )
+        {
+            // InitCommonControlsEx is unique to 4.70 and later
+            void *pfn = dllComCtl32.GetSymbol(wxT("InitCommonControlsEx"));
+            if ( !pfn )
+            {
+                // not found, must be 4.00
+                s_verComCtl32 = 400;
+            }
+            else // 4.70+
+            {
+                // many symbols appeared in comctl32 4.71, could use any of
+                // them except may be DllInstall()
+                pfn = dllComCtl32.GetSymbol(wxT("InitializeFlatSB"));
+                if ( !pfn )
+                {
+                    // not found, must be 4.70
+                    s_verComCtl32 = 470;
+                }
+                else
+                {
+                    // found, must be 4.71 or later
+                    s_verComCtl32 = 471;
+                }
+            }

         }
         }

-        else
+    }
+
+    return s_verComCtl32;
+}
+
+/* static */
+int wxApp::GetShell32Version()
+{
+    static int s_verShell32 = -1;
+    if ( s_verShell32 == -1 )
+    {
+        // we're prepared to handle the errors
+        wxLogNull noLog;
+
+        wxDynamicLibrary dllShell32(wxT("shell32.dll"), wxDL_VERBATIM);
+        if ( dllShell32.IsLoaded() )

         {
         {

-      // The following symbol are unique to 4.71
-      //   DllInstall
-      //   FlatSB_EnableScrollBar FlatSB_GetScrollInfo FlatSB_GetScrollPos
-      //   FlatSB_GetScrollProp FlatSB_GetScrollRange FlatSB_SetScrollInfo
-      //   FlatSB_SetScrollPos FlatSB_SetScrollProp FlatSB_SetScrollRange
-      //   FlatSB_ShowScrollBar
-      //   _DrawIndirectImageList _DuplicateImageList
-      //   InitializeFlatSB
-      //   UninitializeFlatSB
-      // we could check for any of these - I chose DllInstall
-      FARPROC theProc = ::GetProcAddress(theModule, "DllInstall");
-      if (! theProc)
-      {
-        // not found, must be 4.70
-        version = 470;
-      }
-      else
-      {                         // found, must be 4.71
-        version = 471;
-      }
+            s_verShell32 = CallDllGetVersion(dllShell32);
+
+            if ( !s_verShell32 )
+            {
+                // there doesn't seem to be any way to distinguish between 4.00
+                // and 4.70 (starting from 4.71 we have DllGetVersion()) so
+                // just assume it is 4.0
+                s_verShell32 = 400;
+            }
+        }
+        else // failed load the DLL?
+        {
+            s_verShell32 = 0;

         }
     }
         }
     }

-    return version;
+
+    return s_verShell32;

 }
 
 }
 

-void wxExit()
+#else // !wxUSE_DYNLIB_CLASS
+
+/* static */
+int wxApp::GetComCtl32Version()

 {
 {

-  wxApp::CleanUp();
-  FatalAppExit(0, "Fatal error: exiting");
+    return 0;

 }
 
 }
 

-// Yield to incoming messages
-bool wxYield()
+/* static */
+int wxApp::GetShell32Version()

 {
 {

-  MSG msg;
-  // We want to go back to the main message loop
-  // if we see a WM_QUIT. (?)
-  while (PeekMessage(&msg, NULL, 0, 0, PM_NOREMOVE) && msg.message != WM_QUIT)
-  {
-    if (!wxTheApp->DoMessage())
-      break;
-  }
-
-  return TRUE;
+    return 0;

 }
 
 }
 

-HINSTANCE wxGetInstance()
+#endif // wxUSE_DYNLIB_CLASS/!wxUSE_DYNLIB_CLASS
+
+#endif // !__WXWINCE__
+
+#if wxUSE_EXCEPTIONS
+
+// ----------------------------------------------------------------------------
+// exception handling
+// ----------------------------------------------------------------------------
+
+bool wxApp::OnExceptionInMainLoop()

 {
 {

-  return wxhInstance;
+    // ask the user about what to do: use the Win32 API function here as it
+    // could be dangerous to use any wxWidgets code in this state
+    switch (
+            ::MessageBox
+              (
+                NULL,
+                wxT("An unhandled exception occurred. Press \"Abort\" to \
+terminate the program,\r\n\
+\"Retry\" to exit the program normally and \"Ignore\" to try to continue."),
+                wxT("Unhandled exception"),
+                MB_ABORTRETRYIGNORE |
+                MB_ICONERROR|
+                MB_TASKMODAL
+              )
+           )
+    {
+        case IDABORT:
+            throw;
+
+        default:
+            wxFAIL_MSG( wxT("unexpected MessageBox() return code") );
+            // fall through
+
+        case IDRETRY:
+            return false;
+
+        case IDIGNORE:
+            return true;
+    }

 }
 
 }
 

-// For some reason, with MSVC++ 1.5, WinMain isn't linked in properly
-// if in a separate file. So include it here to ensure it's linked.
-#if (defined(_MSC_VER) && !defined(__WIN32__)) || defined(__GNUWIN32__)
-  #include "main.cpp"
-#endif
+#endif // wxUSE_EXCEPTIONS