3f66f6a5b3
This keyword is not expanded by Git which means it's not replaced with the correct revision value in the releases made using git-based scripts and it's confusing to have lines with unexpanded "$Id$" in the released files. As expanding them with Git is not that simple (it could be done with git archive and export-subst attribute) and there are not many benefits in having them in the first place, just remove all these lines. If nothing else, this will make an eventual transition to Git simpler. Closes #14487. git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@74602 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
97 lines
3.3 KiB
C++
97 lines
3.3 KiB
C++
///////////////////////////////////////////////////////////////////////////////
|
|
// Name: wx/snglinst.h
|
|
// Purpose: wxSingleInstanceChecker can be used to restrict the number of
|
|
// simultaneously running copies of a program to one
|
|
// Author: Vadim Zeitlin
|
|
// Modified by:
|
|
// Created: 08.06.01
|
|
// Copyright: (c) 2001 Vadim Zeitlin <zeitlin@dptmaths.ens-cachan.fr>
|
|
// Licence: wxWindows licence
|
|
///////////////////////////////////////////////////////////////////////////////
|
|
|
|
#ifndef _WX_SNGLINST_H_
|
|
#define _WX_SNGLINST_H_
|
|
|
|
#if wxUSE_SNGLINST_CHECKER
|
|
|
|
#include "wx/app.h"
|
|
#include "wx/utils.h"
|
|
|
|
// ----------------------------------------------------------------------------
|
|
// wxSingleInstanceChecker
|
|
// ----------------------------------------------------------------------------
|
|
|
|
class WXDLLIMPEXP_BASE wxSingleInstanceChecker
|
|
{
|
|
public:
|
|
// default ctor, use Create() after it
|
|
wxSingleInstanceChecker() { Init(); }
|
|
|
|
// like Create() but no error checking (dangerous!)
|
|
wxSingleInstanceChecker(const wxString& name,
|
|
const wxString& path = wxEmptyString)
|
|
{
|
|
Init();
|
|
Create(name, path);
|
|
}
|
|
|
|
// 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
|
|
// 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
|
|
{
|
|
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();
|
|
|
|
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;
|
|
|
|
wxDECLARE_NO_COPY_CLASS(wxSingleInstanceChecker);
|
|
};
|
|
|
|
#endif // wxUSE_SNGLINST_CHECKER
|
|
|
|
#endif // _WX_SNGLINST_H_
|