1 /////////////////////////////////////////////////////////////////////////////
2 // Name: src/common/appcmn.cpp
3 // Purpose: wxAppConsole and wxAppBase methods common to all platforms
4 // Author: Vadim Zeitlin
8 // Copyright: (c) Vadim Zeitlin
9 // Licence: wxWindows licence
10 /////////////////////////////////////////////////////////////////////////////
12 // ============================================================================
14 // ============================================================================
16 // ---------------------------------------------------------------------------
18 // ---------------------------------------------------------------------------
20 // For compilers that support precompilation, includes "wx.h".
21 #include "wx/wxprec.h"
23 #if defined(__BORLANDC__)
30 #include "wx/bitmap.h"
33 #include "wx/msgdlg.h"
34 #include "wx/bitmap.h"
35 #include "wx/confbase.h"
39 #include "wx/apptrait.h"
40 #include "wx/cmdline.h"
41 #include "wx/evtloop.h"
42 #include "wx/msgout.h"
43 #include "wx/thread.h"
44 #include "wx/ptr_scpd.h"
46 #if defined(__WXMSW__)
47 #include "wx/msw/private.h" // includes windows.h for LOGFONT
51 #include "wx/fontmap.h"
52 #endif // wxUSE_FONTMAP
54 // DLL options compatibility check:
56 WX_CHECK_BUILD_OPTIONS("wxCore")
59 // ----------------------------------------------------------------------------
61 // ----------------------------------------------------------------------------
63 // this defines wxEventLoopPtr
64 wxDEFINE_TIED_SCOPED_PTR_TYPE(wxEventLoop
)
66 // ============================================================================
67 // wxAppBase implementation
68 // ============================================================================
70 // ----------------------------------------------------------------------------
72 // ----------------------------------------------------------------------------
74 wxAppBase::wxAppBase()
76 m_topWindow
= (wxWindow
*)NULL
;
77 m_useBestVisual
= false;
82 // We don't want to exit the app if the user code shows a dialog from its
83 // OnInit() -- but this is what would happen if we set m_exitOnFrameDelete
84 // to Yes initially as this dialog would be the last top level window.
85 // OTOH, if we set it to No initially we'll have to overwrite it with Yes
86 // when we enter our OnRun() because we do want the default behaviour from
87 // then on. But this would be a problem if the user code calls
88 // SetExitOnFrameDelete(false) from OnInit().
90 // So we use the special "Later" value which is such that
91 // GetExitOnFrameDelete() returns false for it but which we know we can
92 // safely (i.e. without losing the effect of the users SetExitOnFrameDelete
93 // call) overwrite in OnRun()
94 m_exitOnFrameDelete
= Later
;
97 bool wxAppBase::Initialize(int& argcOrig
, wxChar
**argvOrig
)
99 if ( !wxAppConsole::Initialize(argcOrig
, argvOrig
) )
103 wxPendingEventsLocker
= new wxCriticalSection
;
106 wxInitializeStockLists();
108 wxBitmap::InitStandardHandlers();
113 // ----------------------------------------------------------------------------
115 // ----------------------------------------------------------------------------
117 wxAppBase::~wxAppBase()
119 // this destructor is required for Darwin
122 void wxAppBase::CleanUp()
124 // clean up all the pending objects
125 DeletePendingObjects();
127 // and any remaining TLWs (they remove themselves from wxTopLevelWindows
128 // when destroyed, so iterate until none are left)
129 while ( !wxTopLevelWindows
.empty() )
131 // do not use Destroy() here as it only puts the TLW in pending list
132 // but we want to delete them now
133 delete wxTopLevelWindows
.GetFirst()->GetData();
136 // undo everything we did in Initialize() above
137 wxBitmap::CleanUpHandlers();
139 wxStockGDI::DeleteAll();
141 wxDeleteStockLists();
143 delete wxTheColourDatabase
;
144 wxTheColourDatabase
= NULL
;
146 delete wxPendingEvents
;
147 wxPendingEvents
= NULL
;
150 delete wxPendingEventsLocker
;
151 wxPendingEventsLocker
= NULL
;
154 // If we don't do the following, we get an apparent memory leak.
155 ((wxEvtHandler
&) wxDefaultValidator
).ClearEventLocker();
156 #endif // wxUSE_VALIDATORS
157 #endif // wxUSE_THREADS
160 #if wxUSE_CMDLINE_PARSER
162 // ----------------------------------------------------------------------------
163 // GUI-specific command line options handling
164 // ----------------------------------------------------------------------------
166 #define OPTION_THEME _T("theme")
167 #define OPTION_MODE _T("mode")
169 void wxAppBase::OnInitCmdLine(wxCmdLineParser
& parser
)
171 // first add the standard non GUI options
172 wxAppConsole::OnInitCmdLine(parser
);
174 // the standard command line options
175 static const wxCmdLineEntryDesc cmdLineGUIDesc
[] =
177 #ifdef __WXUNIVERSAL__
182 gettext_noop("specify the theme to use"),
183 wxCMD_LINE_VAL_STRING
,
186 #endif // __WXUNIVERSAL__
188 #if defined(__WXMGL__)
189 // VS: this is not specific to wxMGL, all fullscreen (framebuffer) ports
190 // should provide this option. That's why it is in common/appcmn.cpp
191 // and not mgl/app.cpp
196 gettext_noop("specify display mode to use (e.g. 640x480-16)"),
197 wxCMD_LINE_VAL_STRING
,
213 parser
.SetDesc(cmdLineGUIDesc
);
216 bool wxAppBase::OnCmdLineParsed(wxCmdLineParser
& parser
)
218 #ifdef __WXUNIVERSAL__
220 if ( parser
.Found(OPTION_THEME
, &themeName
) )
222 wxTheme
*theme
= wxTheme::Create(themeName
);
225 wxLogError(_("Unsupported theme '%s'."), themeName
.c_str());
229 // Delete the defaultly created theme and set the new theme.
230 delete wxTheme::Get();
233 #endif // __WXUNIVERSAL__
235 #if defined(__WXMGL__)
237 if ( parser
.Found(OPTION_MODE
, &modeDesc
) )
240 if ( wxSscanf(modeDesc
.c_str(), _T("%ux%u-%u"), &w
, &h
, &bpp
) != 3 )
242 wxLogError(_("Invalid display mode specification '%s'."), modeDesc
.c_str());
246 if ( !SetDisplayMode(wxVideoMode(w
, h
, bpp
)) )
251 return wxAppConsole::OnCmdLineParsed(parser
);
254 #endif // wxUSE_CMDLINE_PARSER
256 // ----------------------------------------------------------------------------
257 // main event loop implementation
258 // ----------------------------------------------------------------------------
260 int wxAppBase::MainLoop()
262 wxEventLoopTiedPtr
mainLoop(&m_mainLoop
, new wxEventLoop
);
264 return m_mainLoop
->Run();
267 void wxAppBase::ExitMainLoop()
269 // we should exit from the main event loop, not just any currently active
270 // (e.g. modal dialog) event loop
271 if ( m_mainLoop
&& m_mainLoop
->IsRunning() )
277 bool wxAppBase::Pending()
279 // use the currently active message loop here, not m_mainLoop, because if
280 // we're showing a modal dialog (with its own event loop) currently the
281 // main event loop is not running anyhow
282 wxEventLoop
* const loop
= wxEventLoop::GetActive();
284 return loop
&& loop
->Pending();
287 bool wxAppBase::Dispatch()
289 // see comment in Pending()
290 wxEventLoop
* const loop
= wxEventLoop::GetActive();
292 return loop
&& loop
->Dispatch();
295 // ----------------------------------------------------------------------------
297 // ----------------------------------------------------------------------------
299 bool wxAppBase::OnInitGui()
301 #ifdef __WXUNIVERSAL__
302 if ( !wxTheme::Get() && !wxTheme::CreateDefault() )
304 #endif // __WXUNIVERSAL__
309 int wxAppBase::OnRun()
311 // see the comment in ctor: if the initial value hasn't been changed, use
312 // the default Yes from now on
313 if ( m_exitOnFrameDelete
== Later
)
315 m_exitOnFrameDelete
= Yes
;
317 //else: it has been changed, assume the user knows what he is doing
322 int wxAppBase::OnExit()
324 #ifdef __WXUNIVERSAL__
325 delete wxTheme::Set(NULL
);
326 #endif // __WXUNIVERSAL__
328 return wxAppConsole::OnExit();
331 void wxAppBase::Exit()
336 wxAppTraits
*wxAppBase::CreateTraits()
338 return new wxGUIAppTraits
;
341 // ----------------------------------------------------------------------------
343 // ----------------------------------------------------------------------------
345 void wxAppBase::SetActive(bool active
, wxWindow
* WXUNUSED(lastFocus
))
347 if ( active
== m_isActive
)
352 wxActivateEvent
event(wxEVT_ACTIVATE_APP
, active
);
353 event
.SetEventObject(this);
355 (void)ProcessEvent(event
);
358 // ----------------------------------------------------------------------------
360 // ----------------------------------------------------------------------------
362 void wxAppBase::DeletePendingObjects()
364 wxList::compatibility_iterator node
= wxPendingDelete
.GetFirst();
367 wxObject
*obj
= node
->GetData();
371 if (wxPendingDelete
.Member(obj
))
372 wxPendingDelete
.Erase(node
);
374 // Deleting one object may have deleted other pending
375 // objects, so start from beginning of list again.
376 node
= wxPendingDelete
.GetFirst();
380 // Returns true if more time is needed.
381 bool wxAppBase::ProcessIdle()
384 bool needMore
= false;
385 wxWindowList::compatibility_iterator node
= wxTopLevelWindows
.GetFirst();
388 wxWindow
* win
= node
->GetData();
389 if (SendIdleEvents(win
, event
))
391 node
= node
->GetNext();
394 event
.SetEventObject(this);
395 (void) ProcessEvent(event
);
396 if (event
.MoreRequested())
399 wxUpdateUIEvent::ResetUpdateTime();
404 // Send idle event to window and all subwindows
405 bool wxAppBase::SendIdleEvents(wxWindow
* win
, wxIdleEvent
& event
)
407 bool needMore
= false;
409 win
->OnInternalIdle();
411 if (wxIdleEvent::CanSend(win
))
413 event
.SetEventObject(win
);
414 win
->GetEventHandler()->ProcessEvent(event
);
416 if (event
.MoreRequested())
419 wxWindowList::compatibility_iterator node
= win
->GetChildren().GetFirst();
422 wxWindow
*child
= node
->GetData();
423 if (SendIdleEvents(child
, event
))
426 node
= node
->GetNext();
432 void wxAppBase::OnIdle(wxIdleEvent
& WXUNUSED(event
))
434 // If there are pending events, we must process them: pending events
435 // are either events to the threads other than main or events posted
436 // with wxPostEvent() functions
437 // GRG: I have moved this here so that all pending events are processed
438 // before starting to delete any objects. This behaves better (in
439 // particular, wrt wxPostEvent) and is coherent with wxGTK's current
440 // behaviour. Changed Feb/2000 before 2.1.14
441 ProcessPendingEvents();
443 // 'Garbage' collection of windows deleted with Close().
444 DeletePendingObjects();
447 // flush the logged messages if any
448 wxLog::FlushActive();
453 // ----------------------------------------------------------------------------
454 // exceptions support
455 // ----------------------------------------------------------------------------
459 bool wxAppBase::OnExceptionInMainLoop()
463 // some compilers are too stupid to know that we never return after throw
464 #if defined(__DMC__) || (defined(_MSC_VER) && _MSC_VER < 1200)
469 #endif // wxUSE_EXCEPTIONS
471 // ----------------------------------------------------------------------------
472 // wxGUIAppTraitsBase
473 // ----------------------------------------------------------------------------
477 wxLog
*wxGUIAppTraitsBase::CreateLogTarget()
482 // we must have something!
483 return new wxLogStderr
;
489 wxMessageOutput
*wxGUIAppTraitsBase::CreateMessageOutput()
491 // The standard way of printing help on command line arguments (app --help)
492 // is (according to common practice):
493 // - console apps: to stderr (on any platform)
494 // - GUI apps: stderr on Unix platforms (!)
495 // message box under Windows and others
497 return new wxMessageOutputStderr
;
499 // wxMessageOutputMessageBox doesn't work under Motif
501 return new wxMessageOutputLog
;
503 return new wxMessageOutputMessageBox
;
505 #endif // __UNIX__/!__UNIX__
510 wxFontMapper
*wxGUIAppTraitsBase::CreateFontMapper()
512 return new wxFontMapper
;
515 #endif // wxUSE_FONTMAP
517 wxRendererNative
*wxGUIAppTraitsBase::CreateRenderer()
519 // use the default native renderer by default
525 bool wxGUIAppTraitsBase::ShowAssertDialog(const wxString
& msg
)
527 // under MSW we prefer to use the base class version using ::MessageBox()
528 // even if wxMessageBox() is available because it has less chances to
529 // double fault our app than our wxMessageBox()
530 #if defined(__WXMSW__) || !wxUSE_MSGDLG
531 return wxAppTraitsBase::ShowAssertDialog(msg
);
532 #else // wxUSE_MSGDLG
533 // this message is intentionally not translated -- it is for
535 wxString
msgDlg(msg
);
536 msgDlg
+= wxT("\nDo you want to stop the program?\n")
537 wxT("You can also choose [Cancel] to suppress ")
538 wxT("further warnings.");
540 switch ( wxMessageBox(msgDlg
, wxT("wxWidgets Debug Alert"),
541 wxYES_NO
| wxCANCEL
| wxICON_STOP
) )
551 //case wxNO: nothing to do
555 #endif // !wxUSE_MSGDLG/wxUSE_MSGDLG
558 #endif // __WXDEBUG__
560 bool wxGUIAppTraitsBase::HasStderr()
562 // we consider that under Unix stderr always goes somewhere, even if the
563 // user doesn't always see it under GUI desktops
571 void wxGUIAppTraitsBase::ScheduleForDestroy(wxObject
*object
)
573 if ( !wxPendingDelete
.Member(object
) )
574 wxPendingDelete
.Append(object
);
577 void wxGUIAppTraitsBase::RemoveFromPendingDelete(wxObject
*object
)
579 wxPendingDelete
.DeleteObject(object
);
584 #if defined(__WINDOWS__)
585 #include "wx/msw/gsockmsw.h"
586 #elif defined(__UNIX__) || defined(__DARWIN__) || defined(__OS2__)
587 #include "wx/unix/gsockunx.h"
588 #elif defined(__WXMAC__)
589 #include <MacHeaders.c>
590 #define OTUNIXERRORS 1
591 #include <OpenTransport.h>
592 #include <OpenTransportProviders.h>
593 #include <OpenTptInternet.h>
595 #include "wx/mac/gsockmac.h"
597 #error "Must include correct GSocket header here"
600 GSocketGUIFunctionsTable
* wxGUIAppTraitsBase::GetSocketGUIFunctionsTable()
602 #if defined(__WXMAC__) && !defined(__DARWIN__)
603 // NB: wxMac CFM does not have any GUI-specific functions in gsocket.c and
604 // so it doesn't need this table at all
606 #else // !__WXMAC__ || __DARWIN__
607 static GSocketGUIFunctionsTableConcrete table
;
609 #endif // !__WXMAC__ || __DARWIN__