]> git.saurik.com Git - wxWidgets.git/blame - src/common/init.cpp
bitmap button size was too small when uxtheme functions were used to get the margins
[wxWidgets.git] / src / common / init.cpp
CommitLineData
e90c1d2a 1/////////////////////////////////////////////////////////////////////////////
9a6384ca 2// Name: src/common/init.cpp
e90c1d2a
VZ
3// Purpose: initialisation for the library
4// Author: Vadim Zeitlin
5// Modified by:
6// Created: 04.10.99
7// RCS-ID: $Id$
8// Copyright: (c) Vadim Zeitlin
65571936 9// Licence: wxWindows licence
e90c1d2a
VZ
10/////////////////////////////////////////////////////////////////////////////
11
12// ============================================================================
13// declarations
14// ============================================================================
15
16// ----------------------------------------------------------------------------
17// headers
18// ----------------------------------------------------------------------------
19
f4c890fd
JS
20#include "wx/wxprec.h"
21
22#ifdef __BORLANDC__
9a6384ca 23 #pragma hdrstop
f4c890fd
JS
24#endif //__BORLANDC__
25
e87271f3
VZ
26#ifndef WX_PRECOMP
27 #include "wx/app.h"
bc385ba9 28 #include "wx/filefn.h"
e2450fa9 29 #include "wx/log.h"
94826170 30 #include "wx/thread.h"
a20599da 31 #include "wx/intl.h"
e87271f3 32#endif
e90c1d2a 33
abca8ebf
VZ
34#include "wx/init.h"
35
94826170 36#include "wx/ptr_scpd.h"
51abe921 37#include "wx/module.h"
fb3e83b6 38#include "wx/except.h"
51abe921 39
94826170
VZ
40#if defined(__WXMSW__) && defined(__WXDEBUG__)
41 #include "wx/msw/msvcrt.h"
42
43 static struct EnableMemLeakChecking
44 {
45 EnableMemLeakChecking()
46 {
47 // do check for memory leaks on program exit (another useful flag
48 // is _CRTDBG_DELAY_FREE_MEM_DF which doesn't free deallocated
49 // memory which may be used to simulate low-memory condition)
50 wxCrtSetDbgFlag(_CRTDBG_LEAK_CHECK_DF);
51 }
52 } gs_enableLeakChecks;
53#endif // __WXMSW__ && __WXDEBUG__
54
e90c1d2a
VZ
55// ----------------------------------------------------------------------------
56// private classes
57// ----------------------------------------------------------------------------
58
e2478fde 59// we need a dummy app object if the user doesn't want to create a real one
94826170 60class wxDummyConsoleApp : public wxAppConsole
e90c1d2a
VZ
61{
62public:
fc7a2a60
VZ
63 wxDummyConsoleApp() { }
64
e2478fde 65 virtual int OnRun() { wxFAIL_MSG( _T("unreachable code") ); return 0; }
fc7a2a60
VZ
66
67 DECLARE_NO_COPY_CLASS(wxDummyConsoleApp)
e90c1d2a
VZ
68};
69
94826170 70// we need a special kind of auto pointer to wxApp which not only deletes the
7cafd224 71// pointer it holds in its dtor but also resets the global application pointer
d0ee33f5
WS
72wxDECLARE_SCOPED_PTR(wxAppConsole, wxAppPtrBase)
73wxDEFINE_SCOPED_PTR(wxAppConsole, wxAppPtrBase)
bc385ba9 74
94826170
VZ
75class wxAppPtr : public wxAppPtrBase
76{
77public:
77c6966e 78 wxEXPLICIT wxAppPtr(wxAppConsole *ptr = NULL) : wxAppPtrBase(ptr) { }
94826170
VZ
79 ~wxAppPtr()
80 {
81 if ( get() )
82 {
83 // the pointer is going to be deleted in the base class dtor, don't
84 // leave the dangling pointer!
a80e5f9e 85 wxApp::SetInstance(NULL);
94826170
VZ
86 }
87 }
88
77c6966e 89 void Set(wxAppConsole *ptr)
94826170
VZ
90 {
91 reset(ptr);
92
a80e5f9e 93 wxApp::SetInstance(ptr);
94826170 94 }
fc7a2a60
VZ
95
96 DECLARE_NO_COPY_CLASS(wxAppPtr)
94826170
VZ
97};
98
05e2b077
VZ
99// class to ensure that wxAppBase::CleanUp() is called if our Initialize()
100// fails
101class wxCallAppCleanup
102{
103public:
77c6966e 104 wxCallAppCleanup(wxAppConsole *app) : m_app(app) { }
05e2b077
VZ
105 ~wxCallAppCleanup() { if ( m_app ) m_app->CleanUp(); }
106
107 void Dismiss() { m_app = NULL; }
108
109private:
77c6966e 110 wxAppConsole *m_app;
05e2b077
VZ
111};
112
94826170
VZ
113// another tiny class which simply exists to ensure that wxEntryCleanup is
114// always called
115class wxCleanupOnExit
116{
117public:
118 ~wxCleanupOnExit() { wxEntryCleanup(); }
119};
bc385ba9 120
005b5298
VZ
121// ----------------------------------------------------------------------------
122// private functions
123// ----------------------------------------------------------------------------
124
125// suppress warnings about unused variables
126static inline void Use(void *) { }
127
128#define WX_SUPPRESS_UNUSED_WARN(x) Use(&x)
129
e90c1d2a 130// ----------------------------------------------------------------------------
94826170 131// initialization data
e90c1d2a
VZ
132// ----------------------------------------------------------------------------
133
94826170
VZ
134static struct InitData
135{
136 InitData()
137 {
138 nInitCount = 0;
139
140#if wxUSE_UNICODE
141 argc = 0;
142 // argv = NULL; -- not even really needed
143#endif // wxUSE_UNICODE
144 }
145
146 // critical section protecting this struct
147 wxCRIT_SECT_DECLARE_MEMBER(csInit);
148
149 // number of times wxInitialize() was called minus the number of times
150 // wxUninitialize() was
151 size_t nInitCount;
152
153#if wxUSE_UNICODE
154 int argc;
155
156 // if we receive the command line arguments as ASCII and have to convert
157 // them to Unicode ourselves (this is the case under Unix but not Windows,
158 // for example), we remember the converted argv here because we'll have to
159 // free it when doing cleanup to avoid memory leaks
150cb195 160 wchar_t **argv;
94826170 161#endif // wxUSE_UNICODE
fc7a2a60
VZ
162
163 DECLARE_NO_COPY_CLASS(InitData)
94826170 164} gs_initData;
e90c1d2a
VZ
165
166// ============================================================================
167// implementation
168// ============================================================================
169
252a752e 170// ----------------------------------------------------------------------------
94826170 171// command line arguments ANSI -> Unicode conversion
252a752e
VZ
172// ----------------------------------------------------------------------------
173
94826170
VZ
174#if wxUSE_UNICODE
175
176static void ConvertArgsToUnicode(int argc, char **argv)
e90c1d2a 177{
94826170
VZ
178 gs_initData.argv = new wchar_t *[argc + 1];
179 for ( int i = 0; i < argc; i++ )
e90c1d2a 180 {
faa112c4
VZ
181 wxWCharBuffer buf(wxConvLocal.cMB2WX(argv[i]));
182 gs_initData.argv[i] = buf ? wxStrdup(buf) : NULL;
e90c1d2a
VZ
183 }
184
08989e30 185 gs_initData.argc = argc;
94826170
VZ
186 gs_initData.argv[argc] = NULL;
187}
e90c1d2a 188
94826170
VZ
189static void FreeConvertedArgs()
190{
150cb195 191 if ( gs_initData.argv )
bbfa0322 192 {
150cb195
VZ
193 for ( int i = 0; i < gs_initData.argc; i++ )
194 {
195 free(gs_initData.argv[i]);
196 }
197
198 delete [] gs_initData.argv;
199 gs_initData.argv = NULL;
08989e30 200 gs_initData.argc = 0;
bbfa0322 201 }
94826170 202}
bbfa0322 203
94826170 204#endif // wxUSE_UNICODE
e90c1d2a 205
94826170
VZ
206// ----------------------------------------------------------------------------
207// start up
208// ----------------------------------------------------------------------------
bbfa0322 209
94826170
VZ
210// initialization which is always done (not customizable) before wxApp creation
211static bool DoCommonPreInit()
212{
1c7b2f01
VZ
213#if wxUSE_LOG
214 // install temporary log sink: we can't use wxLogGui before wxApp is
215 // constructed and if we use wxLogStderr, all messages during
216 // initialization simply disappear under Windows
217 //
218 // note that we will delete this log target below
5db920c9 219 delete wxLog::SetActiveTarget(new wxLogBuffer);
1c7b2f01
VZ
220#endif // wxUSE_LOG
221
94826170 222 return true;
e90c1d2a
VZ
223}
224
94826170
VZ
225// non customizable initialization done after wxApp creation and initialization
226static bool DoCommonPostInit()
e90c1d2a 227{
94826170
VZ
228 wxModule::RegisterModules();
229
1c7b2f01
VZ
230 if ( !wxModule::InitializeModules() )
231 {
232 wxLogError(_("Initialization failed in post init, aborting."));
233 return false;
234 }
235
236 return true;
bc385ba9
VZ
237}
238
05e2b077 239bool wxEntryStart(int& argc, wxChar **argv)
bc385ba9 240{
94826170
VZ
241 // do minimal, always necessary, initialization
242 // --------------------------------------------
243
244 // initialize wxRTTI
245 if ( !DoCommonPreInit() )
bc385ba9 246 {
94826170 247 return false;
bc385ba9
VZ
248 }
249
bc385ba9 250
94826170
VZ
251 // first of all, we need an application object
252 // -------------------------------------------
253
254 // the user might have already created it himself somehow
255 wxAppPtr app(wxTheApp);
256 if ( !app.get() )
257 {
258 // if not, he might have used IMPLEMENT_APP() to give us a function to
259 // create it
bc385ba9
VZ
260 wxAppInitializerFunction fnCreate = wxApp::GetInitializerFunction();
261
94826170
VZ
262 if ( fnCreate )
263 {
264 // he did, try to create the custom wxApp object
7cafd224 265 app.Set((*fnCreate)());
94826170
VZ
266 }
267 }
268
269 if ( !app.get() )
270 {
271 // either IMPLEMENT_APP() was not used at all or it failed -- in any
272 // case we still need something
7cafd224 273 app.Set(new wxDummyConsoleApp);
bc385ba9
VZ
274 }
275
bc385ba9 276
94826170
VZ
277 // wxApp initialization: this can be customized
278 // --------------------------------------------
bc385ba9 279
7cafd224 280 if ( !app->Initialize(argc, argv) )
bc385ba9 281 {
94826170 282 return false;
bc385ba9 283 }
bc385ba9 284
7cafd224 285 wxCallAppCleanup callAppCleanup(app.get());
05e2b077
VZ
286
287 // for compatibility call the old initialization function too
7cafd224 288 if ( !app->OnInitGui() )
05e2b077
VZ
289 return false;
290
bc385ba9 291
94826170
VZ
292 // common initialization after wxTheApp creation
293 // ---------------------------------------------
bc385ba9 294
94826170 295 if ( !DoCommonPostInit() )
94826170 296 return false;
bc385ba9 297
bc385ba9 298
94826170
VZ
299 // prevent the smart pointer from destroying its contents
300 app.release();
301
05e2b077
VZ
302 // and the cleanup object from doing cleanup
303 callAppCleanup.Dismiss();
304
1c7b2f01
VZ
305#if wxUSE_LOG
306 // now that we have a valid wxApp (wxLogGui would have crashed if we used
307 // it before now), we can delete the temporary sink we had created for the
308 // initialization messages -- the next time logging function is called, the
309 // sink will be recreated but this time wxAppTraits will be used
310 delete wxLog::SetActiveTarget(NULL);
311#endif // wxUSE_LOG
312
94826170 313 return true;
bc385ba9
VZ
314}
315
94826170 316#if wxUSE_UNICODE
bbfa0322 317
94826170 318// we provide a wxEntryStart() wrapper taking "char *" pointer too
05e2b077 319bool wxEntryStart(int& argc, char **argv)
bc385ba9 320{
94826170 321 ConvertArgsToUnicode(argc, argv);
bc385ba9 322
94826170 323 if ( !wxEntryStart(argc, gs_initData.argv) )
bc385ba9 324 {
94826170
VZ
325 FreeConvertedArgs();
326
327 return false;
e90c1d2a 328 }
bc385ba9 329
94826170 330 return true;
bc385ba9
VZ
331}
332
94826170
VZ
333#endif // wxUSE_UNICODE
334
335// ----------------------------------------------------------------------------
336// clean up
337// ----------------------------------------------------------------------------
338
7beb59f3 339// cleanup done before destroying wxTheApp
94826170 340static void DoCommonPreCleanup()
bc385ba9
VZ
341{
342#if wxUSE_LOG
94826170
VZ
343 // flush the logged messages if any and install a 'safer' log target: the
344 // default one (wxLogGui) can't be used after the resources are freed just
345 // below and the user supplied one might be even more unsafe (using any
77ffb593 346 // wxWidgets GUI function is unsafe starting from now)
8a9c2246 347 wxLog::DontCreateOnDemand();
94826170
VZ
348
349 // this will flush the old messages if any
8a9c2246 350 delete wxLog::SetActiveTarget(new wxLogStderr);
bc385ba9 351#endif // wxUSE_LOG
94826170 352}
bc385ba9 353
94826170
VZ
354// cleanup done after destroying wxTheApp
355static void DoCommonPostCleanup()
356{
a4de7e8c
VZ
357 wxModule::CleanUpModules();
358
94826170
VZ
359 // we can't do this in wxApp itself because it doesn't know if argv had
360 // been allocated
90aaa865 361#if wxUSE_UNICODE
94826170 362 FreeConvertedArgs();
90aaa865
VZ
363#endif // wxUSE_UNICODE
364
2ee96a25
VZ
365 // use Set(NULL) and not Get() to avoid creating a message output object on
366 // demand when we just want to delete it
367 delete wxMessageOutput::Set(NULL);
368
8a9c2246
VZ
369#if wxUSE_LOG
370 // and now delete the last logger as well
371 delete wxLog::SetActiveTarget(NULL);
372#endif // wxUSE_LOG
e90c1d2a 373}
e2450fa9 374
94826170
VZ
375void wxEntryCleanup()
376{
377 DoCommonPreCleanup();
378
379
380 // delete the application object
381 if ( wxTheApp )
382 {
383 wxTheApp->CleanUp();
384
385 delete wxTheApp;
a80e5f9e 386 wxApp::SetInstance(NULL);
94826170
VZ
387 }
388
389
390 DoCommonPostCleanup();
94826170
VZ
391}
392
393// ----------------------------------------------------------------------------
394// wxEntry
395// ----------------------------------------------------------------------------
396
226c11c0
VZ
397// for MSW the real wxEntry is defined in msw/main.cpp
398#ifndef __WXMSW__
94826170 399 #define wxEntryReal wxEntry
226c11c0 400#endif // !__WXMSW__
94826170 401
05e2b077 402int wxEntryReal(int& argc, wxChar **argv)
94826170
VZ
403{
404 // library initialization
405 if ( !wxEntryStart(argc, argv) )
406 {
688e04b1 407#if wxUSE_LOG
1c7b2f01
VZ
408 // flush any log messages explaining why we failed
409 delete wxLog::SetActiveTarget(NULL);
688e04b1 410#endif
94826170
VZ
411 return -1;
412 }
413
414 // if wxEntryStart succeeded, we must call wxEntryCleanup even if the code
415 // below returns or throws
416 wxCleanupOnExit cleanupOnExit;
417
005b5298
VZ
418 WX_SUPPRESS_UNUSED_WARN(cleanupOnExit);
419
fb3e83b6 420 wxTRY
94826170 421 {
e83f2301 422
fb3e83b6
VZ
423 // app initialization
424 if ( !wxTheApp->CallOnInit() )
425 {
426 // don't call OnExit() if OnInit() failed
427 return -1;
428 }
94826170 429
fe277be0
VZ
430 // ensure that OnExit() is called if OnInit() had succeeded
431 class CallOnExit
432 {
433 public:
434 ~CallOnExit() { wxTheApp->OnExit(); }
435 } callOnExit;
94826170 436
9e9eea73
VZ
437 WX_SUPPRESS_UNUSED_WARN(callOnExit);
438
fe277be0
VZ
439 // app execution
440 return wxTheApp->OnRun();
fb3e83b6
VZ
441 }
442 wxCATCH_ALL( wxTheApp->OnUnhandledException(); return -1; )
94826170
VZ
443}
444
94826170
VZ
445#if wxUSE_UNICODE
446
447// as with wxEntryStart, we provide an ANSI wrapper
abca8ebf 448int wxEntry(int& argc, char **argv)
94826170
VZ
449{
450 ConvertArgsToUnicode(argc, argv);
451
452 return wxEntry(argc, gs_initData.argv);
453}
454
455#endif // wxUSE_UNICODE
456
457// ----------------------------------------------------------------------------
458// wxInitialize/wxUninitialize
459// ----------------------------------------------------------------------------
460
461bool wxInitialize(int argc, wxChar **argv)
462{
463 wxCRIT_SECT_LOCKER(lockInit, gs_initData.csInit);
464
465 if ( gs_initData.nInitCount++ )
466 {
467 // already initialized
468 return true;
469 }
470
471 return wxEntryStart(argc, argv);
472}
473
474void wxUninitialize()
475{
476 wxCRIT_SECT_LOCKER(lockInit, gs_initData.csInit);
477
8d7eaf91 478 if ( --gs_initData.nInitCount == 0 )
94826170
VZ
479 {
480 wxEntryCleanup();
481 }
482}