X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/22f3361e1cf25c52a2da8fdfc5cb081809e18fb9..fc4070fc9d9d79c60b9f33278047e2d8081c8b18:/include/wx/snglinst.h diff --git a/include/wx/snglinst.h b/include/wx/snglinst.h index 114b73b3d1..e62d6cfc01 100644 --- a/include/wx/snglinst.h +++ b/include/wx/snglinst.h @@ -13,17 +13,16 @@ #ifndef _WX_SNGLINST_H_ #define _WX_SNGLINST_H_ -#if defined(__GNUG__) && !defined(__APPLE__) - #pragma interface "snglinst.h" -#endif - #if wxUSE_SNGLINST_CHECKER +#include "wx/app.h" +#include "wx/utils.h" + // ---------------------------------------------------------------------------- // wxSingleInstanceChecker // ---------------------------------------------------------------------------- -class WXDLLEXPORT wxSingleInstanceChecker +class WXDLLIMPEXP_BASE wxSingleInstanceChecker { public: // default ctor, use Create() after it @@ -37,19 +36,45 @@ 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()) // - // returns FALSE if initialization failed, it doesn't mean that another + // returns false if initialization failed, it doesn't mean that another // 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(); @@ -58,10 +83,13 @@ 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 WXDLLEXPORT wxSingleInstanceCheckerImpl *m_impl; + class WXDLLIMPEXP_FWD_BASE wxSingleInstanceCheckerImpl *m_impl; - DECLARE_NO_COPY_CLASS(wxSingleInstanceChecker) + wxDECLARE_NO_COPY_CLASS(wxSingleInstanceChecker); }; #endif // wxUSE_SNGLINST_CHECKER