]> git.saurik.com Git - wxWidgets.git/blame_incremental - src/common/appcmn.cpp
In wxPopupFocusHandler, watch for EVT_CHAR, not EVT_KEY_DOWN.
[wxWidgets.git] / src / common / appcmn.cpp
... / ...
CommitLineData
1/////////////////////////////////////////////////////////////////////////////
2// Name: src/common/appcmn.cpp
3// Purpose: wxAppBase methods common to all platforms
4// Author: Vadim Zeitlin
5// Modified by:
6// Created: 18.10.99
7// RCS-ID: $Id$
8// Copyright: (c) Vadim Zeitlin
9// Licence: wxWindows licence
10/////////////////////////////////////////////////////////////////////////////
11
12// ============================================================================
13// declarations
14// ============================================================================
15
16// ---------------------------------------------------------------------------
17// headers
18// ---------------------------------------------------------------------------
19
20// For compilers that support precompilation, includes "wx.h".
21#include "wx/wxprec.h"
22
23#if defined(__BORLANDC__)
24 #pragma hdrstop
25#endif
26
27#ifndef WX_PRECOMP
28 #include "wx/app.h"
29 #include "wx/window.h"
30 #include "wx/bitmap.h"
31 #include "wx/log.h"
32 #include "wx/msgdlg.h"
33 #include "wx/confbase.h"
34 #include "wx/utils.h"
35 #include "wx/wxcrtvararg.h"
36#endif
37
38#include "wx/apptrait.h"
39#include "wx/cmdline.h"
40#include "wx/msgout.h"
41#include "wx/thread.h"
42#include "wx/vidmode.h"
43#include "wx/evtloop.h"
44
45#if wxUSE_FONTMAP
46 #include "wx/fontmap.h"
47#endif // wxUSE_FONTMAP
48
49// DLL options compatibility check:
50#include "wx/build.h"
51WX_CHECK_BUILD_OPTIONS("wxCore")
52
53// ============================================================================
54// wxAppBase implementation
55// ============================================================================
56
57// ----------------------------------------------------------------------------
58// initialization
59// ----------------------------------------------------------------------------
60
61wxAppBase::wxAppBase()
62{
63 m_topWindow = NULL;
64
65 m_useBestVisual = false;
66 m_forceTrueColour = false;
67
68 m_isActive = true;
69
70 // We don't want to exit the app if the user code shows a dialog from its
71 // OnInit() -- but this is what would happen if we set m_exitOnFrameDelete
72 // to Yes initially as this dialog would be the last top level window.
73 // OTOH, if we set it to No initially we'll have to overwrite it with Yes
74 // when we enter our OnRun() because we do want the default behaviour from
75 // then on. But this would be a problem if the user code calls
76 // SetExitOnFrameDelete(false) from OnInit().
77 //
78 // So we use the special "Later" value which is such that
79 // GetExitOnFrameDelete() returns false for it but which we know we can
80 // safely (i.e. without losing the effect of the users SetExitOnFrameDelete
81 // call) overwrite in OnRun()
82 m_exitOnFrameDelete = Later;
83}
84
85bool wxAppBase::Initialize(int& argcOrig, wxChar **argvOrig)
86{
87 if ( !wxAppConsole::Initialize(argcOrig, argvOrig) )
88 return false;
89
90 wxInitializeStockLists();
91
92 wxBitmap::InitStandardHandlers();
93
94 // for compatibility call the old initialization function too
95 if ( !OnInitGui() )
96 return false;
97
98 return true;
99}
100
101// ----------------------------------------------------------------------------
102// cleanup
103// ----------------------------------------------------------------------------
104
105wxAppBase::~wxAppBase()
106{
107 // this destructor is required for Darwin
108}
109
110void wxAppBase::CleanUp()
111{
112 // clean up all the pending objects
113 DeletePendingObjects();
114
115 // and any remaining TLWs (they remove themselves from wxTopLevelWindows
116 // when destroyed, so iterate until none are left)
117 while ( !wxTopLevelWindows.empty() )
118 {
119 // do not use Destroy() here as it only puts the TLW in pending list
120 // but we want to delete them now
121 delete wxTopLevelWindows.GetFirst()->GetData();
122 }
123
124 // undo everything we did in Initialize() above
125 wxBitmap::CleanUpHandlers();
126
127 wxStockGDI::DeleteAll();
128
129 wxDeleteStockLists();
130
131 delete wxTheColourDatabase;
132 wxTheColourDatabase = NULL;
133
134 wxAppConsole::CleanUp();
135}
136
137// ----------------------------------------------------------------------------
138// various accessors
139// ----------------------------------------------------------------------------
140
141wxWindow* wxAppBase::GetTopWindow() const
142{
143 wxWindow* window = m_topWindow;
144 if (window == NULL && wxTopLevelWindows.GetCount() > 0)
145 window = wxTopLevelWindows.GetFirst()->GetData();
146 return window;
147}
148
149wxVideoMode wxAppBase::GetDisplayMode() const
150{
151 return wxVideoMode();
152}
153
154wxLayoutDirection wxAppBase::GetLayoutDirection() const
155{
156#if wxUSE_INTL
157 const wxLocale *const locale = wxGetLocale();
158 if ( locale )
159 {
160 const wxLanguageInfo *const
161 info = wxLocale::GetLanguageInfo(locale->GetLanguage());
162
163 if ( info )
164 return info->LayoutDirection;
165 }
166#endif // wxUSE_INTL
167
168 // we don't know
169 return wxLayout_Default;
170}
171
172#if wxUSE_CMDLINE_PARSER
173
174// ----------------------------------------------------------------------------
175// GUI-specific command line options handling
176// ----------------------------------------------------------------------------
177
178#define OPTION_THEME "theme"
179#define OPTION_MODE "mode"
180
181void wxAppBase::OnInitCmdLine(wxCmdLineParser& parser)
182{
183 // first add the standard non GUI options
184 wxAppConsole::OnInitCmdLine(parser);
185
186 // the standard command line options
187 static const wxCmdLineEntryDesc cmdLineGUIDesc[] =
188 {
189#ifdef __WXUNIVERSAL__
190 {
191 wxCMD_LINE_OPTION,
192 NULL,
193 OPTION_THEME,
194 gettext_noop("specify the theme to use"),
195 wxCMD_LINE_VAL_STRING,
196 0x0
197 },
198#endif // __WXUNIVERSAL__
199
200#if defined(__WXMGL__)
201 // VS: this is not specific to wxMGL, all fullscreen (framebuffer) ports
202 // should provide this option. That's why it is in common/appcmn.cpp
203 // and not mgl/app.cpp
204 {
205 wxCMD_LINE_OPTION,
206 NULL,
207 OPTION_MODE,
208 gettext_noop("specify display mode to use (e.g. 640x480-16)"),
209 wxCMD_LINE_VAL_STRING,
210 0x0
211 },
212#endif // __WXMGL__
213
214 // terminator
215 wxCMD_LINE_DESC_END
216 };
217
218 parser.SetDesc(cmdLineGUIDesc);
219}
220
221bool wxAppBase::OnCmdLineParsed(wxCmdLineParser& parser)
222{
223#ifdef __WXUNIVERSAL__
224 wxString themeName;
225 if ( parser.Found(OPTION_THEME, &themeName) )
226 {
227 wxTheme *theme = wxTheme::Create(themeName);
228 if ( !theme )
229 {
230 wxLogError(_("Unsupported theme '%s'."), themeName.c_str());
231 return false;
232 }
233
234 // Delete the defaultly created theme and set the new theme.
235 delete wxTheme::Get();
236 wxTheme::Set(theme);
237 }
238#endif // __WXUNIVERSAL__
239
240#if defined(__WXMGL__)
241 wxString modeDesc;
242 if ( parser.Found(OPTION_MODE, &modeDesc) )
243 {
244 unsigned w, h, bpp;
245 if ( wxSscanf(modeDesc.c_str(), wxT("%ux%u-%u"), &w, &h, &bpp) != 3 )
246 {
247 wxLogError(_("Invalid display mode specification '%s'."), modeDesc.c_str());
248 return false;
249 }
250
251 if ( !SetDisplayMode(wxVideoMode(w, h, bpp)) )
252 return false;
253 }
254#endif // __WXMGL__
255
256 return wxAppConsole::OnCmdLineParsed(parser);
257}
258
259#endif // wxUSE_CMDLINE_PARSER
260
261// ----------------------------------------------------------------------------
262// OnXXX() hooks
263// ----------------------------------------------------------------------------
264
265bool wxAppBase::OnInitGui()
266{
267#ifdef __WXUNIVERSAL__
268 if ( !wxTheme::Get() && !wxTheme::CreateDefault() )
269 return false;
270#endif // __WXUNIVERSAL__
271
272 return true;
273}
274
275int wxAppBase::OnRun()
276{
277 // see the comment in ctor: if the initial value hasn't been changed, use
278 // the default Yes from now on
279 if ( m_exitOnFrameDelete == Later )
280 {
281 m_exitOnFrameDelete = Yes;
282 }
283 //else: it has been changed, assume the user knows what he is doing
284
285 return wxAppConsole::OnRun();
286}
287
288int wxAppBase::OnExit()
289{
290#ifdef __WXUNIVERSAL__
291 delete wxTheme::Set(NULL);
292#endif // __WXUNIVERSAL__
293
294 return wxAppConsole::OnExit();
295}
296
297wxAppTraits *wxAppBase::CreateTraits()
298{
299 return new wxGUIAppTraits;
300}
301
302// ----------------------------------------------------------------------------
303// misc
304// ----------------------------------------------------------------------------
305
306void wxAppBase::SetActive(bool active, wxWindow * WXUNUSED(lastFocus))
307{
308 if ( active == m_isActive )
309 return;
310
311 m_isActive = active;
312
313 wxActivateEvent event(wxEVT_ACTIVATE_APP, active);
314 event.SetEventObject(this);
315
316 (void)ProcessEvent(event);
317}
318
319bool wxAppBase::SafeYield(wxWindow *win, bool onlyIfNeeded)
320{
321 wxWindowDisabler wd(win);
322
323 wxEventLoopBase * const loop = wxEventLoopBase::GetActive();
324
325 return loop && loop->Yield(onlyIfNeeded);
326}
327
328bool wxAppBase::SafeYieldFor(wxWindow *win, long eventsToProcess)
329{
330 wxWindowDisabler wd(win);
331
332 wxEventLoopBase * const loop = wxEventLoopBase::GetActive();
333
334 return loop && loop->YieldFor(eventsToProcess);
335}
336
337
338// ----------------------------------------------------------------------------
339// idle handling
340// ----------------------------------------------------------------------------
341
342// Returns true if more time is needed.
343bool wxAppBase::ProcessIdle()
344{
345 // call the base class version first to send the idle event to wxTheApp
346 // itself
347 bool needMore = wxAppConsoleBase::ProcessIdle();
348 wxIdleEvent event;
349 wxWindowList::compatibility_iterator node = wxTopLevelWindows.GetFirst();
350 while (node)
351 {
352 wxWindow* win = node->GetData();
353 if (SendIdleEvents(win, event))
354 needMore = true;
355 node = node->GetNext();
356 }
357
358 wxUpdateUIEvent::ResetUpdateTime();
359
360 return needMore;
361}
362
363// Send idle event to window and all subwindows
364bool wxAppBase::SendIdleEvents(wxWindow* win, wxIdleEvent& event)
365{
366 bool needMore = false;
367
368 win->OnInternalIdle();
369
370 // should we send idle event to this window?
371 if ( wxIdleEvent::GetMode() == wxIDLE_PROCESS_ALL ||
372 win->HasExtraStyle(wxWS_EX_PROCESS_IDLE) )
373 {
374 event.SetEventObject(win);
375 win->HandleWindowEvent(event);
376
377 if (event.MoreRequested())
378 needMore = true;
379 }
380 wxWindowList::compatibility_iterator node = win->GetChildren().GetFirst();
381 while ( node )
382 {
383 wxWindow *child = node->GetData();
384 if (SendIdleEvents(child, event))
385 needMore = true;
386
387 node = node->GetNext();
388 }
389
390 return needMore;
391}
392
393// ----------------------------------------------------------------------------
394// wxGUIAppTraitsBase
395// ----------------------------------------------------------------------------
396
397#if wxUSE_LOG
398
399wxLog *wxGUIAppTraitsBase::CreateLogTarget()
400{
401#if wxUSE_LOGGUI
402 return new wxLogGui;
403#else
404 // we must have something!
405 return new wxLogStderr;
406#endif
407}
408
409#endif // wxUSE_LOG
410
411wxMessageOutput *wxGUIAppTraitsBase::CreateMessageOutput()
412{
413 // The standard way of printing help on command line arguments (app --help)
414 // is (according to common practice):
415 // - console apps: to stderr (on any platform)
416 // - GUI apps: stderr on Unix platforms (!)
417 // stderr if available and message box otherwise on others
418 // (currently stderr only Windows if app running from console)
419#ifdef __UNIX__
420 return new wxMessageOutputStderr;
421#else // !__UNIX__
422 // wxMessageOutputMessageBox doesn't work under Motif
423 #ifdef __WXMOTIF__
424 return new wxMessageOutputLog;
425 #elif wxUSE_MSGDLG
426 return new wxMessageOutputBest(wxMSGOUT_PREFER_STDERR);
427 #else
428 return new wxMessageOutputStderr;
429 #endif
430#endif // __UNIX__/!__UNIX__
431}
432
433#if wxUSE_FONTMAP
434
435wxFontMapper *wxGUIAppTraitsBase::CreateFontMapper()
436{
437 return new wxFontMapper;
438}
439
440#endif // wxUSE_FONTMAP
441
442wxRendererNative *wxGUIAppTraitsBase::CreateRenderer()
443{
444 // use the default native renderer by default
445 return NULL;
446}
447
448bool wxGUIAppTraitsBase::ShowAssertDialog(const wxString& msg)
449{
450#if wxDEBUG_LEVEL
451 // under MSW we prefer to use the base class version using ::MessageBox()
452 // even if wxMessageBox() is available because it has less chances to
453 // double fault our app than our wxMessageBox()
454 //
455 // under DFB the message dialog is not always functional right now
456 //
457 // and finally we can't use wxMessageBox() if it wasn't compiled in, of
458 // course
459#if !defined(__WXMSW__) && !defined(__WXDFB__) && wxUSE_MSGDLG
460
461 // we can't (safely) show the GUI dialog from another thread, only do it
462 // for the asserts in the main thread
463 if ( wxIsMainThread() )
464 {
465 wxString msgDlg = msg;
466
467#if wxUSE_STACKWALKER
468 const wxString stackTrace = GetAssertStackTrace();
469 if ( !stackTrace.empty() )
470 msgDlg << wxT("\n\nCall stack:\n") << stackTrace;
471#endif // wxUSE_STACKWALKER
472
473 // this message is intentionally not translated -- it is for
474 // developpers only
475 msgDlg += wxT("\nDo you want to stop the program?\n")
476 wxT("You can also choose [Cancel] to suppress ")
477 wxT("further warnings.");
478
479 switch ( wxMessageBox(msgDlg, wxT("wxWidgets Debug Alert"),
480 wxYES_NO | wxCANCEL | wxICON_STOP ) )
481 {
482 case wxYES:
483 wxTrap();
484 break;
485
486 case wxCANCEL:
487 // no more asserts
488 return true;
489
490 //case wxNO: nothing to do
491 }
492
493 return false;
494 }
495#endif // wxUSE_MSGDLG
496#endif // wxDEBUG_LEVEL
497
498 return wxAppTraitsBase::ShowAssertDialog(msg);
499}
500
501bool wxGUIAppTraitsBase::HasStderr()
502{
503 // we consider that under Unix stderr always goes somewhere, even if the
504 // user doesn't always see it under GUI desktops
505#ifdef __UNIX__
506 return true;
507#else
508 return false;
509#endif
510}
511