1 /////////////////////////////////////////////////////////////////////////////
2 // Name: src/msw/app.cpp
4 // Author: Julian Smart
8 // Copyright: (c) Julian Smart
9 // Licence: wxWindows licence
10 /////////////////////////////////////////////////////////////////////////////
12 // ===========================================================================
14 // ===========================================================================
16 // ---------------------------------------------------------------------------
18 // ---------------------------------------------------------------------------
20 // For compilers that support precompilation, includes "wx.h".
21 #include "wx/wxprec.h"
23 #if defined(__BORLANDC__)
31 #include "wx/gdicmn.h"
34 #include "wx/cursor.h"
36 #include "wx/palette.h"
38 #include "wx/dialog.h"
39 #include "wx/msgdlg.h"
41 #include "wx/dynarray.h"
42 #include "wx/wxchar.h"
47 #include "wx/apptrait.h"
48 #include "wx/filename.h"
49 #include "wx/module.h"
50 #include "wx/dynlib.h"
52 #include "wx/msw/private.h"
53 #include "wx/msw/ole/oleutils.h"
56 #include "wx/tooltip.h"
57 #endif // wxUSE_TOOLTIPS
59 // OLE is used for drag-and-drop, clipboard, OLE Automation..., but some
60 // compilers don't support it (missing headers, libs, ...)
61 #if defined(__GNUWIN32_OLD__) || defined(__SYMANTEC__) || defined(__SALFORDC__)
65 #endif // broken compilers
67 #if defined(__POCKETPC__) || defined(__SMARTPHONE__)
79 #include "wx/msw/wrapcctl.h"
83 #include "wx/msw/wince/missing.h"
86 // instead of including <shlwapi.h> which is not part of the core SDK and not
87 // shipped at all with other compilers, we always define the parts of it we
88 // need here ourselves
90 // NB: DLLVER_PLATFORM_WINDOWS will be defined if shlwapi.h had been somehow
92 #ifndef DLLVER_PLATFORM_WINDOWS
93 // hopefully we don't need to change packing as DWORDs should be already
98 DWORD dwMajorVersion
; // Major version
99 DWORD dwMinorVersion
; // Minor version
100 DWORD dwBuildNumber
; // Build number
101 DWORD dwPlatformID
; // DLLVER_PLATFORM_*
104 typedef HRESULT (CALLBACK
* DLLGETVERSIONPROC
)(DLLVERSIONINFO
*);
105 #endif // defined(DLLVERSIONINFO)
108 // ---------------------------------------------------------------------------
110 // ---------------------------------------------------------------------------
112 extern wxList WXDLLEXPORT wxPendingDelete
;
114 #if !defined(__WXMICROWIN__) && !defined(__WXWINCE__)
115 extern void wxSetKeyboardHook(bool doIt
);
118 // NB: all "NoRedraw" classes must have the same names as the "normal" classes
119 // with NR suffix - wxWindow::MSWCreate() supposes this
121 WXDLLIMPEXP_CORE wxChar
*wxCanvasClassName
;
122 WXDLLIMPEXP_CORE wxChar
*wxCanvasClassNameNR
;
124 WXDLLIMPEXP_CORE
const wxChar
*wxCanvasClassName
= wxT("wxWindowClass");
125 WXDLLIMPEXP_CORE
const wxChar
*wxCanvasClassNameNR
= wxT("wxWindowClassNR");
127 WXDLLIMPEXP_CORE
const wxChar
*wxMDIFrameClassName
= wxT("wxMDIFrameClass");
128 WXDLLIMPEXP_CORE
const wxChar
*wxMDIFrameClassNameNoRedraw
= wxT("wxMDIFrameClassNR");
129 WXDLLIMPEXP_CORE
const wxChar
*wxMDIChildFrameClassName
= wxT("wxMDIChildFrameClass");
130 WXDLLIMPEXP_CORE
const wxChar
*wxMDIChildFrameClassNameNoRedraw
= wxT("wxMDIChildFrameClassNR");
132 // ----------------------------------------------------------------------------
134 // ----------------------------------------------------------------------------
136 LRESULT WXDLLEXPORT APIENTRY
wxWndProc(HWND
, UINT
, WPARAM
, LPARAM
);
138 // ===========================================================================
139 // wxGUIAppTraits implementation
140 // ===========================================================================
142 // private class which we use to pass parameters from BeforeChildWaitLoop() to
143 // AfterChildWaitLoop()
144 struct ChildWaitLoopData
146 ChildWaitLoopData(wxWindowDisabler
*wd_
, wxWindow
*winActive_
)
149 winActive
= winActive_
;
152 wxWindowDisabler
*wd
;
156 void *wxGUIAppTraits::BeforeChildWaitLoop()
159 We use a dirty hack here to disable all application windows (which we
160 must do because otherwise the calls to wxYield() could lead to some very
161 unexpected reentrancies in the users code) but to avoid losing
162 focus/activation entirely when the child process terminates which would
163 happen if we simply disabled everything using wxWindowDisabler. Indeed,
164 remember that Windows will never activate a disabled window and when the
165 last childs window is closed and Windows looks for a window to activate
166 all our windows are still disabled. There is no way to enable them in
167 time because we don't know when the childs windows are going to be
168 closed, so the solution we use here is to keep one special tiny frame
169 enabled all the time. Then when the child terminates it will get
170 activated and when we close it below -- after reenabling all the other
171 windows! -- the previously active window becomes activated again and
176 // first disable all existing windows
177 wxWindowDisabler
*wd
= new wxWindowDisabler
;
179 // then create an "invisible" frame: it has minimal size, is positioned
180 // (hopefully) outside the screen and doesn't appear on the taskbar
181 wxWindow
*winActive
= new wxFrame
183 wxTheApp
->GetTopWindow(),
186 wxPoint(32600, 32600),
188 wxDEFAULT_FRAME_STYLE
| wxFRAME_NO_TASKBAR
192 return new ChildWaitLoopData(wd
, winActive
);
195 void wxGUIAppTraits::AlwaysYield()
200 void wxGUIAppTraits::AfterChildWaitLoop(void *dataOrig
)
204 ChildWaitLoopData
* const data
= (ChildWaitLoopData
*)dataOrig
;
208 // finally delete the dummy frame and, as wd has been already destroyed and
209 // the other windows reenabled, the activation is going to return to the
210 // window which had had it before
211 data
->winActive
->Destroy();
213 // also delete the temporary data object itself
217 bool wxGUIAppTraits::DoMessageFromThreadWait()
219 // we should return false only if the app should exit, i.e. only if
220 // Dispatch() determines that the main event loop should terminate
221 return !wxTheApp
|| wxTheApp
->Dispatch();
224 wxToolkitInfo
& wxGUIAppTraits::GetToolkitInfo()
226 static wxToolkitInfo info
;
227 wxToolkitInfo
& baseInfo
= wxAppTraits::GetToolkitInfo();
228 info
.versionMajor
= baseInfo
.versionMajor
;
229 info
.versionMinor
= baseInfo
.versionMinor
;
230 info
.os
= baseInfo
.os
;
231 info
.shortName
= _T("msw");
232 info
.name
= _T("wxMSW");
233 #ifdef __WXUNIVERSAL__
234 info
.shortName
<< _T("univ");
235 info
.name
<< _T("/wxUniversal");
240 // ===========================================================================
241 // wxApp implementation
242 // ===========================================================================
244 int wxApp::m_nCmdShow
= SW_SHOWNORMAL
;
246 // ---------------------------------------------------------------------------
248 // ---------------------------------------------------------------------------
250 IMPLEMENT_DYNAMIC_CLASS(wxApp
, wxEvtHandler
)
252 BEGIN_EVENT_TABLE(wxApp
, wxEvtHandler
)
253 EVT_IDLE(wxApp::OnIdle
)
254 EVT_END_SESSION(wxApp::OnEndSession
)
255 EVT_QUERY_END_SESSION(wxApp::OnQueryEndSession
)
258 // class to ensure that wxAppBase::CleanUp() is called if our Initialize()
260 class wxCallBaseCleanup
263 wxCallBaseCleanup(wxApp
*app
) : m_app(app
) { }
264 ~wxCallBaseCleanup() { if ( m_app
) m_app
->wxAppBase::CleanUp(); }
266 void Dismiss() { m_app
= NULL
; }
273 bool wxApp::Initialize(int& argc
, wxChar
**argv
)
275 if ( !wxAppBase::Initialize(argc
, argv
) )
278 // ensure that base cleanup is done if we return too early
279 wxCallBaseCleanup
callBaseCleanup(this);
282 wxString tmp
= GetAppName();
283 tmp
+= wxT("ClassName");
284 wxCanvasClassName
= wxStrdup( tmp
.c_str() );
286 wxCanvasClassNameNR
= wxStrdup( tmp
.c_str() );
287 HWND hWnd
= FindWindow( wxCanvasClassNameNR
, NULL
);
290 SetForegroundWindow( (HWND
)(((DWORD
)hWnd
)|0x01) );
295 #if !defined(__WXMICROWIN__)
296 InitCommonControls();
297 #endif // !defined(__WXMICROWIN__)
299 #if defined(__SMARTPHONE__) || defined(__POCKETPC__)
300 SHInitExtraControls();
305 RegisterWindowClasses();
307 wxWinHandleHash
= new wxWinHashTable(wxKEY_INTEGER
, 100);
309 #if !defined(__WXMICROWIN__) && !defined(__WXWINCE__)
310 wxSetKeyboardHook(true);
313 callBaseCleanup
.Dismiss();
318 // ---------------------------------------------------------------------------
319 // RegisterWindowClasses
320 // ---------------------------------------------------------------------------
322 // TODO we should only register classes really used by the app. For this it
323 // would be enough to just delay the class registration until an attempt
324 // to create a window of this class is made.
325 bool wxApp::RegisterWindowClasses()
328 wxZeroMemory(wndclass
);
330 // for each class we register one with CS_(V|H)REDRAW style and one
331 // without for windows created with wxNO_FULL_REDRAW_ON_REPAINT flag
332 static const long styleNormal
= CS_HREDRAW
| CS_VREDRAW
| CS_DBLCLKS
;
333 static const long styleNoRedraw
= CS_DBLCLKS
;
335 // the fields which are common to all classes
336 wndclass
.lpfnWndProc
= (WNDPROC
)wxWndProc
;
337 wndclass
.hInstance
= wxhInstance
;
338 wndclass
.hCursor
= ::LoadCursor((HINSTANCE
)NULL
, IDC_ARROW
);
340 // register the class for all normal windows
341 wndclass
.hbrBackground
= (HBRUSH
)(COLOR_BTNFACE
+ 1);
342 wndclass
.lpszClassName
= wxCanvasClassName
;
343 wndclass
.style
= styleNormal
;
345 if ( !RegisterClass(&wndclass
) )
347 wxLogLastError(wxT("RegisterClass(frame)"));
351 wndclass
.lpszClassName
= wxCanvasClassNameNR
;
352 wndclass
.style
= styleNoRedraw
;
354 if ( !RegisterClass(&wndclass
) )
356 wxLogLastError(wxT("RegisterClass(no redraw frame)"));
359 // Register the MDI frame window class.
360 wndclass
.hbrBackground
= (HBRUSH
)NULL
; // paint MDI frame ourselves
361 wndclass
.lpszClassName
= wxMDIFrameClassName
;
362 wndclass
.style
= styleNormal
;
364 if ( !RegisterClass(&wndclass
) )
366 wxLogLastError(wxT("RegisterClass(MDI parent)"));
369 // "no redraw" MDI frame
370 wndclass
.lpszClassName
= wxMDIFrameClassNameNoRedraw
;
371 wndclass
.style
= styleNoRedraw
;
373 if ( !RegisterClass(&wndclass
) )
375 wxLogLastError(wxT("RegisterClass(no redraw MDI parent frame)"));
378 // Register the MDI child frame window class.
379 wndclass
.hbrBackground
= (HBRUSH
)(COLOR_WINDOW
+ 1);
380 wndclass
.lpszClassName
= wxMDIChildFrameClassName
;
381 wndclass
.style
= styleNormal
;
383 if ( !RegisterClass(&wndclass
) )
385 wxLogLastError(wxT("RegisterClass(MDI child)"));
388 // "no redraw" MDI child frame
389 wndclass
.lpszClassName
= wxMDIChildFrameClassNameNoRedraw
;
390 wndclass
.style
= styleNoRedraw
;
392 if ( !RegisterClass(&wndclass
) )
394 wxLogLastError(wxT("RegisterClass(no redraw MDI child)"));
400 // ---------------------------------------------------------------------------
401 // UnregisterWindowClasses
402 // ---------------------------------------------------------------------------
404 bool wxApp::UnregisterWindowClasses()
408 #ifndef __WXMICROWIN__
409 // MDI frame window class.
410 if ( !::UnregisterClass(wxMDIFrameClassName
, wxhInstance
) )
412 wxLogLastError(wxT("UnregisterClass(MDI parent)"));
417 // "no redraw" MDI frame
418 if ( !::UnregisterClass(wxMDIFrameClassNameNoRedraw
, wxhInstance
) )
420 wxLogLastError(wxT("UnregisterClass(no redraw MDI parent frame)"));
425 // MDI child frame window class.
426 if ( !::UnregisterClass(wxMDIChildFrameClassName
, wxhInstance
) )
428 wxLogLastError(wxT("UnregisterClass(MDI child)"));
433 // "no redraw" MDI child frame
434 if ( !::UnregisterClass(wxMDIChildFrameClassNameNoRedraw
, wxhInstance
) )
436 wxLogLastError(wxT("UnregisterClass(no redraw MDI child)"));
442 if ( !::UnregisterClass(wxCanvasClassName
, wxhInstance
) )
444 wxLogLastError(wxT("UnregisterClass(canvas)"));
449 if ( !::UnregisterClass(wxCanvasClassNameNR
, wxhInstance
) )
451 wxLogLastError(wxT("UnregisterClass(no redraw canvas)"));
455 #endif // __WXMICROWIN__
460 void wxApp::CleanUp()
462 // all objects pending for deletion must be deleted first, otherwise we
463 // would crash when they use wxWinHandleHash (and UnregisterWindowClasses()
464 // call wouldn't succeed as long as any windows still exist), so call the
465 // base class method first and only then do our clean up
466 wxAppBase::CleanUp();
468 #if !defined(__WXMICROWIN__) && !defined(__WXWINCE__)
469 wxSetKeyboardHook(false);
474 // for an EXE the classes are unregistered when it terminates but DLL may
475 // be loaded several times (load/unload/load) into the same process in
476 // which case the registration will fail after the first time if we don't
477 // unregister the classes now
478 UnregisterWindowClasses();
480 delete wxWinHandleHash
;
481 wxWinHandleHash
= NULL
;
484 free( wxCanvasClassName
);
485 free( wxCanvasClassNameNR
);
489 // ----------------------------------------------------------------------------
491 // ----------------------------------------------------------------------------
495 m_printMode
= wxPRINT_WINDOWS
;
500 // our cmd line arguments are allocated inside wxEntry(HINSTANCE), they
501 // don't come from main(), so we have to free them
505 // m_argv elements were allocated by wxStrdup()
509 // but m_argv itself -- using new[]
513 // ----------------------------------------------------------------------------
514 // wxApp idle handling
515 // ----------------------------------------------------------------------------
517 void wxApp::OnIdle(wxIdleEvent
& event
)
519 wxAppBase::OnIdle(event
);
521 #if wxUSE_DC_CACHEING
522 // automated DC cache management: clear the cached DCs and bitmap
523 // if it's likely that the app has finished with them, that is, we
524 // get an idle event and we're not dragging anything.
525 if (!::GetKeyState(MK_LBUTTON
) && !::GetKeyState(MK_MBUTTON
) && !::GetKeyState(MK_RBUTTON
))
527 #endif // wxUSE_DC_CACHEING
530 void wxApp::WakeUpIdle()
532 // Send the top window a dummy message so idle handler processing will
533 // start up again. Doing it this way ensures that the idle handler
534 // wakes up in the right thread (see also wxWakeUpMainThread() which does
535 // the same for the main app thread only)
536 wxWindow
*topWindow
= wxTheApp
->GetTopWindow();
539 if ( !::PostMessage(GetHwndOf(topWindow
), WM_NULL
, 0, 0) )
541 // should never happen
542 wxLogLastError(wxT("PostMessage(WM_NULL)"));
547 // ----------------------------------------------------------------------------
548 // other wxApp event hanlders
549 // ----------------------------------------------------------------------------
551 void wxApp::OnEndSession(wxCloseEvent
& WXUNUSED(event
))
554 GetTopWindow()->Close(true);
557 // Default behaviour: close the application with prompts. The
558 // user can veto the close, and therefore the end session.
559 void wxApp::OnQueryEndSession(wxCloseEvent
& event
)
563 if (!GetTopWindow()->Close(!event
.CanVeto()))
568 // ----------------------------------------------------------------------------
570 // ----------------------------------------------------------------------------
573 int wxApp::GetComCtl32Version()
575 #if defined(__WXMICROWIN__) || defined(__WXWINCE__)
580 // NB: this is MT-ok as in the worst case we'd compute s_verComCtl32 twice,
581 // but as its value should be the same both times it doesn't matter
582 static int s_verComCtl32
= -1;
584 if ( s_verComCtl32
== -1 )
586 // initally assume no comctl32.dll at all
589 // we're prepared to handle the errors
592 #if wxUSE_DYNLIB_CLASS
594 wxDynamicLibrary
dllComCtl32(_T("comctl32.dll"), wxDL_VERBATIM
);
596 // if so, then we can check for the version
597 if ( dllComCtl32
.IsLoaded() )
599 // now check if the function is available during run-time
600 wxDYNLIB_FUNCTION( DLLGETVERSIONPROC
, DllGetVersion
, dllComCtl32
);
601 if ( pfnDllGetVersion
)
604 dvi
.cbSize
= sizeof(dvi
);
606 HRESULT hr
= (*pfnDllGetVersion
)(&dvi
);
609 wxLogApiError(_T("DllGetVersion"), hr
);
613 // this is incompatible with _WIN32_IE values, but
614 // compatible with the other values returned by
615 // GetComCtl32Version()
616 s_verComCtl32
= 100*dvi
.dwMajorVersion
+
621 // if DllGetVersion() is unavailable either during compile or
622 // run-time, try to guess the version otherwise
623 if ( !s_verComCtl32
)
625 // InitCommonControlsEx is unique to 4.70 and later
626 void *pfn
= dllComCtl32
.GetSymbol(_T("InitCommonControlsEx"));
629 // not found, must be 4.00
634 // many symbols appeared in comctl32 4.71, could use any of
635 // them except may be DllInstall()
636 pfn
= dllComCtl32
.GetSymbol(_T("InitializeFlatSB"));
639 // not found, must be 4.70
644 // found, must be 4.71 or later
653 return s_verComCtl32
;
654 #endif // Microwin/!Microwin
657 // Yield to incoming messages
659 bool wxApp::Yield(bool onlyIfNeeded
)
662 static bool s_inYield
= false;
665 // disable log flushing from here because a call to wxYield() shouldn't
666 // normally result in message boxes popping up &c
674 wxFAIL_MSG( wxT("wxYield called recursively" ) );
682 // we don't want to process WM_QUIT from here - it should be processed in
683 // the main event loop in order to stop it
685 while ( PeekMessage(&msg
, (HWND
)0, 0, 0, PM_NOREMOVE
) &&
686 msg
.message
!= WM_QUIT
)
689 wxMutexGuiLeaveOrEnter();
690 #endif // wxUSE_THREADS
692 if ( !wxTheApp
->Dispatch() )
696 // if there are pending events, we must process them.
697 ProcessPendingEvents();
700 // let the logs be flashed again
711 // ----------------------------------------------------------------------------
712 // exception handling
713 // ----------------------------------------------------------------------------
715 bool wxApp::OnExceptionInMainLoop()
717 // ask the user about what to do: use the Win32 API function here as it
718 // could be dangerous to use any wxWidgets code in this state
723 _T("An unhandled exception occurred. Press \"Abort\" to \
724 terminate the program,\r\n\
725 \"Retry\" to exit the program normally and \"Ignore\" to try to continue."),
726 _T("Unhandled exception"),
727 MB_ABORTRETRYIGNORE
|
737 wxFAIL_MSG( _T("unexpected MessageBox() return code") );
748 #endif // wxUSE_EXCEPTIONS
750 // ----------------------------------------------------------------------------
751 // deprecated event loop functions
752 // ----------------------------------------------------------------------------
754 #if WXWIN_COMPATIBILITY_2_4
756 #include "wx/evtloop.h"
758 void wxApp::DoMessage(WXMSG
*pMsg
)
760 wxEventLoop
*evtLoop
= wxEventLoop::GetActive();
762 evtLoop
->ProcessMessage(pMsg
);
765 bool wxApp::DoMessage()
767 wxEventLoop
*evtLoop
= wxEventLoop::GetActive();
768 return evtLoop
? evtLoop
->Dispatch() : false;
771 bool wxApp::ProcessMessage(WXMSG
* pMsg
)
773 wxEventLoop
*evtLoop
= wxEventLoop::GetActive();
774 return evtLoop
&& evtLoop
->PreProcessMessage(pMsg
);
777 #endif // WXWIN_COMPATIBILITY_2_4