X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/c0c133e13b36a923c65f94499554e432bc3a0daa..58ce18f2fdadecffb21e27555115af708325cf18:/include/wx/snglinst.h?ds=sidebyside diff --git a/include/wx/snglinst.h b/include/wx/snglinst.h index a8f508aefb..e62d6cfc01 100644 --- a/include/wx/snglinst.h +++ b/include/wx/snglinst.h @@ -15,6 +15,9 @@ #if wxUSE_SNGLINST_CHECKER +#include "wx/app.h" +#include "wx/utils.h" + // ---------------------------------------------------------------------------- // wxSingleInstanceChecker // ---------------------------------------------------------------------------- @@ -33,9 +36,11 @@ public: Create(name, path); } - // name must be given and be as unique as possible, it is used as the mutex - // name under Win32 and the lock file name under Unix - - // wxTheApp->GetAppName() may be a good value for this parameter + // notice that calling Create() is optional now, if you don't do it before + // calling IsAnotherRunning(), CreateDefault() is used automatically + // + // name it is used as the mutex name under Win32 and the lock file name + // under Unix so it should be as unique as possible and must be non-empty // // path is optional and is ignored under Win32 and used as the directory to // create the lock file in under Unix (default is wxGetHomeDir()) @@ -44,8 +49,32 @@ public: // instance is running - use IsAnotherRunning() to check it bool Create(const wxString& name, const wxString& path = wxEmptyString); + // use the default name, which is a combination of wxTheApp->GetAppName() + // and wxGetUserId() for mutex/lock file + // + // this is called implicitly by IsAnotherRunning() if the checker hadn't + // been created until then + bool CreateDefault() + { + wxCHECK_MSG( wxTheApp, false, "must have application instance" ); + return Create(wxTheApp->GetAppName() + '-' + wxGetUserId()); + } + // is another copy of this program already running? - bool IsAnotherRunning() const; + bool IsAnotherRunning() const + { + if ( !m_impl ) + { + if ( !const_cast(this)->CreateDefault() ) + { + // if creation failed, return false as it's better to not + // prevent this instance from starting up if there is an error + return false; + } + } + + return DoIsAnotherRunning(); + } // dtor is not virtual, this class is not meant to be used polymorphically ~wxSingleInstanceChecker(); @@ -54,6 +83,9 @@ private: // common part of all ctors void Init() { m_impl = NULL; } + // do check if another instance is running, called only if m_impl != NULL + bool DoIsAnotherRunning() const; + // the implementation details (platform specific) class WXDLLIMPEXP_FWD_BASE wxSingleInstanceCheckerImpl *m_impl;