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__)
83 #include "wx/msw/wrapcctl.h"
87 #include "wx/msw/wince/missing.h"
90 // instead of including <shlwapi.h> which is not part of the core SDK and not
91 // shipped at all with other compilers, we always define the parts of it we
92 // need here ourselves
94 // NB: DLLVER_PLATFORM_WINDOWS will be defined if shlwapi.h had been somehow
96 #ifndef DLLVER_PLATFORM_WINDOWS
97 // hopefully we don't need to change packing as DWORDs should be already
102 DWORD dwMajorVersion
; // Major version
103 DWORD dwMinorVersion
; // Minor version
104 DWORD dwBuildNumber
; // Build number
105 DWORD dwPlatformID
; // DLLVER_PLATFORM_*
108 typedef HRESULT (CALLBACK
* DLLGETVERSIONPROC
)(DLLVERSIONINFO
*);
109 #endif // defined(DLLVERSIONINFO)
112 // ---------------------------------------------------------------------------
114 // ---------------------------------------------------------------------------
116 extern wxList WXDLLEXPORT wxPendingDelete
;
118 #if !defined(__WXMICROWIN__) && !defined(__WXWINCE__)
119 extern void wxSetKeyboardHook(bool doIt
);
122 // NB: all "NoRedraw" classes must have the same names as the "normal" classes
123 // with NR suffix - wxWindow::MSWCreate() supposes this
125 WXDLLIMPEXP_CORE wxChar
*wxCanvasClassName
;
126 WXDLLIMPEXP_CORE wxChar
*wxCanvasClassNameNR
;
128 WXDLLIMPEXP_CORE
const wxChar
*wxCanvasClassName
= wxT("wxWindowClass");
129 WXDLLIMPEXP_CORE
const wxChar
*wxCanvasClassNameNR
= wxT("wxWindowClassNR");
131 WXDLLIMPEXP_CORE
const wxChar
*wxMDIFrameClassName
= wxT("wxMDIFrameClass");
132 WXDLLIMPEXP_CORE
const wxChar
*wxMDIFrameClassNameNoRedraw
= wxT("wxMDIFrameClassNR");
133 WXDLLIMPEXP_CORE
const wxChar
*wxMDIChildFrameClassName
= wxT("wxMDIChildFrameClass");
134 WXDLLIMPEXP_CORE
const wxChar
*wxMDIChildFrameClassNameNoRedraw
= wxT("wxMDIChildFrameClassNR");
136 // ----------------------------------------------------------------------------
138 // ----------------------------------------------------------------------------
140 LRESULT WXDLLEXPORT APIENTRY
wxWndProc(HWND
, UINT
, WPARAM
, LPARAM
);
142 // ===========================================================================
143 // wxGUIAppTraits implementation
144 // ===========================================================================
146 // private class which we use to pass parameters from BeforeChildWaitLoop() to
147 // AfterChildWaitLoop()
148 struct ChildWaitLoopData
150 ChildWaitLoopData(wxWindowDisabler
*wd_
, wxWindow
*winActive_
)
153 winActive
= winActive_
;
156 wxWindowDisabler
*wd
;
160 void *wxGUIAppTraits::BeforeChildWaitLoop()
163 We use a dirty hack here to disable all application windows (which we
164 must do because otherwise the calls to wxYield() could lead to some very
165 unexpected reentrancies in the users code) but to avoid losing
166 focus/activation entirely when the child process terminates which would
167 happen if we simply disabled everything using wxWindowDisabler. Indeed,
168 remember that Windows will never activate a disabled window and when the
169 last childs window is closed and Windows looks for a window to activate
170 all our windows are still disabled. There is no way to enable them in
171 time because we don't know when the childs windows are going to be
172 closed, so the solution we use here is to keep one special tiny frame
173 enabled all the time. Then when the child terminates it will get
174 activated and when we close it below -- after reenabling all the other
175 windows! -- the previously active window becomes activated again and
180 // first disable all existing windows
181 wxWindowDisabler
*wd
= new wxWindowDisabler
;
183 // then create an "invisible" frame: it has minimal size, is positioned
184 // (hopefully) outside the screen and doesn't appear on the taskbar
185 wxWindow
*winActive
= new wxFrame
187 wxTheApp
->GetTopWindow(),
190 wxPoint(32600, 32600),
192 wxDEFAULT_FRAME_STYLE
| wxFRAME_NO_TASKBAR
196 return new ChildWaitLoopData(wd
, winActive
);
199 void wxGUIAppTraits::AlwaysYield()
204 void wxGUIAppTraits::AfterChildWaitLoop(void *dataOrig
)
208 ChildWaitLoopData
* const data
= (ChildWaitLoopData
*)dataOrig
;
212 // finally delete the dummy frame and, as wd has been already destroyed and
213 // the other windows reenabled, the activation is going to return to the
214 // window which had had it before
215 data
->winActive
->Destroy();
217 // also delete the temporary data object itself
221 bool wxGUIAppTraits::DoMessageFromThreadWait()
223 // we should return false only if the app should exit, i.e. only if
224 // Dispatch() determines that the main event loop should terminate
225 return !wxTheApp
|| wxTheApp
->Dispatch();
228 wxToolkitInfo
& wxGUIAppTraits::GetToolkitInfo()
230 static wxToolkitInfo info
;
231 wxToolkitInfo
& baseInfo
= wxAppTraits::GetToolkitInfo();
232 info
.versionMajor
= baseInfo
.versionMajor
;
233 info
.versionMinor
= baseInfo
.versionMinor
;
234 info
.os
= baseInfo
.os
;
235 info
.shortName
= _T("msw");
236 info
.name
= _T("wxMSW");
237 #ifdef __WXUNIVERSAL__
238 info
.shortName
<< _T("univ");
239 info
.name
<< _T("/wxUniversal");
244 // ===========================================================================
245 // wxApp implementation
246 // ===========================================================================
248 int wxApp::m_nCmdShow
= SW_SHOWNORMAL
;
250 // ---------------------------------------------------------------------------
252 // ---------------------------------------------------------------------------
254 IMPLEMENT_DYNAMIC_CLASS(wxApp
, wxEvtHandler
)
256 BEGIN_EVENT_TABLE(wxApp
, wxEvtHandler
)
257 EVT_IDLE(wxApp::OnIdle
)
258 EVT_END_SESSION(wxApp::OnEndSession
)
259 EVT_QUERY_END_SESSION(wxApp::OnQueryEndSession
)
262 // class to ensure that wxAppBase::CleanUp() is called if our Initialize()
264 class wxCallBaseCleanup
267 wxCallBaseCleanup(wxApp
*app
) : m_app(app
) { }
268 ~wxCallBaseCleanup() { if ( m_app
) m_app
->wxAppBase::CleanUp(); }
270 void Dismiss() { m_app
= NULL
; }
277 bool wxApp::Initialize(int& argc
, wxChar
**argv
)
279 if ( !wxAppBase::Initialize(argc
, argv
) )
282 // ensure that base cleanup is done if we return too early
283 wxCallBaseCleanup
callBaseCleanup(this);
286 wxString tmp
= GetAppName();
287 tmp
+= wxT("ClassName");
288 wxCanvasClassName
= wxStrdup( tmp
.c_str() );
290 wxCanvasClassNameNR
= wxStrdup( tmp
.c_str() );
291 HWND hWnd
= FindWindow( wxCanvasClassNameNR
, NULL
);
294 SetForegroundWindow( (HWND
)(((DWORD
)hWnd
)|0x01) );
299 #if defined(__WIN95__) && !defined(__WXMICROWIN__)
300 InitCommonControls();
303 #if defined(__SMARTPHONE__) || defined(__POCKETPC__)
304 SHInitExtraControls();
309 RegisterWindowClasses();
311 wxWinHandleHash
= new wxWinHashTable(wxKEY_INTEGER
, 100);
313 #if !defined(__WXMICROWIN__) && !defined(__WXWINCE__)
314 wxSetKeyboardHook(true);
317 callBaseCleanup
.Dismiss();
322 // ---------------------------------------------------------------------------
323 // RegisterWindowClasses
324 // ---------------------------------------------------------------------------
326 // TODO we should only register classes really used by the app. For this it
327 // would be enough to just delay the class registration until an attempt
328 // to create a window of this class is made.
329 bool wxApp::RegisterWindowClasses()
332 wxZeroMemory(wndclass
);
334 // for each class we register one with CS_(V|H)REDRAW style and one
335 // without for windows created with wxNO_FULL_REDRAW_ON_REPAINT flag
336 static const long styleNormal
= CS_HREDRAW
| CS_VREDRAW
| CS_DBLCLKS
;
337 static const long styleNoRedraw
= CS_DBLCLKS
;
339 // the fields which are common to all classes
340 wndclass
.lpfnWndProc
= (WNDPROC
)wxWndProc
;
341 wndclass
.hInstance
= wxhInstance
;
342 wndclass
.hCursor
= ::LoadCursor((HINSTANCE
)NULL
, IDC_ARROW
);
344 // register the class for all normal windows
345 wndclass
.hbrBackground
= (HBRUSH
)(COLOR_BTNFACE
+ 1);
346 wndclass
.lpszClassName
= wxCanvasClassName
;
347 wndclass
.style
= styleNormal
;
349 if ( !RegisterClass(&wndclass
) )
351 wxLogLastError(wxT("RegisterClass(frame)"));
355 wndclass
.lpszClassName
= wxCanvasClassNameNR
;
356 wndclass
.style
= styleNoRedraw
;
358 if ( !RegisterClass(&wndclass
) )
360 wxLogLastError(wxT("RegisterClass(no redraw frame)"));
363 // Register the MDI frame window class.
364 wndclass
.hbrBackground
= (HBRUSH
)NULL
; // paint MDI frame ourselves
365 wndclass
.lpszClassName
= wxMDIFrameClassName
;
366 wndclass
.style
= styleNormal
;
368 if ( !RegisterClass(&wndclass
) )
370 wxLogLastError(wxT("RegisterClass(MDI parent)"));
373 // "no redraw" MDI frame
374 wndclass
.lpszClassName
= wxMDIFrameClassNameNoRedraw
;
375 wndclass
.style
= styleNoRedraw
;
377 if ( !RegisterClass(&wndclass
) )
379 wxLogLastError(wxT("RegisterClass(no redraw MDI parent frame)"));
382 // Register the MDI child frame window class.
383 wndclass
.hbrBackground
= (HBRUSH
)(COLOR_WINDOW
+ 1);
384 wndclass
.lpszClassName
= wxMDIChildFrameClassName
;
385 wndclass
.style
= styleNormal
;
387 if ( !RegisterClass(&wndclass
) )
389 wxLogLastError(wxT("RegisterClass(MDI child)"));
392 // "no redraw" MDI child frame
393 wndclass
.lpszClassName
= wxMDIChildFrameClassNameNoRedraw
;
394 wndclass
.style
= styleNoRedraw
;
396 if ( !RegisterClass(&wndclass
) )
398 wxLogLastError(wxT("RegisterClass(no redraw MDI child)"));
404 // ---------------------------------------------------------------------------
405 // UnregisterWindowClasses
406 // ---------------------------------------------------------------------------
408 bool wxApp::UnregisterWindowClasses()
412 #ifndef __WXMICROWIN__
413 // MDI frame window class.
414 if ( !::UnregisterClass(wxMDIFrameClassName
, wxhInstance
) )
416 wxLogLastError(wxT("UnregisterClass(MDI parent)"));
421 // "no redraw" MDI frame
422 if ( !::UnregisterClass(wxMDIFrameClassNameNoRedraw
, wxhInstance
) )
424 wxLogLastError(wxT("UnregisterClass(no redraw MDI parent frame)"));
429 // MDI child frame window class.
430 if ( !::UnregisterClass(wxMDIChildFrameClassName
, wxhInstance
) )
432 wxLogLastError(wxT("UnregisterClass(MDI child)"));
437 // "no redraw" MDI child frame
438 if ( !::UnregisterClass(wxMDIChildFrameClassNameNoRedraw
, wxhInstance
) )
440 wxLogLastError(wxT("UnregisterClass(no redraw MDI child)"));
446 if ( !::UnregisterClass(wxCanvasClassName
, wxhInstance
) )
448 wxLogLastError(wxT("UnregisterClass(canvas)"));
453 if ( !::UnregisterClass(wxCanvasClassNameNR
, wxhInstance
) )
455 wxLogLastError(wxT("UnregisterClass(no redraw canvas)"));
459 #endif // __WXMICROWIN__
464 void wxApp::CleanUp()
466 // all objects pending for deletion must be deleted first, otherwise we
467 // would crash when they use wxWinHandleHash (and UnregisterWindowClasses()
468 // call wouldn't succeed as long as any windows still exist), so call the
469 // base class method first and only then do our clean up
470 wxAppBase::CleanUp();
472 #if !defined(__WXMICROWIN__) && !defined(__WXWINCE__)
473 wxSetKeyboardHook(false);
478 // for an EXE the classes are unregistered when it terminates but DLL may
479 // be loaded several times (load/unload/load) into the same process in
480 // which case the registration will fail after the first time if we don't
481 // unregister the classes now
482 UnregisterWindowClasses();
484 delete wxWinHandleHash
;
485 wxWinHandleHash
= NULL
;
488 free( wxCanvasClassName
);
489 free( wxCanvasClassNameNR
);
493 // ----------------------------------------------------------------------------
495 // ----------------------------------------------------------------------------
499 m_printMode
= wxPRINT_WINDOWS
;
504 // our cmd line arguments are allocated inside wxEntry(HINSTANCE), they
505 // don't come from main(), so we have to free them
509 // m_argv elements were allocated by wxStrdup()
513 // but m_argv itself -- using new[]
517 // ----------------------------------------------------------------------------
518 // wxApp idle handling
519 // ----------------------------------------------------------------------------
521 void wxApp::OnIdle(wxIdleEvent
& event
)
523 wxAppBase::OnIdle(event
);
525 #if wxUSE_DC_CACHEING
526 // automated DC cache management: clear the cached DCs and bitmap
527 // if it's likely that the app has finished with them, that is, we
528 // get an idle event and we're not dragging anything.
529 if (!::GetKeyState(MK_LBUTTON
) && !::GetKeyState(MK_MBUTTON
) && !::GetKeyState(MK_RBUTTON
))
531 #endif // wxUSE_DC_CACHEING
534 void wxApp::WakeUpIdle()
536 // Send the top window a dummy message so idle handler processing will
537 // start up again. Doing it this way ensures that the idle handler
538 // wakes up in the right thread (see also wxWakeUpMainThread() which does
539 // the same for the main app thread only)
540 wxWindow
*topWindow
= wxTheApp
->GetTopWindow();
543 if ( !::PostMessage(GetHwndOf(topWindow
), WM_NULL
, 0, 0) )
545 // should never happen
546 wxLogLastError(wxT("PostMessage(WM_NULL)"));
551 // ----------------------------------------------------------------------------
552 // other wxApp event hanlders
553 // ----------------------------------------------------------------------------
555 void wxApp::OnEndSession(wxCloseEvent
& WXUNUSED(event
))
558 GetTopWindow()->Close(true);
561 // Default behaviour: close the application with prompts. The
562 // user can veto the close, and therefore the end session.
563 void wxApp::OnQueryEndSession(wxCloseEvent
& event
)
567 if (!GetTopWindow()->Close(!event
.CanVeto()))
572 // ----------------------------------------------------------------------------
574 // ----------------------------------------------------------------------------
577 int wxApp::GetComCtl32Version()
579 #if defined(__WXMICROWIN__) || defined(__WXWINCE__)
584 // NB: this is MT-ok as in the worst case we'd compute s_verComCtl32 twice,
585 // but as its value should be the same both times it doesn't matter
586 static int s_verComCtl32
= -1;
588 if ( s_verComCtl32
== -1 )
590 // initally assume no comctl32.dll at all
593 // we're prepared to handle the errors
597 wxDynamicLibrary
dllComCtl32(_T("comctl32.dll"), wxDL_VERBATIM
);
599 // if so, then we can check for the version
600 if ( dllComCtl32
.IsLoaded() )
602 // now check if the function is available during run-time
603 wxDYNLIB_FUNCTION( DLLGETVERSIONPROC
, DllGetVersion
, dllComCtl32
);
604 if ( pfnDllGetVersion
)
607 dvi
.cbSize
= sizeof(dvi
);
609 HRESULT hr
= (*pfnDllGetVersion
)(&dvi
);
612 wxLogApiError(_T("DllGetVersion"), hr
);
616 // this is incompatible with _WIN32_IE values, but
617 // compatible with the other values returned by
618 // GetComCtl32Version()
619 s_verComCtl32
= 100*dvi
.dwMajorVersion
+
624 // if DllGetVersion() is unavailable either during compile or
625 // run-time, try to guess the version otherwise
626 if ( !s_verComCtl32
)
628 // InitCommonControlsEx is unique to 4.70 and later
629 void *pfn
= dllComCtl32
.GetSymbol(_T("InitCommonControlsEx"));
632 // not found, must be 4.00
637 // many symbols appeared in comctl32 4.71, could use any of
638 // them except may be DllInstall()
639 pfn
= dllComCtl32
.GetSymbol(_T("InitializeFlatSB"));
642 // not found, must be 4.70
647 // found, must be 4.71 or later
655 return s_verComCtl32
;
656 #endif // Microwin/!Microwin
659 // Yield to incoming messages
661 bool wxApp::Yield(bool onlyIfNeeded
)
664 static bool s_inYield
= false;
667 // disable log flushing from here because a call to wxYield() shouldn't
668 // normally result in message boxes popping up &c
676 wxFAIL_MSG( wxT("wxYield called recursively" ) );
684 // we don't want to process WM_QUIT from here - it should be processed in
685 // the main event loop in order to stop it
687 while ( PeekMessage(&msg
, (HWND
)0, 0, 0, PM_NOREMOVE
) &&
688 msg
.message
!= WM_QUIT
)
691 wxMutexGuiLeaveOrEnter();
692 #endif // wxUSE_THREADS
694 if ( !wxTheApp
->Dispatch() )
698 // if there are pending events, we must process them.
699 ProcessPendingEvents();
702 // let the logs be flashed again
713 // ----------------------------------------------------------------------------
714 // exception handling
715 // ----------------------------------------------------------------------------
717 bool wxApp::OnExceptionInMainLoop()
719 // ask the user about what to do: use the Win32 API function here as it
720 // could be dangerous to use any wxWidgets code in this state
725 _T("An unhandled exception occurred. Press \"Abort\" to \
726 terminate the program,\r\n\
727 \"Retry\" to exit the program normally and \"Ignore\" to try to continue."),
728 _T("Unhandled exception"),
729 MB_ABORTRETRYIGNORE
|
739 wxFAIL_MSG( _T("unexpected MessageBox() return code") );
750 #endif // wxUSE_EXCEPTIONS
752 // ----------------------------------------------------------------------------
753 // deprecated event loop functions
754 // ----------------------------------------------------------------------------
756 #if WXWIN_COMPATIBILITY_2_4
758 #include "wx/evtloop.h"
760 void wxApp::DoMessage(WXMSG
*pMsg
)
762 wxEventLoop
*evtLoop
= wxEventLoop::GetActive();
764 evtLoop
->ProcessMessage(pMsg
);
767 bool wxApp::DoMessage()
769 wxEventLoop
*evtLoop
= wxEventLoop::GetActive();
770 return evtLoop
? evtLoop
->Dispatch() : false;
773 bool wxApp::ProcessMessage(WXMSG
* pMsg
)
775 wxEventLoop
*evtLoop
= wxEventLoop::GetActive();
776 return evtLoop
&& evtLoop
->PreProcessMessage(pMsg
);
779 #endif // WXWIN_COMPATIBILITY_2_4