1
/////////////////////////////////////////////////////////////////////////////
4
// Author: Julian Smart
7
// RCS-ID: $Id: app.cpp,v 1.238.2.2 2006/02/11 14:57:10 JS Exp $
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();
308
// Don't show a message box if a function such as SHGetFileInfo
309
// fails to find a device.
310
SetErrorMode(SEM_FAILCRITICALERRORS|SEM_NOOPENFILEERRORBOX);
315
RegisterWindowClasses();
317
wxWinHandleHash = new wxWinHashTable(wxKEY_INTEGER, 100);
319
#if !defined(__WXMICROWIN__) && !defined(__WXWINCE__)
320
wxSetKeyboardHook(true);
323
callBaseCleanup.Dismiss();
328
// ---------------------------------------------------------------------------
329
// RegisterWindowClasses
330
// ---------------------------------------------------------------------------
332
// TODO we should only register classes really used by the app. For this it
333
// would be enough to just delay the class registration until an attempt
334
// to create a window of this class is made.
335
bool wxApp::RegisterWindowClasses()
338
wxZeroMemory(wndclass);
340
// for each class we register one with CS_(V|H)REDRAW style and one
341
// without for windows created with wxNO_FULL_REDRAW_ON_REPAINT flag
342
static const long styleNormal = CS_HREDRAW | CS_VREDRAW | CS_DBLCLKS;
343
static const long styleNoRedraw = CS_DBLCLKS;
345
// the fields which are common to all classes
346
wndclass.lpfnWndProc = (WNDPROC)wxWndProc;
347
wndclass.hInstance = wxhInstance;
348
wndclass.hCursor = ::LoadCursor((HINSTANCE)NULL, IDC_ARROW);
350
// register the class for all normal windows
351
wndclass.hbrBackground = (HBRUSH)(COLOR_BTNFACE + 1);
352
wndclass.lpszClassName = wxCanvasClassName;
353
wndclass.style = styleNormal;
355
if ( !RegisterClass(&wndclass) )
357
wxLogLastError(wxT("RegisterClass(frame)"));
361
wndclass.lpszClassName = wxCanvasClassNameNR;
362
wndclass.style = styleNoRedraw;
364
if ( !RegisterClass(&wndclass) )
366
wxLogLastError(wxT("RegisterClass(no redraw frame)"));
369
// Register the MDI frame window class.
370
wndclass.hbrBackground = (HBRUSH)NULL; // paint MDI frame ourselves
371
wndclass.lpszClassName = wxMDIFrameClassName;
372
wndclass.style = styleNormal;
374
if ( !RegisterClass(&wndclass) )
376
wxLogLastError(wxT("RegisterClass(MDI parent)"));
379
// "no redraw" MDI frame
380
wndclass.lpszClassName = wxMDIFrameClassNameNoRedraw;
381
wndclass.style = styleNoRedraw;
383
if ( !RegisterClass(&wndclass) )
385
wxLogLastError(wxT("RegisterClass(no redraw MDI parent frame)"));
388
// Register the MDI child frame window class.
389
wndclass.hbrBackground = (HBRUSH)(COLOR_WINDOW + 1);
390
wndclass.lpszClassName = wxMDIChildFrameClassName;
391
wndclass.style = styleNormal;
393
if ( !RegisterClass(&wndclass) )
395
wxLogLastError(wxT("RegisterClass(MDI child)"));
398
// "no redraw" MDI child frame
399
wndclass.lpszClassName = wxMDIChildFrameClassNameNoRedraw;
400
wndclass.style = styleNoRedraw;
402
if ( !RegisterClass(&wndclass) )
404
wxLogLastError(wxT("RegisterClass(no redraw MDI child)"));
410
// ---------------------------------------------------------------------------
411
// UnregisterWindowClasses
412
// ---------------------------------------------------------------------------
414
bool wxApp::UnregisterWindowClasses()
418
#ifndef __WXMICROWIN__
419
// MDI frame window class.
420
if ( !::UnregisterClass(wxMDIFrameClassName, wxhInstance) )
422
wxLogLastError(wxT("UnregisterClass(MDI parent)"));
427
// "no redraw" MDI frame
428
if ( !::UnregisterClass(wxMDIFrameClassNameNoRedraw, wxhInstance) )
430
wxLogLastError(wxT("UnregisterClass(no redraw MDI parent frame)"));
435
// MDI child frame window class.
436
if ( !::UnregisterClass(wxMDIChildFrameClassName, wxhInstance) )
438
wxLogLastError(wxT("UnregisterClass(MDI child)"));
443
// "no redraw" MDI child frame
444
if ( !::UnregisterClass(wxMDIChildFrameClassNameNoRedraw, wxhInstance) )
446
wxLogLastError(wxT("UnregisterClass(no redraw MDI child)"));
452
if ( !::UnregisterClass(wxCanvasClassName, wxhInstance) )
454
wxLogLastError(wxT("UnregisterClass(canvas)"));
459
if ( !::UnregisterClass(wxCanvasClassNameNR, wxhInstance) )
461
wxLogLastError(wxT("UnregisterClass(no redraw canvas)"));
465
#endif // __WXMICROWIN__
470
void wxApp::CleanUp()
472
// all objects pending for deletion must be deleted first, otherwise we
473
// would crash when they use wxWinHandleHash (and UnregisterWindowClasses()
474
// call wouldn't succeed as long as any windows still exist), so call the
475
// base class method first and only then do our clean up
476
wxAppBase::CleanUp();
478
#if !defined(__WXMICROWIN__) && !defined(__WXWINCE__)
479
wxSetKeyboardHook(false);
484
// for an EXE the classes are unregistered when it terminates but DLL may
485
// be loaded several times (load/unload/load) into the same process in
486
// which case the registration will fail after the first time if we don't
487
// unregister the classes now
488
UnregisterWindowClasses();
490
delete wxWinHandleHash;
491
wxWinHandleHash = NULL;
494
free( wxCanvasClassName );
495
free( wxCanvasClassNameNR );
499
// ----------------------------------------------------------------------------
501
// ----------------------------------------------------------------------------
505
m_printMode = wxPRINT_WINDOWS;
510
// our cmd line arguments are allocated inside wxEntry(HINSTANCE), they
511
// don't come from main(), so we have to free them
515
// m_argv elements were allocated by wxStrdup()
519
// but m_argv itself -- using new[]
523
// ----------------------------------------------------------------------------
524
// wxApp idle handling
525
// ----------------------------------------------------------------------------
527
void wxApp::OnIdle(wxIdleEvent& event)
529
wxAppBase::OnIdle(event);
531
#if wxUSE_DC_CACHEING
532
// automated DC cache management: clear the cached DCs and bitmap
533
// if it's likely that the app has finished with them, that is, we
534
// get an idle event and we're not dragging anything.
535
if (!::GetKeyState(MK_LBUTTON) && !::GetKeyState(MK_MBUTTON) && !::GetKeyState(MK_RBUTTON))
537
#endif // wxUSE_DC_CACHEING
540
void wxApp::WakeUpIdle()
542
// Send the top window a dummy message so idle handler processing will
543
// start up again. Doing it this way ensures that the idle handler
544
// wakes up in the right thread (see also wxWakeUpMainThread() which does
545
// the same for the main app thread only)
546
wxWindow *topWindow = wxTheApp->GetTopWindow();
549
if ( !::PostMessage(GetHwndOf(topWindow), WM_NULL, 0, 0) )
551
// should never happen
552
wxLogLastError(wxT("PostMessage(WM_NULL)"));
557
// ----------------------------------------------------------------------------
558
// other wxApp event hanlders
559
// ----------------------------------------------------------------------------
561
void wxApp::OnEndSession(wxCloseEvent& WXUNUSED(event))
564
GetTopWindow()->Close(true);
567
// Default behaviour: close the application with prompts. The
568
// user can veto the close, and therefore the end session.
569
void wxApp::OnQueryEndSession(wxCloseEvent& event)
573
if (!GetTopWindow()->Close(!event.CanVeto()))
578
// ----------------------------------------------------------------------------
580
// ----------------------------------------------------------------------------
583
int wxApp::GetComCtl32Version()
585
#if defined(__WXMICROWIN__) || defined(__WXWINCE__)
590
// NB: this is MT-ok as in the worst case we'd compute s_verComCtl32 twice,
591
// but as its value should be the same both times it doesn't matter
592
static int s_verComCtl32 = -1;
594
if ( s_verComCtl32 == -1 )
596
// initally assume no comctl32.dll at all
599
// we're prepared to handle the errors
602
#if wxUSE_DYNLIB_CLASS
604
wxDynamicLibrary dllComCtl32(_T("comctl32.dll"), wxDL_VERBATIM);
606
// if so, then we can check for the version
607
if ( dllComCtl32.IsLoaded() )
609
// now check if the function is available during run-time
610
wxDYNLIB_FUNCTION( DLLGETVERSIONPROC, DllGetVersion, dllComCtl32 );
611
if ( pfnDllGetVersion )
614
dvi.cbSize = sizeof(dvi);
616
HRESULT hr = (*pfnDllGetVersion)(&dvi);
619
wxLogApiError(_T("DllGetVersion"), hr);
623
// this is incompatible with _WIN32_IE values, but
624
// compatible with the other values returned by
625
// GetComCtl32Version()
626
s_verComCtl32 = 100*dvi.dwMajorVersion +
631
// if DllGetVersion() is unavailable either during compile or
632
// run-time, try to guess the version otherwise
633
if ( !s_verComCtl32 )
635
// InitCommonControlsEx is unique to 4.70 and later
636
void *pfn = dllComCtl32.GetSymbol(_T("InitCommonControlsEx"));
639
// not found, must be 4.00
644
// many symbols appeared in comctl32 4.71, could use any of
645
// them except may be DllInstall()
646
pfn = dllComCtl32.GetSymbol(_T("InitializeFlatSB"));
649
// not found, must be 4.70
654
// found, must be 4.71 or later
663
return s_verComCtl32;
664
#endif // Microwin/!Microwin
667
// Yield to incoming messages
669
bool wxApp::Yield(bool onlyIfNeeded)
672
static bool s_inYield = false;
675
// disable log flushing from here because a call to wxYield() shouldn't
676
// normally result in message boxes popping up &c
684
wxFAIL_MSG( wxT("wxYield called recursively" ) );
692
// we don't want to process WM_QUIT from here - it should be processed in
693
// the main event loop in order to stop it
695
while ( PeekMessage(&msg, (HWND)0, 0, 0, PM_NOREMOVE) &&
696
msg.message != WM_QUIT )
699
wxMutexGuiLeaveOrEnter();
700
#endif // wxUSE_THREADS
702
if ( !wxTheApp->Dispatch() )
706
// if there are pending events, we must process them.
707
ProcessPendingEvents();
710
// let the logs be flashed again
721
// ----------------------------------------------------------------------------
722
// exception handling
723
// ----------------------------------------------------------------------------
725
bool wxApp::OnExceptionInMainLoop()
727
// ask the user about what to do: use the Win32 API function here as it
728
// could be dangerous to use any wxWidgets code in this state
733
_T("An unhandled exception occurred. Press \"Abort\" to \
734
terminate the program,\r\n\
735
\"Retry\" to exit the program normally and \"Ignore\" to try to continue."),
736
_T("Unhandled exception"),
737
MB_ABORTRETRYIGNORE |
747
wxFAIL_MSG( _T("unexpected MessageBox() return code") );
758
#endif // wxUSE_EXCEPTIONS
760
// ----------------------------------------------------------------------------
761
// deprecated event loop functions
762
// ----------------------------------------------------------------------------
764
#if WXWIN_COMPATIBILITY_2_4
766
#include "wx/evtloop.h"
768
void wxApp::DoMessage(WXMSG *pMsg)
770
wxEventLoop *evtLoop = wxEventLoop::GetActive();
772
evtLoop->ProcessMessage(pMsg);
775
bool wxApp::DoMessage()
777
wxEventLoop *evtLoop = wxEventLoop::GetActive();
778
return evtLoop ? evtLoop->Dispatch() : false;
781
bool wxApp::ProcessMessage(WXMSG* pMsg)
783
wxEventLoop *evtLoop = wxEventLoop::GetActive();
784
return evtLoop && evtLoop->PreProcessMessage(pMsg);
787
#endif // WXWIN_COMPATIBILITY_2_4