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"
59 #include "wx/tooltip.h"
60 #endif // wxUSE_TOOLTIPS
62 // OLE is used for drag-and-drop, clipboard, OLE Automation..., but some
63 // compilers don't support it (missing headers, libs, ...)
64 #if defined(__GNUWIN32_OLD__) || defined(__SYMANTEC__) || defined(__SALFORDC__)
68 #endif // broken compilers
77 #include "wx/msw/wrapcctl.h"
81 #include "wx/msw/wince/missing.h"
84 #if (!defined(__MINGW32__) || wxCHECK_W32API_VERSION( 2, 0 )) && \
85 !defined(__CYGWIN__) && !defined(__DIGITALMARS__) && !defined(__WXWINCE__) && \
86 (!defined(_MSC_VER) || (_MSC_VER > 1100))
90 // ---------------------------------------------------------------------------
92 // ---------------------------------------------------------------------------
94 extern wxList WXDLLEXPORT wxPendingDelete
;
96 #if !defined(__WXMICROWIN__) && !defined(__WXWINCE__)
97 extern void wxSetKeyboardHook(bool doIt
);
100 // NB: all "NoRedraw" classes must have the same names as the "normal" classes
101 // with NR suffix - wxWindow::MSWCreate() supposes this
103 wxChar
*wxCanvasClassName
;
104 wxChar
*wxCanvasClassNameNR
;
106 const wxChar
*wxCanvasClassName
= wxT("wxWindowClass");
107 const wxChar
*wxCanvasClassNameNR
= wxT("wxWindowClassNR");
109 const wxChar
*wxMDIFrameClassName
= wxT("wxMDIFrameClass");
110 const wxChar
*wxMDIFrameClassNameNoRedraw
= wxT("wxMDIFrameClassNR");
111 const wxChar
*wxMDIChildFrameClassName
= wxT("wxMDIChildFrameClass");
112 const wxChar
*wxMDIChildFrameClassNameNoRedraw
= wxT("wxMDIChildFrameClassNR");
114 HBRUSH wxDisableButtonBrush
= (HBRUSH
) 0;
116 // ----------------------------------------------------------------------------
118 // ----------------------------------------------------------------------------
120 LRESULT WXDLLEXPORT APIENTRY
wxWndProc(HWND
, UINT
, WPARAM
, LPARAM
);
122 // ===========================================================================
123 // wxGUIAppTraits implementation
124 // ===========================================================================
126 // private class which we use to pass parameters from BeforeChildWaitLoop() to
127 // AfterChildWaitLoop()
128 struct ChildWaitLoopData
130 ChildWaitLoopData(wxWindowDisabler
*wd_
, wxWindow
*winActive_
)
133 winActive
= winActive_
;
136 wxWindowDisabler
*wd
;
140 void *wxGUIAppTraits::BeforeChildWaitLoop()
143 We use a dirty hack here to disable all application windows (which we
144 must do because otherwise the calls to wxYield() could lead to some very
145 unexpected reentrancies in the users code) but to avoid losing
146 focus/activation entirely when the child process terminates which would
147 happen if we simply disabled everything using wxWindowDisabler. Indeed,
148 remember that Windows will never activate a disabled window and when the
149 last childs window is closed and Windows looks for a window to activate
150 all our windows are still disabled. There is no way to enable them in
151 time because we don't know when the childs windows are going to be
152 closed, so the solution we use here is to keep one special tiny frame
153 enabled all the time. Then when the child terminates it will get
154 activated and when we close it below -- after reenabling all the other
155 windows! -- the previously active window becomes activated again and
160 // first disable all existing windows
161 wxWindowDisabler
*wd
= new wxWindowDisabler
;
163 // then create an "invisible" frame: it has minimal size, is positioned
164 // (hopefully) outside the screen and doesn't appear on the taskbar
165 wxWindow
*winActive
= new wxFrame
167 wxTheApp
->GetTopWindow(),
170 wxPoint(32600, 32600),
172 wxDEFAULT_FRAME_STYLE
| wxFRAME_NO_TASKBAR
176 return new ChildWaitLoopData(wd
, winActive
);
179 void wxGUIAppTraits::AlwaysYield()
184 void wxGUIAppTraits::AfterChildWaitLoop(void *dataOrig
)
188 ChildWaitLoopData
* const data
= (ChildWaitLoopData
*)dataOrig
;
192 // finally delete the dummy frame and, as wd has been already destroyed and
193 // the other windows reenabled, the activation is going to return to the
194 // window which had had it before
195 data
->winActive
->Destroy();
197 // also delete the temporary data object itself
201 bool wxGUIAppTraits::DoMessageFromThreadWait()
203 // we should return false only if the app should exit, i.e. only if
204 // Dispatch() determines that the main event loop should terminate
205 return !wxTheApp
|| wxTheApp
->Dispatch();
208 wxToolkitInfo
& wxGUIAppTraits::GetToolkitInfo()
210 static wxToolkitInfo info
;
211 wxToolkitInfo
& baseInfo
= wxAppTraits::GetToolkitInfo();
212 info
.versionMajor
= baseInfo
.versionMajor
;
213 info
.versionMinor
= baseInfo
.versionMinor
;
214 info
.os
= baseInfo
.os
;
215 info
.shortName
= _T("msw");
216 info
.name
= _T("wxMSW");
217 #ifdef __WXUNIVERSAL__
218 info
.shortName
<< _T("univ");
219 info
.name
<< _T("/wxUniversal");
224 // ===========================================================================
225 // wxApp implementation
226 // ===========================================================================
228 int wxApp::m_nCmdShow
= SW_SHOWNORMAL
;
230 // ---------------------------------------------------------------------------
232 // ---------------------------------------------------------------------------
234 IMPLEMENT_DYNAMIC_CLASS(wxApp
, wxEvtHandler
)
236 BEGIN_EVENT_TABLE(wxApp
, wxEvtHandler
)
237 EVT_IDLE(wxApp::OnIdle
)
238 EVT_END_SESSION(wxApp::OnEndSession
)
239 EVT_QUERY_END_SESSION(wxApp::OnQueryEndSession
)
242 // class to ensure that wxAppBase::CleanUp() is called if our Initialize()
244 class wxCallBaseCleanup
247 wxCallBaseCleanup(wxApp
*app
) : m_app(app
) { }
248 ~wxCallBaseCleanup() { if ( m_app
) m_app
->wxAppBase::CleanUp(); }
250 void Dismiss() { m_app
= NULL
; }
257 bool wxApp::Initialize(int& argc
, wxChar
**argv
)
259 if ( !wxAppBase::Initialize(argc
, argv
) )
262 // ensure that base cleanup is done if we return too early
263 wxCallBaseCleanup
callBaseCleanup(this);
266 wxString tmp
= GetAppName();
267 tmp
+= wxT("ClassName");
268 wxCanvasClassName
= wxStrdup( tmp
.c_str() );
270 wxCanvasClassNameNR
= wxStrdup( tmp
.c_str() );
271 HWND hWnd
= FindWindow( wxCanvasClassNameNR
, NULL
);
274 SetForegroundWindow( (HWND
)(((DWORD
)hWnd
)|0x01) );
279 // the first thing to do is to check if we're trying to run an Unicode
280 // program under Win9x w/o MSLU emulation layer - if so, abort right now
281 // as it has no chance to work
282 #if wxUSE_UNICODE && !wxUSE_UNICODE_MSLU
283 if ( wxGetOsVersion() != wxWINDOWS_NT
&& wxGetOsVersion() != wxWINDOWS_CE
)
285 // note that we can use MessageBoxW() as it's implemented even under
286 // Win9x - OTOH, we can't use wxGetTranslation() because the file APIs
287 // used by wxLocale are not
291 _T("This program uses Unicode and requires Windows NT/2000/XP/CE.\nProgram aborted."),
292 _T("wxWidgets Fatal Error"),
298 #endif // wxUSE_UNICODE && !wxUSE_UNICODE_MSLU
300 #if defined(__WIN95__) && !defined(__WXMICROWIN__)
301 InitCommonControls();
304 #if wxUSE_OLE || wxUSE_DRAG_AND_DROP
307 // we need to initialize OLE library
309 if ( FAILED(::CoInitializeEx(NULL
, COINIT_MULTITHREADED
)) )
310 wxLogError(_("Cannot initialize OLE"));
312 if ( FAILED(::OleInitialize(NULL
)) )
313 wxLogError(_("Cannot initialize OLE"));
320 if (!Ctl3dRegister(wxhInstance
))
321 wxLogError(wxT("Cannot register CTL3D"));
323 Ctl3dAutoSubclass(wxhInstance
);
324 #endif // wxUSE_CTL3D
326 RegisterWindowClasses();
328 #if !defined(__WXMICROWIN__) && !defined(__WXWINCE__)
329 // Create the brush for disabling bitmap buttons
331 lb
.lbStyle
= BS_PATTERN
;
333 lb
.lbHatch
= (int)LoadBitmap( wxhInstance
, wxT("wxDISABLE_BUTTON_BITMAP") );
336 wxDisableButtonBrush
= ::CreateBrushIndirect( &lb
);
337 ::DeleteObject( (HGDIOBJ
)lb
.lbHatch
);
339 //else: wxWidgets resources are probably not linked in
340 #endif // !__WXMICROWIN__ && !__WXWINCE__
346 wxWinHandleHash
= new wxWinHashTable(wxKEY_INTEGER
, 100);
348 #if !defined(__WXMICROWIN__) && !defined(__WXWINCE__)
349 wxSetKeyboardHook(true);
352 callBaseCleanup
.Dismiss();
357 // ---------------------------------------------------------------------------
358 // RegisterWindowClasses
359 // ---------------------------------------------------------------------------
361 // TODO we should only register classes really used by the app. For this it
362 // would be enough to just delay the class registration until an attempt
363 // to create a window of this class is made.
364 bool wxApp::RegisterWindowClasses()
367 wxZeroMemory(wndclass
);
369 // for each class we register one with CS_(V|H)REDRAW style and one
370 // without for windows created with wxNO_FULL_REDRAW_ON_REPAINT flag
371 static const long styleNormal
= CS_HREDRAW
| CS_VREDRAW
| CS_DBLCLKS
;
372 static const long styleNoRedraw
= CS_DBLCLKS
;
374 // the fields which are common to all classes
375 wndclass
.lpfnWndProc
= (WNDPROC
)wxWndProc
;
376 wndclass
.hInstance
= wxhInstance
;
377 wndclass
.hCursor
= ::LoadCursor((HINSTANCE
)NULL
, IDC_ARROW
);
379 // Register the frame window class.
380 wndclass
.hbrBackground
= (HBRUSH
)(COLOR_APPWORKSPACE
+ 1);
381 wndclass
.lpszClassName
= wxCanvasClassName
;
382 wndclass
.style
= styleNormal
;
384 if ( !RegisterClass(&wndclass
) )
386 wxLogLastError(wxT("RegisterClass(frame)"));
390 wndclass
.lpszClassName
= wxCanvasClassNameNR
;
391 wndclass
.style
= styleNoRedraw
;
393 if ( !RegisterClass(&wndclass
) )
395 wxLogLastError(wxT("RegisterClass(no redraw frame)"));
398 // Register the MDI frame window class.
399 wndclass
.hbrBackground
= (HBRUSH
)NULL
; // paint MDI frame ourselves
400 wndclass
.lpszClassName
= wxMDIFrameClassName
;
401 wndclass
.style
= styleNormal
;
403 if ( !RegisterClass(&wndclass
) )
405 wxLogLastError(wxT("RegisterClass(MDI parent)"));
408 // "no redraw" MDI frame
409 wndclass
.lpszClassName
= wxMDIFrameClassNameNoRedraw
;
410 wndclass
.style
= styleNoRedraw
;
412 if ( !RegisterClass(&wndclass
) )
414 wxLogLastError(wxT("RegisterClass(no redraw MDI parent frame)"));
417 // Register the MDI child frame window class.
418 wndclass
.hbrBackground
= (HBRUSH
)(COLOR_WINDOW
+ 1);
419 wndclass
.lpszClassName
= wxMDIChildFrameClassName
;
420 wndclass
.style
= styleNormal
;
422 if ( !RegisterClass(&wndclass
) )
424 wxLogLastError(wxT("RegisterClass(MDI child)"));
427 // "no redraw" MDI child frame
428 wndclass
.lpszClassName
= wxMDIChildFrameClassNameNoRedraw
;
429 wndclass
.style
= styleNoRedraw
;
431 if ( !RegisterClass(&wndclass
) )
433 wxLogLastError(wxT("RegisterClass(no redraw MDI child)"));
439 // ---------------------------------------------------------------------------
440 // UnregisterWindowClasses
441 // ---------------------------------------------------------------------------
443 bool wxApp::UnregisterWindowClasses()
447 #ifndef __WXMICROWIN__
448 // MDI frame window class.
449 if ( !::UnregisterClass(wxMDIFrameClassName
, wxhInstance
) )
451 wxLogLastError(wxT("UnregisterClass(MDI parent)"));
456 // "no redraw" MDI frame
457 if ( !::UnregisterClass(wxMDIFrameClassNameNoRedraw
, wxhInstance
) )
459 wxLogLastError(wxT("UnregisterClass(no redraw MDI parent frame)"));
464 // MDI child frame window class.
465 if ( !::UnregisterClass(wxMDIChildFrameClassName
, wxhInstance
) )
467 wxLogLastError(wxT("UnregisterClass(MDI child)"));
472 // "no redraw" MDI child frame
473 if ( !::UnregisterClass(wxMDIChildFrameClassNameNoRedraw
, wxhInstance
) )
475 wxLogLastError(wxT("UnregisterClass(no redraw MDI child)"));
481 if ( !::UnregisterClass(wxCanvasClassName
, wxhInstance
) )
483 wxLogLastError(wxT("UnregisterClass(canvas)"));
488 if ( !::UnregisterClass(wxCanvasClassNameNR
, wxhInstance
) )
490 wxLogLastError(wxT("UnregisterClass(no redraw canvas)"));
494 #endif // __WXMICROWIN__
499 void wxApp::CleanUp()
501 // all objects pending for deletion must be deleted first, otherwise we
502 // would crash when they use wxWinHandleHash (and UnregisterWindowClasses()
503 // call wouldn't succeed as long as any windows still exist), so call the
504 // base class method first and only then do our clean up
505 wxAppBase::CleanUp();
507 #if !defined(__WXMICROWIN__) && !defined(__WXWINCE__)
508 wxSetKeyboardHook(false);
515 if ( wxDisableButtonBrush
)
516 ::DeleteObject( wxDisableButtonBrush
);
526 // for an EXE the classes are unregistered when it terminates but DLL may
527 // be loaded several times (load/unload/load) into the same process in
528 // which case the registration will fail after the first time if we don't
529 // unregister the classes now
530 UnregisterWindowClasses();
533 Ctl3dUnregister(wxhInstance
);
536 delete wxWinHandleHash
;
537 wxWinHandleHash
= NULL
;
540 free( wxCanvasClassName
);
541 free( wxCanvasClassNameNR
);
545 // ----------------------------------------------------------------------------
547 // ----------------------------------------------------------------------------
551 m_printMode
= wxPRINT_WINDOWS
;
556 // our cmd line arguments are allocated inside wxEntry(HINSTANCE), they
557 // don't come from main(), so we have to free them
561 // m_argv elements were allocated by wxStrdup()
565 // but m_argv itself -- using new[]
569 // ----------------------------------------------------------------------------
570 // wxApp idle handling
571 // ----------------------------------------------------------------------------
573 void wxApp::OnIdle(wxIdleEvent
& event
)
575 wxAppBase::OnIdle(event
);
577 #if wxUSE_DC_CACHEING
578 // automated DC cache management: clear the cached DCs and bitmap
579 // if it's likely that the app has finished with them, that is, we
580 // get an idle event and we're not dragging anything.
581 if (!::GetKeyState(MK_LBUTTON
) && !::GetKeyState(MK_MBUTTON
) && !::GetKeyState(MK_RBUTTON
))
583 #endif // wxUSE_DC_CACHEING
586 void wxApp::WakeUpIdle()
588 // Send the top window a dummy message so idle handler processing will
589 // start up again. Doing it this way ensures that the idle handler
590 // wakes up in the right thread (see also wxWakeUpMainThread() which does
591 // the same for the main app thread only)
592 wxWindow
*topWindow
= wxTheApp
->GetTopWindow();
595 if ( !::PostMessage(GetHwndOf(topWindow
), WM_NULL
, 0, 0) )
597 // should never happen
598 wxLogLastError(wxT("PostMessage(WM_NULL)"));
603 // ----------------------------------------------------------------------------
604 // other wxApp event hanlders
605 // ----------------------------------------------------------------------------
607 void wxApp::OnEndSession(wxCloseEvent
& WXUNUSED(event
))
610 GetTopWindow()->Close(true);
613 // Default behaviour: close the application with prompts. The
614 // user can veto the close, and therefore the end session.
615 void wxApp::OnQueryEndSession(wxCloseEvent
& event
)
619 if (!GetTopWindow()->Close(!event
.CanVeto()))
624 // ----------------------------------------------------------------------------
626 // ----------------------------------------------------------------------------
629 int wxApp::GetComCtl32Version()
631 #if defined(__WXMICROWIN__) || defined(__WXWINCE__)
636 // NB: this is MT-ok as in the worst case we'd compute s_verComCtl32 twice,
637 // but as its value should be the same both times it doesn't matter
638 static int s_verComCtl32
= -1;
640 if ( s_verComCtl32
== -1 )
642 // initally assume no comctl32.dll at all
645 // we're prepared to handle the errors
649 wxDynamicLibrary
dllComCtl32(_T("comctl32.dll"), wxDL_VERBATIM
);
651 // if so, then we can check for the version
652 if ( dllComCtl32
.IsLoaded() )
654 #ifdef DLLVER_PLATFORM_WINDOWS
655 // try to use DllGetVersion() if available in _headers_
656 wxDYNLIB_FUNCTION( DLLGETVERSIONPROC
, DllGetVersion
, dllComCtl32
);
657 if ( pfnDllGetVersion
)
660 dvi
.cbSize
= sizeof(dvi
);
662 HRESULT hr
= (*pfnDllGetVersion
)(&dvi
);
665 wxLogApiError(_T("DllGetVersion"), hr
);
669 // this is incompatible with _WIN32_IE values, but
670 // compatible with the other values returned by
671 // GetComCtl32Version()
672 s_verComCtl32
= 100*dvi
.dwMajorVersion
+
678 // if DllGetVersion() is unavailable either during compile or
679 // run-time, try to guess the version otherwise
680 if ( !s_verComCtl32
)
682 // InitCommonControlsEx is unique to 4.70 and later
683 void *pfn
= dllComCtl32
.GetSymbol(_T("InitCommonControlsEx"));
686 // not found, must be 4.00
691 // many symbols appeared in comctl32 4.71, could use any of
692 // them except may be DllInstall()
693 pfn
= dllComCtl32
.GetSymbol(_T("InitializeFlatSB"));
696 // not found, must be 4.70
701 // found, must be 4.71 or later
709 return s_verComCtl32
;
710 #endif // Microwin/!Microwin
713 // Yield to incoming messages
715 bool wxApp::Yield(bool onlyIfNeeded
)
718 static bool s_inYield
= false;
721 // disable log flushing from here because a call to wxYield() shouldn't
722 // normally result in message boxes popping up &c
730 wxFAIL_MSG( wxT("wxYield called recursively" ) );
738 // we don't want to process WM_QUIT from here - it should be processed in
739 // the main event loop in order to stop it
741 while ( PeekMessage(&msg
, (HWND
)0, 0, 0, PM_NOREMOVE
) &&
742 msg
.message
!= WM_QUIT
)
745 wxMutexGuiLeaveOrEnter();
746 #endif // wxUSE_THREADS
748 if ( !wxTheApp
->Dispatch() )
752 // if there are pending events, we must process them.
753 ProcessPendingEvents();
756 // let the logs be flashed again
767 // ----------------------------------------------------------------------------
768 // exception handling
769 // ----------------------------------------------------------------------------
771 bool wxApp::OnExceptionInMainLoop()
773 // ask the user about what to do: use the Win32 API function here as it
774 // could be dangerous to use any wxWidgets code in this state
779 _T("An unhandled exception occurred. Press \"Abort\" to \
780 terminate the program,\r\n\
781 \"Retry\" to exit the program normally and \"Ignore\" to try to continue."),
782 _T("Unhandled exception"),
783 MB_ABORTRETRYIGNORE
|
793 wxFAIL_MSG( _T("unexpected MessageBox() return code") );
804 #endif // wxUSE_EXCEPTIONS
806 // ----------------------------------------------------------------------------
807 // deprecated event loop functions
808 // ----------------------------------------------------------------------------
810 #if WXWIN_COMPATIBILITY_2_4
812 #include "wx/evtloop.h"
814 void wxApp::DoMessage(WXMSG
*pMsg
)
816 wxEventLoop
*evtLoop
= wxEventLoop::GetActive();
818 evtLoop
->ProcessMessage(pMsg
);
821 bool wxApp::DoMessage()
823 wxEventLoop
*evtLoop
= wxEventLoop::GetActive();
824 return evtLoop
? evtLoop
->Dispatch() : false;
827 bool wxApp::ProcessMessage(WXMSG
* pMsg
)
829 wxEventLoop
*evtLoop
= wxEventLoop::GetActive();
830 return evtLoop
&& evtLoop
->PreProcessMessage(pMsg
);
833 #endif // WXWIN_COMPATIBILITY_2_4