1 /////////////////////////////////////////////////////////////////////////////
4 // Author: Julian Smart
8 // Copyright: (c) Julian Smart
9 // Licence: wxWindows licence
10 /////////////////////////////////////////////////////////////////////////////
12 // ===========================================================================
14 // ===========================================================================
16 // ---------------------------------------------------------------------------
18 // ---------------------------------------------------------------------------
20 #if defined(__GNUG__) && !defined(NO_GCC_PRAGMA)
21 #pragma implementation "app.h"
24 // For compilers that support precompilation, includes "wx.h".
25 #include "wx/wxprec.h"
27 #if defined(__BORLANDC__)
35 #include "wx/gdicmn.h"
38 #include "wx/cursor.h"
40 #include "wx/palette.h"
42 #include "wx/dialog.h"
43 #include "wx/msgdlg.h"
45 #include "wx/dynarray.h"
46 #include "wx/wxchar.h"
51 #include "wx/apptrait.h"
52 #include "wx/filename.h"
53 #include "wx/module.h"
54 #include "wx/dynlib.h"
56 #include "wx/msw/private.h"
57 #include "wx/msw/ole/oleutils.h"
60 #include "wx/tooltip.h"
61 #endif // wxUSE_TOOLTIPS
63 // OLE is used for drag-and-drop, clipboard, OLE Automation..., but some
64 // compilers don't support it (missing headers, libs, ...)
65 #if defined(__GNUWIN32_OLD__) || defined(__SYMANTEC__) || defined(__SALFORDC__)
69 #endif // broken compilers
71 #if defined(__POCKETPC__) || defined(__SMARTPHONE__)
82 #include "wx/msw/wrapcctl.h"
86 #include "wx/msw/wince/missing.h"
89 // For DLLVER_PLATFORM_WINDOWS
90 #if (!defined(__MINGW32__) || wxCHECK_W32API_VERSION( 2, 0 )) && \
91 !defined(__CYGWIN__) && !defined(__DIGITALMARS__) && !defined(__WXWINCE__) && \
92 (!defined(_MSC_VER) || (_MSC_VER > 1100))
96 // ---------------------------------------------------------------------------
98 // ---------------------------------------------------------------------------
100 extern wxList WXDLLEXPORT wxPendingDelete
;
102 #if !defined(__WXMICROWIN__) && !defined(__WXWINCE__)
103 extern void wxSetKeyboardHook(bool doIt
);
106 // NB: all "NoRedraw" classes must have the same names as the "normal" classes
107 // with NR suffix - wxWindow::MSWCreate() supposes this
109 WXDLLIMPEXP_CORE wxChar
*wxCanvasClassName
;
110 WXDLLIMPEXP_CORE wxChar
*wxCanvasClassNameNR
;
112 WXDLLIMPEXP_CORE
const wxChar
*wxCanvasClassName
= wxT("wxWindowClass");
113 WXDLLIMPEXP_CORE
const wxChar
*wxCanvasClassNameNR
= wxT("wxWindowClassNR");
115 WXDLLIMPEXP_CORE
const wxChar
*wxMDIFrameClassName
= wxT("wxMDIFrameClass");
116 WXDLLIMPEXP_CORE
const wxChar
*wxMDIFrameClassNameNoRedraw
= wxT("wxMDIFrameClassNR");
117 WXDLLIMPEXP_CORE
const wxChar
*wxMDIChildFrameClassName
= wxT("wxMDIChildFrameClass");
118 WXDLLIMPEXP_CORE
const wxChar
*wxMDIChildFrameClassNameNoRedraw
= wxT("wxMDIChildFrameClassNR");
120 // ----------------------------------------------------------------------------
122 // ----------------------------------------------------------------------------
124 LRESULT WXDLLEXPORT APIENTRY
wxWndProc(HWND
, UINT
, WPARAM
, LPARAM
);
126 // ===========================================================================
127 // wxGUIAppTraits implementation
128 // ===========================================================================
130 // private class which we use to pass parameters from BeforeChildWaitLoop() to
131 // AfterChildWaitLoop()
132 struct ChildWaitLoopData
134 ChildWaitLoopData(wxWindowDisabler
*wd_
, wxWindow
*winActive_
)
137 winActive
= winActive_
;
140 wxWindowDisabler
*wd
;
144 void *wxGUIAppTraits::BeforeChildWaitLoop()
147 We use a dirty hack here to disable all application windows (which we
148 must do because otherwise the calls to wxYield() could lead to some very
149 unexpected reentrancies in the users code) but to avoid losing
150 focus/activation entirely when the child process terminates which would
151 happen if we simply disabled everything using wxWindowDisabler. Indeed,
152 remember that Windows will never activate a disabled window and when the
153 last childs window is closed and Windows looks for a window to activate
154 all our windows are still disabled. There is no way to enable them in
155 time because we don't know when the childs windows are going to be
156 closed, so the solution we use here is to keep one special tiny frame
157 enabled all the time. Then when the child terminates it will get
158 activated and when we close it below -- after reenabling all the other
159 windows! -- the previously active window becomes activated again and
164 // first disable all existing windows
165 wxWindowDisabler
*wd
= new wxWindowDisabler
;
167 // then create an "invisible" frame: it has minimal size, is positioned
168 // (hopefully) outside the screen and doesn't appear on the taskbar
169 wxWindow
*winActive
= new wxFrame
171 wxTheApp
->GetTopWindow(),
174 wxPoint(32600, 32600),
176 wxDEFAULT_FRAME_STYLE
| wxFRAME_NO_TASKBAR
180 return new ChildWaitLoopData(wd
, winActive
);
183 void wxGUIAppTraits::AlwaysYield()
188 void wxGUIAppTraits::AfterChildWaitLoop(void *dataOrig
)
192 ChildWaitLoopData
* const data
= (ChildWaitLoopData
*)dataOrig
;
196 // finally delete the dummy frame and, as wd has been already destroyed and
197 // the other windows reenabled, the activation is going to return to the
198 // window which had had it before
199 data
->winActive
->Destroy();
201 // also delete the temporary data object itself
205 bool wxGUIAppTraits::DoMessageFromThreadWait()
207 // we should return false only if the app should exit, i.e. only if
208 // Dispatch() determines that the main event loop should terminate
209 return !wxTheApp
|| wxTheApp
->Dispatch();
212 wxToolkitInfo
& wxGUIAppTraits::GetToolkitInfo()
214 static wxToolkitInfo info
;
215 wxToolkitInfo
& baseInfo
= wxAppTraits::GetToolkitInfo();
216 info
.versionMajor
= baseInfo
.versionMajor
;
217 info
.versionMinor
= baseInfo
.versionMinor
;
218 info
.os
= baseInfo
.os
;
219 info
.shortName
= _T("msw");
220 info
.name
= _T("wxMSW");
221 #ifdef __WXUNIVERSAL__
222 info
.shortName
<< _T("univ");
223 info
.name
<< _T("/wxUniversal");
228 // ===========================================================================
229 // wxApp implementation
230 // ===========================================================================
232 int wxApp::m_nCmdShow
= SW_SHOWNORMAL
;
234 // ---------------------------------------------------------------------------
236 // ---------------------------------------------------------------------------
238 IMPLEMENT_DYNAMIC_CLASS(wxApp
, wxEvtHandler
)
240 BEGIN_EVENT_TABLE(wxApp
, wxEvtHandler
)
241 EVT_IDLE(wxApp::OnIdle
)
242 EVT_END_SESSION(wxApp::OnEndSession
)
243 EVT_QUERY_END_SESSION(wxApp::OnQueryEndSession
)
246 // class to ensure that wxAppBase::CleanUp() is called if our Initialize()
248 class wxCallBaseCleanup
251 wxCallBaseCleanup(wxApp
*app
) : m_app(app
) { }
252 ~wxCallBaseCleanup() { if ( m_app
) m_app
->wxAppBase::CleanUp(); }
254 void Dismiss() { m_app
= NULL
; }
261 bool wxApp::Initialize(int& argc
, wxChar
**argv
)
263 if ( !wxAppBase::Initialize(argc
, argv
) )
266 // ensure that base cleanup is done if we return too early
267 wxCallBaseCleanup
callBaseCleanup(this);
270 wxString tmp
= GetAppName();
271 tmp
+= wxT("ClassName");
272 wxCanvasClassName
= wxStrdup( tmp
.c_str() );
274 wxCanvasClassNameNR
= wxStrdup( tmp
.c_str() );
275 HWND hWnd
= FindWindow( wxCanvasClassNameNR
, NULL
);
278 SetForegroundWindow( (HWND
)(((DWORD
)hWnd
)|0x01) );
283 // the first thing to do is to check if we're trying to run an Unicode
284 // program under Win9x w/o MSLU emulation layer - if so, abort right now
285 // as it has no chance to work
286 #if wxUSE_UNICODE && !wxUSE_UNICODE_MSLU
287 if ( wxGetOsVersion() != wxWINDOWS_NT
&& wxGetOsVersion() != wxWINDOWS_CE
&& wxGetOsVersion() != wxWINDOWS_SMARTPHONE
&& wxGetOsVersion() != wxWINDOWS_POCKETPC
)
289 // note that we can use MessageBoxW() as it's implemented even under
290 // Win9x - OTOH, we can't use wxGetTranslation() because the file APIs
291 // used by wxLocale are not
295 _T("This program uses Unicode and requires Windows NT/2000/XP/CE.\nProgram aborted."),
296 _T("wxWidgets Fatal Error"),
302 #endif // wxUSE_UNICODE && !wxUSE_UNICODE_MSLU
304 #if defined(__WIN95__) && !defined(__WXMICROWIN__)
305 InitCommonControls();
308 #if defined(__SMARTPHONE__) || defined(__POCKETPC__)
309 SHInitExtraControls();
314 RegisterWindowClasses();
320 wxWinHandleHash
= new wxWinHashTable(wxKEY_INTEGER
, 100);
322 #if !defined(__WXMICROWIN__) && !defined(__WXWINCE__)
323 wxSetKeyboardHook(true);
326 callBaseCleanup
.Dismiss();
331 // ---------------------------------------------------------------------------
332 // RegisterWindowClasses
333 // ---------------------------------------------------------------------------
335 // TODO we should only register classes really used by the app. For this it
336 // would be enough to just delay the class registration until an attempt
337 // to create a window of this class is made.
338 bool wxApp::RegisterWindowClasses()
341 wxZeroMemory(wndclass
);
343 // for each class we register one with CS_(V|H)REDRAW style and one
344 // without for windows created with wxNO_FULL_REDRAW_ON_REPAINT flag
345 static const long styleNormal
= CS_HREDRAW
| CS_VREDRAW
| CS_DBLCLKS
;
346 static const long styleNoRedraw
= CS_DBLCLKS
;
348 // the fields which are common to all classes
349 wndclass
.lpfnWndProc
= (WNDPROC
)wxWndProc
;
350 wndclass
.hInstance
= wxhInstance
;
351 wndclass
.hCursor
= ::LoadCursor((HINSTANCE
)NULL
, IDC_ARROW
);
353 // register the class for all normal windows
354 wndclass
.hbrBackground
= (HBRUSH
)(COLOR_BTNFACE
+ 1);
355 wndclass
.lpszClassName
= wxCanvasClassName
;
356 wndclass
.style
= styleNormal
;
358 if ( !RegisterClass(&wndclass
) )
360 wxLogLastError(wxT("RegisterClass(frame)"));
364 wndclass
.lpszClassName
= wxCanvasClassNameNR
;
365 wndclass
.style
= styleNoRedraw
;
367 if ( !RegisterClass(&wndclass
) )
369 wxLogLastError(wxT("RegisterClass(no redraw frame)"));
372 // Register the MDI frame window class.
373 wndclass
.hbrBackground
= (HBRUSH
)NULL
; // paint MDI frame ourselves
374 wndclass
.lpszClassName
= wxMDIFrameClassName
;
375 wndclass
.style
= styleNormal
;
377 if ( !RegisterClass(&wndclass
) )
379 wxLogLastError(wxT("RegisterClass(MDI parent)"));
382 // "no redraw" MDI frame
383 wndclass
.lpszClassName
= wxMDIFrameClassNameNoRedraw
;
384 wndclass
.style
= styleNoRedraw
;
386 if ( !RegisterClass(&wndclass
) )
388 wxLogLastError(wxT("RegisterClass(no redraw MDI parent frame)"));
391 // Register the MDI child frame window class.
392 wndclass
.hbrBackground
= (HBRUSH
)(COLOR_WINDOW
+ 1);
393 wndclass
.lpszClassName
= wxMDIChildFrameClassName
;
394 wndclass
.style
= styleNormal
;
396 if ( !RegisterClass(&wndclass
) )
398 wxLogLastError(wxT("RegisterClass(MDI child)"));
401 // "no redraw" MDI child frame
402 wndclass
.lpszClassName
= wxMDIChildFrameClassNameNoRedraw
;
403 wndclass
.style
= styleNoRedraw
;
405 if ( !RegisterClass(&wndclass
) )
407 wxLogLastError(wxT("RegisterClass(no redraw MDI child)"));
413 // ---------------------------------------------------------------------------
414 // UnregisterWindowClasses
415 // ---------------------------------------------------------------------------
417 bool wxApp::UnregisterWindowClasses()
421 #ifndef __WXMICROWIN__
422 // MDI frame window class.
423 if ( !::UnregisterClass(wxMDIFrameClassName
, wxhInstance
) )
425 wxLogLastError(wxT("UnregisterClass(MDI parent)"));
430 // "no redraw" MDI frame
431 if ( !::UnregisterClass(wxMDIFrameClassNameNoRedraw
, wxhInstance
) )
433 wxLogLastError(wxT("UnregisterClass(no redraw MDI parent frame)"));
438 // MDI child frame window class.
439 if ( !::UnregisterClass(wxMDIChildFrameClassName
, wxhInstance
) )
441 wxLogLastError(wxT("UnregisterClass(MDI child)"));
446 // "no redraw" MDI child frame
447 if ( !::UnregisterClass(wxMDIChildFrameClassNameNoRedraw
, wxhInstance
) )
449 wxLogLastError(wxT("UnregisterClass(no redraw MDI child)"));
455 if ( !::UnregisterClass(wxCanvasClassName
, wxhInstance
) )
457 wxLogLastError(wxT("UnregisterClass(canvas)"));
462 if ( !::UnregisterClass(wxCanvasClassNameNR
, wxhInstance
) )
464 wxLogLastError(wxT("UnregisterClass(no redraw canvas)"));
468 #endif // __WXMICROWIN__
473 void wxApp::CleanUp()
475 // all objects pending for deletion must be deleted first, otherwise we
476 // would crash when they use wxWinHandleHash (and UnregisterWindowClasses()
477 // call wouldn't succeed as long as any windows still exist), so call the
478 // base class method first and only then do our clean up
479 wxAppBase::CleanUp();
481 #if !defined(__WXMICROWIN__) && !defined(__WXWINCE__)
482 wxSetKeyboardHook(false);
491 // for an EXE the classes are unregistered when it terminates but DLL may
492 // be loaded several times (load/unload/load) into the same process in
493 // which case the registration will fail after the first time if we don't
494 // unregister the classes now
495 UnregisterWindowClasses();
497 delete wxWinHandleHash
;
498 wxWinHandleHash
= NULL
;
501 free( wxCanvasClassName
);
502 free( wxCanvasClassNameNR
);
506 // ----------------------------------------------------------------------------
508 // ----------------------------------------------------------------------------
512 m_printMode
= wxPRINT_WINDOWS
;
517 // our cmd line arguments are allocated inside wxEntry(HINSTANCE), they
518 // don't come from main(), so we have to free them
522 // m_argv elements were allocated by wxStrdup()
526 // but m_argv itself -- using new[]
530 // ----------------------------------------------------------------------------
531 // wxApp idle handling
532 // ----------------------------------------------------------------------------
534 void wxApp::OnIdle(wxIdleEvent
& event
)
536 wxAppBase::OnIdle(event
);
538 #if wxUSE_DC_CACHEING
539 // automated DC cache management: clear the cached DCs and bitmap
540 // if it's likely that the app has finished with them, that is, we
541 // get an idle event and we're not dragging anything.
542 if (!::GetKeyState(MK_LBUTTON
) && !::GetKeyState(MK_MBUTTON
) && !::GetKeyState(MK_RBUTTON
))
544 #endif // wxUSE_DC_CACHEING
547 void wxApp::WakeUpIdle()
549 // Send the top window a dummy message so idle handler processing will
550 // start up again. Doing it this way ensures that the idle handler
551 // wakes up in the right thread (see also wxWakeUpMainThread() which does
552 // the same for the main app thread only)
553 wxWindow
*topWindow
= wxTheApp
->GetTopWindow();
556 if ( !::PostMessage(GetHwndOf(topWindow
), WM_NULL
, 0, 0) )
558 // should never happen
559 wxLogLastError(wxT("PostMessage(WM_NULL)"));
564 // ----------------------------------------------------------------------------
565 // other wxApp event hanlders
566 // ----------------------------------------------------------------------------
568 void wxApp::OnEndSession(wxCloseEvent
& WXUNUSED(event
))
571 GetTopWindow()->Close(true);
574 // Default behaviour: close the application with prompts. The
575 // user can veto the close, and therefore the end session.
576 void wxApp::OnQueryEndSession(wxCloseEvent
& event
)
580 if (!GetTopWindow()->Close(!event
.CanVeto()))
585 // ----------------------------------------------------------------------------
587 // ----------------------------------------------------------------------------
590 int wxApp::GetComCtl32Version()
592 #if defined(__WXMICROWIN__) || defined(__WXWINCE__)
597 // NB: this is MT-ok as in the worst case we'd compute s_verComCtl32 twice,
598 // but as its value should be the same both times it doesn't matter
599 static int s_verComCtl32
= -1;
601 if ( s_verComCtl32
== -1 )
603 // initally assume no comctl32.dll at all
606 // we're prepared to handle the errors
610 wxDynamicLibrary
dllComCtl32(_T("comctl32.dll"), wxDL_VERBATIM
);
612 // if so, then we can check for the version
613 if ( dllComCtl32
.IsLoaded() )
615 #ifndef DLLVER_PLATFORM_WINDOWS
616 typedef struct _DllVersionInfo
619 DWORD dwMajorVersion
; // Major version
620 DWORD dwMinorVersion
; // Minor version
621 DWORD dwBuildNumber
; // Build number
622 DWORD dwPlatformID
; // DLLVER_PLATFORM_*
624 typedef HRESULT (CALLBACK
* DLLGETVERSIONPROC
)(DLLVERSIONINFO
*);
626 // try to use DllGetVersion() if available in _headers_
627 wxDYNLIB_FUNCTION( DLLGETVERSIONPROC
, DllGetVersion
, dllComCtl32
);
628 if ( pfnDllGetVersion
)
631 dvi
.cbSize
= sizeof(dvi
);
633 HRESULT hr
= (*pfnDllGetVersion
)(&dvi
);
636 wxLogApiError(_T("DllGetVersion"), hr
);
640 // this is incompatible with _WIN32_IE values, but
641 // compatible with the other values returned by
642 // GetComCtl32Version()
643 s_verComCtl32
= 100*dvi
.dwMajorVersion
+
648 // if DllGetVersion() is unavailable either during compile or
649 // run-time, try to guess the version otherwise
650 if ( !s_verComCtl32
)
652 // InitCommonControlsEx is unique to 4.70 and later
653 void *pfn
= dllComCtl32
.GetSymbol(_T("InitCommonControlsEx"));
656 // not found, must be 4.00
661 // many symbols appeared in comctl32 4.71, could use any of
662 // them except may be DllInstall()
663 pfn
= dllComCtl32
.GetSymbol(_T("InitializeFlatSB"));
666 // not found, must be 4.70
671 // found, must be 4.71 or later
679 return s_verComCtl32
;
680 #endif // Microwin/!Microwin
683 // Yield to incoming messages
685 bool wxApp::Yield(bool onlyIfNeeded
)
688 static bool s_inYield
= false;
691 // disable log flushing from here because a call to wxYield() shouldn't
692 // normally result in message boxes popping up &c
700 wxFAIL_MSG( wxT("wxYield called recursively" ) );
708 // we don't want to process WM_QUIT from here - it should be processed in
709 // the main event loop in order to stop it
711 while ( PeekMessage(&msg
, (HWND
)0, 0, 0, PM_NOREMOVE
) &&
712 msg
.message
!= WM_QUIT
)
715 wxMutexGuiLeaveOrEnter();
716 #endif // wxUSE_THREADS
718 if ( !wxTheApp
->Dispatch() )
722 // if there are pending events, we must process them.
723 ProcessPendingEvents();
726 // let the logs be flashed again
737 // ----------------------------------------------------------------------------
738 // exception handling
739 // ----------------------------------------------------------------------------
741 bool wxApp::OnExceptionInMainLoop()
743 // ask the user about what to do: use the Win32 API function here as it
744 // could be dangerous to use any wxWidgets code in this state
749 _T("An unhandled exception occurred. Press \"Abort\" to \
750 terminate the program,\r\n\
751 \"Retry\" to exit the program normally and \"Ignore\" to try to continue."),
752 _T("Unhandled exception"),
753 MB_ABORTRETRYIGNORE
|
763 wxFAIL_MSG( _T("unexpected MessageBox() return code") );
774 #endif // wxUSE_EXCEPTIONS
776 // ----------------------------------------------------------------------------
777 // deprecated event loop functions
778 // ----------------------------------------------------------------------------
780 #if WXWIN_COMPATIBILITY_2_4
782 #include "wx/evtloop.h"
784 void wxApp::DoMessage(WXMSG
*pMsg
)
786 wxEventLoop
*evtLoop
= wxEventLoop::GetActive();
788 evtLoop
->ProcessMessage(pMsg
);
791 bool wxApp::DoMessage()
793 wxEventLoop
*evtLoop
= wxEventLoop::GetActive();
794 return evtLoop
? evtLoop
->Dispatch() : false;
797 bool wxApp::ProcessMessage(WXMSG
* pMsg
)
799 wxEventLoop
*evtLoop
= wxEventLoop::GetActive();
800 return evtLoop
&& evtLoop
->PreProcessMessage(pMsg
);
803 #endif // WXWIN_COMPATIBILITY_2_4