/////////////////////////////////////////////////////////////////////////////
// Name: common/appcmn.cpp
-// Purpose: wxAppBase methods common to all platforms
+// Purpose: wxAppConsole and wxAppBase methods common to all platforms
// Author: Vadim Zeitlin
// Modified by:
// Created: 18.10.99
#include "wx/app.h"
#include "wx/intl.h"
#include "wx/list.h"
- #if wxUSE_GUI
- #include "wx/msgdlg.h"
- #endif // wxUSE_GUI
+ #include "wx/log.h"
+ #include "wx/msgdlg.h"
#endif
-#include "wx/cmdline.h"
+#include "wx/apptrait.h"
+#if wxUSE_FONTMAP
+ #include "wx/fontmap.h"
+#endif // wxUSE_FONTMAP
+#include "wx/msgout.h"
#include "wx/thread.h"
-#include "wx/confbase.h"
-#include "wx/tokenzr.h"
#include "wx/utils.h"
-#if wxUSE_GUI
- #include "wx/artprov.h"
-#endif // wxUSE_GUI
-
-#if !defined(__WXMSW__) || defined(__WXMICROWIN__)
- #include <signal.h> // for SIGTRAP used by wxTrap()
-#endif //Win/Unix
-
-#if defined(__WXMSW__)
- #include "wx/msw/private.h" // includes windows.h for MessageBox()
-#endif
-
-#if defined(__WXMAC__)
- #include "wx/mac/private.h" // includes mac headers
-#endif
-
-// private functions prototypes
-#ifdef __WXDEBUG__
- static void LINKAGEMODE SetTraceMasks();
-#endif // __WXDEBUG__
-
-// ===========================================================================
-// implementation
-// ===========================================================================
+// ============================================================================
+// wxAppBase implementation
+// ============================================================================
// ----------------------------------------------------------------------------
-// initialization and termination
+// initialization
// ----------------------------------------------------------------------------
wxAppBase::wxAppBase()
{
- wxTheApp = (wxApp *)this;
-
-#if WXWIN_COMPATIBILITY_2_2
- m_wantDebugOutput = FALSE;
-#endif // WXWIN_COMPATIBILITY_2_2
-
-#if wxUSE_GUI
m_topWindow = (wxWindow *)NULL;
m_useBestVisual = FALSE;
- m_exitOnFrameDelete = TRUE;
m_isActive = TRUE;
-#endif // wxUSE_GUI
-#ifdef __WXDEBUG__
- SetTraceMasks();
+ // We don't want to exit the app if the user code shows a dialog from its
+ // OnInit() -- but this is what would happen if we set m_exitOnFrameDelete
+ // to Yes initially as this dialog would be the last top level window.
+ // OTOH, if we set it to No initially we'll have to overwrite it with Yes
+ // when we enter our OnRun() because we do want the default behaviour from
+ // then on. But this would be a problem if the user code calls
+ // SetExitOnFrameDelete(FALSE) from OnInit().
+ //
+ // So we use the special "Later" value which is such that
+ // GetExitOnFrameDelete() returns FALSE for it but which we know we can
+ // safely (i.e. without losing the effect of the users SetExitOnFrameDelete
+ // call) overwrite in OnRun()
+ m_exitOnFrameDelete = Later;
+}
+
+bool wxAppBase::Initialize(int& argc, wxChar **argv)
+{
+ if ( !wxAppConsole::Initialize(argc, argv) )
+ return false;
+
+#if wxUSE_THREADS
+ wxPendingEventsLocker = new wxCriticalSection;
#endif
+
+ wxTheColourDatabase = new wxColourDatabase(wxKEY_STRING);
+ wxTheColourDatabase->Initialize();
+
+ wxInitializeStockLists();
+ wxInitializeStockObjects();
+
+ wxBitmap::InitStandardHandlers();
+
+ return true;
}
+// ----------------------------------------------------------------------------
+// cleanup
+// ----------------------------------------------------------------------------
+
wxAppBase::~wxAppBase()
{
// this destructor is required for Darwin
}
-#if wxUSE_GUI
-bool wxAppBase::OnInitGui()
+void wxAppBase::CleanUp()
{
-#ifdef __WXUNIVERSAL__
- if ( !wxTheme::Get() && !wxTheme::CreateDefault() )
- return FALSE;
- wxArtProvider *art = wxTheme::Get()->GetArtProvider();
- if ( art )
- wxArtProvider::PushProvider(art);
-#endif // __WXUNIVERSAL__
+ // one last chance for pending objects to be cleaned up
+ DeletePendingObjects();
- return TRUE;
-}
-#endif // wxUSE_GUI
+ wxBitmap::CleanUpHandlers();
-int wxAppBase::OnExit()
-{
-#if wxUSE_CONFIG
- // delete the config object if any (don't use Get() here, but Set()
- // because Get() could create a new config object)
- delete wxConfigBase::Set((wxConfigBase *) NULL);
-#endif // wxUSE_CONFIG
+ wxDeleteStockObjects();
-#ifdef __WXUNIVERSAL__
- delete wxTheme::Set(NULL);
-#endif // __WXUNIVERSAL__
+ wxDeleteStockLists();
- return 0;
+ delete wxTheColourDatabase;
+ wxTheColourDatabase = NULL;
+
+#if wxUSE_THREADS
+ delete wxPendingEvents;
+ wxPendingEvents = NULL;
+
+ delete wxPendingEventsLocker;
+ wxPendingEventsLocker = NULL;
+
+#if wxUSE_VALIDATORS
+ // If we don't do the following, we get an apparent memory leak.
+ ((wxEvtHandler&) wxDefaultValidator).ClearEventLocker();
+#endif // wxUSE_VALIDATORS
+#endif // wxUSE_THREADS
}
-// ---------------------------------------------------------------------------
-// wxAppBase
+// ----------------------------------------------------------------------------
+// OnXXX() hooks
// ----------------------------------------------------------------------------
-void wxAppBase::ProcessPendingEvents()
+bool wxAppBase::OnInitGui()
{
- // ensure that we're the only thread to modify the pending events list
- wxENTER_CRIT_SECT( *wxPendingEventsLocker );
+#ifdef __WXUNIVERSAL__
+ if ( !wxTheme::Get() && !wxTheme::CreateDefault() )
+ return FALSE;
+#endif // __WXUNIVERSAL__
- if ( !wxPendingEvents )
- {
- wxLEAVE_CRIT_SECT( *wxPendingEventsLocker );
- return;
- }
+ return TRUE;
+}
- // iterate until the list becomes empty
- wxNode *node = wxPendingEvents->First();
- while (node)
+int wxAppBase::OnRun()
+{
+ // see the comment in ctor: if the initial value hasn't been changed, use
+ // the default Yes from now on
+ if ( m_exitOnFrameDelete == Later )
{
- wxEvtHandler *handler = (wxEvtHandler *)node->Data();
- delete node;
+ m_exitOnFrameDelete = Yes;
+ }
+ //else: it has been changed, assume the user knows what he is doing
- // In ProcessPendingEvents(), new handlers might be add
- // and we can safely leave the critical section here.
- wxLEAVE_CRIT_SECT( *wxPendingEventsLocker );
- handler->ProcessPendingEvents();
- wxENTER_CRIT_SECT( *wxPendingEventsLocker );
+ return MainLoop();
+}
- node = wxPendingEvents->First();
- }
+void wxAppBase::Exit()
+{
+ ExitMainLoop();
+}
- wxLEAVE_CRIT_SECT( *wxPendingEventsLocker );
+wxAppTraits *wxAppBase::CreateTraits()
+{
+ return wxAppTraits::CreateGUI();
}
// ----------------------------------------------------------------------------
// misc
// ----------------------------------------------------------------------------
-#if wxUSE_GUI
-
void wxAppBase::SetActive(bool active, wxWindow * WXUNUSED(lastFocus))
{
if ( active == m_isActive )
(void)ProcessEvent(event);
}
-#endif // wxUSE_GUI
-
-int wxAppBase::FilterEvent(wxEvent& WXUNUSED(event))
-{
- // process the events normally by default
- return -1;
-}
-
-// ----------------------------------------------------------------------------
-// cmd line parsing
-// ----------------------------------------------------------------------------
-
-bool wxAppBase::OnInit()
+void wxAppBase::DeletePendingObjects()
{
-#if wxUSE_CMDLINE_PARSER
- wxCmdLineParser parser(argc, argv);
-
- OnInitCmdLine(parser);
-
- bool cont;
- switch ( parser.Parse(FALSE /* don't show usage */) )
+ wxNode *node = wxPendingDelete.GetFirst();
+ while (node)
{
- case -1:
- cont = OnCmdLineHelp(parser);
- break;
+ wxObject *obj = node->GetData();
- case 0:
- cont = OnCmdLineParsed(parser);
- break;
+ delete obj;
- default:
- cont = OnCmdLineError(parser);
- break;
- }
-
- if ( !cont )
- return FALSE;
-#endif // wxUSE_CMDLINE_PARSER
+ if (wxPendingDelete.Member(obj))
+ delete node;
- return TRUE;
+ // Deleting one object may have deleted other pending
+ // objects, so start from beginning of list again.
+ node = wxPendingDelete.GetFirst();
+ }
}
-#if wxUSE_CMDLINE_PARSER
-
-#define OPTION_VERBOSE _T("verbose")
-#define OPTION_THEME _T("theme")
-#define OPTION_MODE _T("mode")
-
-void wxAppBase::OnInitCmdLine(wxCmdLineParser& parser)
-{
- // the standard command line options
- static const wxCmdLineEntryDesc cmdLineDesc[] =
- {
- {
- wxCMD_LINE_SWITCH,
- _T("h"),
- _T("help"),
- gettext_noop("show this help message"),
- wxCMD_LINE_VAL_NONE,
- wxCMD_LINE_OPTION_HELP
- },
+// ----------------------------------------------------------------------------
+// wxGUIAppTraitsBase
+// ----------------------------------------------------------------------------
#if wxUSE_LOG
- {
- wxCMD_LINE_SWITCH,
- _T(""),
- OPTION_VERBOSE,
- gettext_noop("generate verbose log messages"),
- wxCMD_LINE_VAL_NONE,
- 0x0
- },
-#endif // wxUSE_LOG
-
-#ifdef __WXUNIVERSAL__
- {
- wxCMD_LINE_OPTION,
- _T(""),
- OPTION_THEME,
- gettext_noop("specify the theme to use"),
- wxCMD_LINE_VAL_STRING,
- 0x0
- },
-#endif // __WXUNIVERSAL__
-#if defined(__WXMGL__)
- // VS: this is not specific to wxMGL, all fullscreen (framebuffer) ports
- // should provide this option. That's why it is in common/appcmn.cpp
- // and not mgl/app.cpp
- {
- wxCMD_LINE_OPTION,
- _T(""),
- OPTION_MODE,
- gettext_noop("specify display mode to use (e.g. 640x480-16)"),
- wxCMD_LINE_VAL_STRING,
- 0x0
- },
-#endif // __WXMGL__
-
- // terminator
- {
- wxCMD_LINE_NONE,
- _T(""),
- _T(""),
- _T(""),
- wxCMD_LINE_VAL_NONE,
- 0x0
- }
- };
-
- parser.SetDesc(cmdLineDesc);
+wxLog *wxGUIAppTraitsBase::CreateLogTarget()
+{
+ return new wxLogGui;
}
-bool wxAppBase::OnCmdLineParsed(wxCmdLineParser& parser)
-{
-#if wxUSE_LOG
- if ( parser.Found(OPTION_VERBOSE) )
- {
- wxLog::SetVerbose(TRUE);
- }
#endif // wxUSE_LOG
-#ifdef __WXUNIVERSAL__
- wxString themeName;
- if ( parser.Found(OPTION_THEME, &themeName) )
- {
- wxTheme *theme = wxTheme::Create(themeName);
- if ( !theme )
- {
- wxLogError(_("Unsupported theme '%s'."), themeName.c_str());
-
- return FALSE;
- }
-
- wxTheme::Set(theme);
- }
-#endif // __WXUNIVERSAL__
-
-#if defined(__WXMGL__)
- wxString modeDesc;
- if ( parser.Found(OPTION_MODE, &modeDesc) )
- {
- unsigned w, h, bpp;
- if ( wxSscanf(modeDesc.c_str(), _T("%ux%u-%u"), &w, &h, &bpp) != 3 )
- {
- wxLogError(_("Invalid display mode specification '%s'."), modeDesc.c_str());
-
- return FALSE;
- }
-
- if ( !SetDisplayMode(wxDisplayModeInfo(w, h, bpp)) )
- return FALSE;
- }
-#endif // __WXMGL__
-
- return TRUE;
-}
-
-bool wxAppBase::OnCmdLineHelp(wxCmdLineParser& parser)
+wxMessageOutput *wxGUIAppTraitsBase::CreateMessageOutput()
{
- parser.Usage();
-
- return FALSE;
+ // The standard way of printing help on command line arguments (app --help)
+ // is (according to common practice):
+ // - console apps: to stderr (on any platform)
+ // - GUI apps: stderr on Unix platforms (!)
+ // message box under Windows and others
+#ifdef __UNIX__
+ return new wxMessageOutputStderr;
+#else // !__UNIX__
+ // wxMessageOutputMessageBox doesn't work under Motif
+ #ifdef __WXMOTIF__
+ return new wxMessageOutputLog;
+ #else
+ return new wxMessageOutputMessageBox;
+ #endif
+#endif // __UNIX__/!__UNIX__
}
-bool wxAppBase::OnCmdLineError(wxCmdLineParser& parser)
-{
- parser.Usage();
+#if wxUSE_FONTMAP
- return FALSE;
+wxFontMapper *wxGUIAppTraitsBase::CreateFontMapper()
+{
+ return new wxFontMapper;
}
-#endif // wxUSE_CMDLINE_PARSER
+#endif // wxUSE_FONTMAP
-// ----------------------------------------------------------------------------
-// debugging support
-// ----------------------------------------------------------------------------
-
-/* static */
-bool wxAppBase::CheckBuildOptions(const wxBuildOptions& opts)
-{
-#define wxCMP(what) (what == opts.m_ ## what)
-
- bool
#ifdef __WXDEBUG__
- isDebug = TRUE;
-#else
- isDebug = FALSE;
-#endif
-
- int verMaj = wxMAJOR_VERSION,
- verMin = wxMINOR_VERSION;
- if ( !(wxCMP(isDebug) && wxCMP(verMaj) && wxCMP(verMin)) )
+bool wxGUIAppTraitsBase::ShowAssertDialog(const wxString& msg)
+{
+ // under MSW we prefer to use the base class version using ::MessageBox()
+ // even if wxMessageBox() is available because it has less chances to
+ // double fault our app than our wxMessageBox()
+#if defined(__WXMSW__) || !wxUSE_MSGDLG
+ return wxAppTraitsBase::ShowAssertDialog(msg);
+#else // wxUSE_MSGDLG
+ // this message is intentionally not translated -- it is for
+ // developpers only
+ wxString msgDlg(msg);
+ msgDlg += wxT("\nDo you want to stop the program?\n")
+ wxT("You can also choose [Cancel] to suppress ")
+ wxT("further warnings.");
+
+ switch ( wxMessageBox(msgDlg, wxT("wxWindows Debug Alert"),
+ wxYES_NO | wxCANCEL | wxICON_STOP ) )
{
- wxLogFatalError(_T("Mismatch between the program and library build ")
- _T("versions detected."));
-
- // normally wxLogFatalError doesn't return
- return FALSE;
- }
-#undef wxCMP
-
- return TRUE;
-}
+ case wxYES:
+ wxTrap();
+ break;
-#ifdef __WXDEBUG__
+ case wxCANCEL:
+ // no more asserts
+ return true;
-static void LINKAGEMODE SetTraceMasks()
-{
- wxString mask;
- if ( wxGetEnv(wxT("WXTRACE"), &mask) )
- {
- wxStringTokenizer tkn(mask, wxT(","));
- while ( tkn.HasMoreTokens() )
- wxLog::AddTraceMask(tkn.GetNextToken());
+ //case wxNO: nothing to do
}
-}
-// wxASSERT() helper
-bool wxAssertIsEqual(int x, int y)
-{
- return x == y;
+ return false;
+#endif // !wxUSE_MSGDLG/wxUSE_MSGDLG
}
-// break into the debugger
-void wxTrap()
+#endif // __WXDEBUG__
+
+bool wxGUIAppTraitsBase::HasStderr()
{
-#if defined(__WXMSW__) && !defined(__WXMICROWIN__)
- DebugBreak();
-#elif defined(__WXMAC__) && !defined(__DARWIN__)
-#if __powerc
- Debugger();
+ // we consider that under Unix stderr always goes somewhere, even if the
+ // user doesn't always see it under GUI desktops
+#ifdef __UNIX__
+ return true;
#else
- SysBreak();
+ return false;
#endif
-#elif defined(__UNIX__)
- raise(SIGTRAP);
-#else
- // TODO
-#endif // Win/Unix
}
-// show the assert modal dialog
-static
-void ShowAssertDialog(const wxChar *szFile,
- int nLine,
- const wxChar *szCond,
- const wxChar *szMsg)
+void wxGUIAppTraitsBase::ScheduleForDestroy(wxObject *object)
{
- // this variable can be set to true to suppress "assert failure" messages
- static bool s_bNoAsserts = FALSE;
-
- wxChar szBuf[4096];
-
- // make life easier for people using VC++ IDE by using this format: like
- // this, clicking on the message will take us immediately to the place of
- // the failed assert
- wxSnprintf(szBuf, WXSIZEOF(szBuf),
- wxT("%s(%d): assert \"%s\" failed"),
- szFile, nLine, szCond);
-
- if ( szMsg != NULL )
- {
- wxStrcat(szBuf, wxT(": "));
- wxStrcat(szBuf, szMsg);
- }
- else // no message given
- {
- wxStrcat(szBuf, wxT("."));
- }
-
- if ( !s_bNoAsserts )
- {
- // send it to the normal log destination
- wxLogDebug(szBuf);
-
-#if (wxUSE_GUI && wxUSE_MSGDLG) || defined(__WXMSW__)
- // this message is intentionally not translated - it is for
- // developpers only
- wxStrcat(szBuf, wxT("\nDo you want to stop the program?\nYou can also choose [Cancel] to suppress further warnings."));
-
- // use the native message box if available: this is more robust than
- // using our own
-#if defined(__WXMSW__) && !defined(__WXMICROWIN__)
- switch ( ::MessageBox(NULL, szBuf, _T("Debug"),
- MB_YESNOCANCEL | MB_ICONSTOP ) )
- {
- case IDYES:
- wxTrap();
- break;
-
- case IDCANCEL:
- s_bNoAsserts = TRUE;
- break;
-
- //case IDNO: nothing to do
- }
-#else // !MSW
- switch ( wxMessageBox(szBuf, wxT("Debug"),
- wxYES_NO | wxCANCEL | wxICON_STOP ) )
- {
- case wxYES:
- wxTrap();
- break;
-
- case wxCANCEL:
- s_bNoAsserts = TRUE;
- break;
-
- //case wxNO: nothing to do
- }
-#endif // GUI or MSW
-
-#else // !GUI
- wxTrap();
-#endif // GUI/!GUI
- }
+ if ( !wxPendingDelete.Member(object) )
+ wxPendingDelete.Append(object);
}
-// this function is called when an assert fails
-void wxOnAssert(const wxChar *szFile,
- int nLine,
- const wxChar *szCond,
- const wxChar *szMsg)
+void wxGUIAppTraitsBase::RemoveFromPendingDelete(wxObject *object)
{
- // FIXME MT-unsafe
- static bool s_bInAssert = FALSE;
-
- if ( s_bInAssert )
- {
- // He-e-e-e-elp!! we're trapped in endless loop
- wxTrap();
-
- s_bInAssert = FALSE;
-
- return;
- }
-
- s_bInAssert = TRUE;
-
- if ( !wxTheApp )
- {
- // by default, show the assert dialog box - we can't customize this
- // behaviour
- ShowAssertDialog(szFile, nLine, szCond, szMsg);
- }
- else
- {
- // let the app process it as it wants
- wxTheApp->OnAssert(szFile, nLine, szCond, szMsg);
- }
-
- s_bInAssert = FALSE;
+ wxPendingDelete.DeleteObject(object);
}
-void wxAppBase::OnAssert(const wxChar *file,
- int line,
- const wxChar *cond,
- const wxChar *msg)
+// ----------------------------------------------------------------------------
+// wxAppTraits
+// ----------------------------------------------------------------------------
+
+wxAppTraits *wxAppTraitsBase::CreateGUI()
{
- ShowAssertDialog(file, line, cond, msg);
+ return new wxGUIAppTraits;
}
-#endif //WXDEBUG
-