mention that usually wxGetUserId() should be used to construct the lock name
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@16233 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
This commit is contained in:
@@ -24,7 +24,8 @@ example:
|
|||||||
\begin{verbatim}
|
\begin{verbatim}
|
||||||
bool MyApp::OnInit()
|
bool MyApp::OnInit()
|
||||||
{
|
{
|
||||||
m_checker = new wxSingleInstanceChecker(GetAppName());
|
const wxString name = wxString::Format("MyApp-%s", wxGetUserId().c_str());
|
||||||
|
m_checker = new wxSingleInstanceChecker(name);
|
||||||
if ( m_checker->IsAnotherRunning() )
|
if ( m_checker->IsAnotherRunning() )
|
||||||
{
|
{
|
||||||
wxLogError(_("Another program instance is already running, aborting."));
|
wxLogError(_("Another program instance is already running, aborting."));
|
||||||
@@ -45,8 +46,13 @@ int MyApp::OnExit()
|
|||||||
}
|
}
|
||||||
\end{verbatim}
|
\end{verbatim}
|
||||||
|
|
||||||
This class is implemented for Win32 and Unix platforms supporting {\tt fcntl()}
|
Note using \helpref{wxGetUserId()}{wxgetuserid} to construct the name: this
|
||||||
system call only.
|
allows different user to run the application concurrently which is usually the
|
||||||
|
intended goal. If you don't use the user name in the wxSingleInstanceChecker
|
||||||
|
name, only one user would be able to run the application at a time.
|
||||||
|
|
||||||
|
This class is implemented for Win32 and Unix platforms (supporting {\tt fcntl()}
|
||||||
|
system call, but almost all of modern Unix systems do) only.
|
||||||
|
|
||||||
\wxheading{Derived from}
|
\wxheading{Derived from}
|
||||||
|
|
||||||
@@ -84,7 +90,8 @@ had been used is an error.
|
|||||||
|
|
||||||
\docparam{name}{must be given and be as unique as possible. It is used as the
|
\docparam{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.
|
mutex name under Win32 and the lock file name under Unix.
|
||||||
\helpref{GetAppName()}{wxappgetappname} may be a good value for this parameter}
|
\helpref{GetAppName()}{wxappgetappname} and \helpref{wxGetUserId()}{wxgetuserid}
|
||||||
|
are commonly used to construct this parameter.}
|
||||||
|
|
||||||
\docparam{path}{is optional and is ignored under Win32 and used as the directory to
|
\docparam{path}{is optional and is ignored under Win32 and used as the directory to
|
||||||
create the lock file in under Unix (default is
|
create the lock file in under Unix (default is
|
||||||
|
Reference in New Issue
Block a user