// Author: Vadim Zeitlin
// Modified by:
// Created: 08.06.01
-// RCS-ID: $Id$
// Copyright: (c) 2001 Vadim Zeitlin <zeitlin@dptmaths.ens-cachan.fr>
// Licence: wxWindows licence
///////////////////////////////////////////////////////////////////////////////
#ifndef _WX_SNGLINST_H_
#define _WX_SNGLINST_H_
-#if defined(__GNUG__) && !defined(NO_GCC_PRAGMA)
- #pragma interface "snglinst.h"
-#endif
-
#if wxUSE_SNGLINST_CHECKER
+#include "wx/app.h"
+#include "wx/utils.h"
+
// ----------------------------------------------------------------------------
// wxSingleInstanceChecker
// ----------------------------------------------------------------------------
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())
// 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<wxSingleInstanceChecker *>(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();
// 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_BASE wxSingleInstanceCheckerImpl *m_impl;
+ class WXDLLIMPEXP_FWD_BASE wxSingleInstanceCheckerImpl *m_impl;
- DECLARE_NO_COPY_CLASS(wxSingleInstanceChecker)
+ wxDECLARE_NO_COPY_CLASS(wxSingleInstanceChecker);
};
#endif // wxUSE_SNGLINST_CHECKER