Clément Fauconnier
3 years ago
commit
e993b146d4
@ -1,254 +0,0 @@ |
||||
INSTALLATION INSTRUCTIONS |
||||
|
||||
These instructions refer to the package you are installing as |
||||
some-package.tar.gz or some-package.zip. The .zip file is intended for use |
||||
on Windows. |
||||
|
||||
The directory you choose for the installation will be referred to as |
||||
your-install-dir. |
||||
|
||||
Note to Qt Visual Studio Integration users: In the instructions below, |
||||
instead of building from command line with nmake, you can use the menu |
||||
command 'Qt->Open Solution from .pro file' on the .pro files in the |
||||
example and plugin directories, and then build from within Visual |
||||
Studio. |
||||
|
||||
Unpacking and installation |
||||
-------------------------- |
||||
|
||||
1. Unpacking the archive (if you have not done so already). |
||||
|
||||
On Unix and Mac OS X (in a terminal window): |
||||
|
||||
cd your-install-dir |
||||
gunzip some-package.tar.gz |
||||
tar xvf some-package.tar |
||||
|
||||
This creates the subdirectory some-package containing the files. |
||||
|
||||
On Windows: |
||||
|
||||
Unpack the .zip archive by right-clicking it in explorer and |
||||
choosing "Extract All...". If your version of Windows does not |
||||
have zip support, you can use the infozip tools available |
||||
from www.info-zip.org. |
||||
|
||||
If you are using the infozip tools (in a command prompt window): |
||||
cd your-install-dir |
||||
unzip some-package.zip |
||||
|
||||
2. Configuring the package. |
||||
|
||||
The configure script is called "configure" on unix/mac and |
||||
"configure.bat" on Windows. It should be run from a command line |
||||
after cd'ing to the package directory. |
||||
|
||||
You can choose whether you want to use the component by including |
||||
its source code directly into your project, or build the component |
||||
as a dynamic shared library (DLL) that is loaded into the |
||||
application at run-time. The latter may be preferable for |
||||
technical or licensing (LGPL) reasons. If you want to build a DLL, |
||||
run the configure script with the argument "-library". Also see |
||||
the note about usage below. |
||||
|
||||
(Components that are Qt plugins, e.g. styles and image formats, |
||||
are by default built as a plugin DLL.) |
||||
|
||||
The configure script will prompt you in some cases for further |
||||
information. Answer these questions and carefully read the license text |
||||
before accepting the license conditions. The package cannot be used if |
||||
you do not accept the license conditions. |
||||
|
||||
3. Building the component and examples (when required). |
||||
|
||||
If a DLL is to be built, or if you would like to build the |
||||
examples, next give the commands |
||||
|
||||
qmake |
||||
make [or nmake if your are using Microsoft Visual C++] |
||||
|
||||
The example program(s) can be found in the directory called |
||||
"examples" or "example". |
||||
|
||||
Components that are Qt plugins, e.g. styles and image formats, are |
||||
ready to be used as soon as they are built, so the rest of this |
||||
installation instruction can be skipped. |
||||
|
||||
4. Building the Qt Designer plugin (optional). |
||||
|
||||
Some of the widget components are provided with plugins for Qt |
||||
Designer. To build and install the plugin, cd into the |
||||
some-package/plugin directory and give the commands |
||||
|
||||
qmake |
||||
make [or nmake if your are using Microsoft Visual C++] |
||||
|
||||
Restart Qt Designer to make it load the new widget plugin. |
||||
|
||||
Note: If you are using the built-in Qt Designer from the Qt Visual |
||||
Studio Integration, you will need to manually copy the plugin DLL |
||||
file, i.e. copy |
||||
%QTDIR%\plugins\designer\some-component.dll |
||||
to the Qt Visual Studio Integration plugin path, typically: |
||||
C:\Program Files\Trolltech\Qt VS Integration\plugins |
||||
|
||||
Note: If you for some reason are using a Qt Designer that is built |
||||
in debug mode, you will need to build the plugin in debug mode |
||||
also. Edit the file plugin.pro in the plugin directory, changing |
||||
'release' to 'debug' in the CONFIG line, before running qmake. |
||||
|
||||
|
||||
|
||||
Solutions components are intended to be used directly from the package |
||||
directory during development, so there is no 'make install' procedure. |
||||
|
||||
|
||||
Using a component in your project |
||||
--------------------------------- |
||||
|
||||
To use this component in your project, add the following line to the |
||||
project's .pro file (or do the equivalent in your IDE): |
||||
|
||||
include(your-install-dir/some-package/src/some-package.pri) |
||||
|
||||
This adds the package's sources and headers to the SOURCES and HEADERS |
||||
project variables respectively (or, if the component has been |
||||
configured as a DLL, it adds that library to the LIBS variable), and |
||||
updates INCLUDEPATH to contain the package's src |
||||
directory. Additionally, the .pri file may include some dependencies |
||||
needed by the package. |
||||
|
||||
To include a header file from the package in your sources, you can now |
||||
simply use: |
||||
|
||||
#include <SomeClass> |
||||
|
||||
or alternatively, in pre-Qt 4 style: |
||||
|
||||
#include <some-class.h> |
||||
|
||||
Refer to the documentation to see the classes and headers this |
||||
components provides. |
||||
|
||||
|
||||
|
||||
Install documentation (optional) |
||||
-------------------------------- |
||||
|
||||
The HTML documentation for the package's classes is located in the |
||||
your-install-dir/some-package/doc/html/index.html. You can open this |
||||
file and read the documentation with any web browser. |
||||
|
||||
To install the documentation into Qt Assistant (for Qt version 4.4 and |
||||
later): |
||||
|
||||
1. In Assistant, open the Edit->Preferences dialog and choose the |
||||
Documentation tab. Click the Add... button and select the file |
||||
your-install-dir/some-package/doc/html/some-package.qch |
||||
|
||||
For Qt versions prior to 4.4, do instead the following: |
||||
|
||||
1. The directory your-install-dir/some-package/doc/html contains a |
||||
file called some-package.dcf. Execute the following commands in a |
||||
shell, command prompt or terminal window: |
||||
|
||||
cd your-install-dir/some-package/doc/html/ |
||||
assistant -addContentFile some-package.dcf |
||||
|
||||
The next time you start Qt Assistant, you can access the package's |
||||
documentation. |
||||
|
||||
|
||||
Removing the documentation from assistant |
||||
----------------------------------------- |
||||
|
||||
If you have installed the documentation into Qt Assistant, and want to uninstall it, do as follows, for Qt version 4.4 and later: |
||||
|
||||
1. In Assistant, open the Edit->Preferences dialog and choose the |
||||
Documentation tab. In the list of Registered Documentation, select |
||||
the item com.nokia.qtsolutions.some-package_version, and click |
||||
the Remove button. |
||||
|
||||
For Qt versions prior to 4.4, do instead the following: |
||||
|
||||
1. The directory your-install-dir/some-package/doc/html contains a |
||||
file called some-package.dcf. Execute the following commands in a |
||||
shell, command prompt or terminal window: |
||||
|
||||
cd your-install-dir/some-package/doc/html/ |
||||
assistant -removeContentFile some-package.dcf |
||||
|
||||
|
||||
|
||||
Using the component as a DLL |
||||
---------------------------- |
||||
|
||||
1. Normal components |
||||
|
||||
The shared library (DLL) is built and placed in the |
||||
some-package/lib directory. It is intended to be used directly |
||||
from there during development. When appropriate, both debug and |
||||
release versions are built, since the run-time linker will in some |
||||
cases refuse to load a debug-built DLL into a release-built |
||||
application or vice versa. |
||||
|
||||
The following steps are taken by default to help the dynamic |
||||
linker to locate the DLL at run-time (during development): |
||||
|
||||
Unix: The some-package.pri file will add linker instructions to |
||||
add the some-package/lib directory to the rpath of the |
||||
executable. (When distributing, or if your system does not support |
||||
rpath, you can copy the shared library to another place that is |
||||
searched by the dynamic linker, e.g. the "lib" directory of your |
||||
Qt installation.) |
||||
|
||||
Mac: The full path to the library is hardcoded into the library |
||||
itself, from where it is copied into the executable at link time, |
||||
and ready by the dynamic linker at run-time. (When distributing, |
||||
you will want to edit these hardcoded paths in the same way as for |
||||
the Qt DLLs. Refer to the document "Deploying an Application on |
||||
Mac OS X" in the Qt Reference Documentation.) |
||||
|
||||
Windows: the .dll file(s) are copied into the "bin" directory of |
||||
your Qt installation. The Qt installation will already have set up |
||||
that directory to be searched by the dynamic linker. |
||||
|
||||
|
||||
2. Plugins |
||||
|
||||
For Qt Solutions plugins (e.g. image formats), both debug and |
||||
release versions of the plugin are built by default when |
||||
appropriate, since in some cases the release Qt library will not |
||||
load a debug plugin, and vice versa. The plugins are automatically |
||||
copied into the plugins directory of your Qt installation when |
||||
built, so no further setup is required. |
||||
|
||||
Plugins may also be built statically, i.e. as a library that will be |
||||
linked into your application executable, and so will not need to |
||||
be redistributed as a separate plugin DLL to end users. Static |
||||
building is required if Qt itself is built statically. To do it, |
||||
just add "static" to the CONFIG variable in the plugin/plugin.pro |
||||
file before building. Refer to the "Static Plugins" section in the |
||||
chapter "How to Create Qt Plugins" for explanation of how to use a |
||||
static plugin in your application. The source code of the example |
||||
program(s) will also typically contain the relevant instructions |
||||
as comments. |
||||
|
||||
|
||||
|
||||
Uninstalling |
||||
------------ |
||||
|
||||
The following command will remove any fils that have been |
||||
automatically placed outside the package directory itself during |
||||
installation and building |
||||
|
||||
make distclean [or nmake if your are using Microsoft Visual C++] |
||||
|
||||
If Qt Assistant documentation or Qt Designer plugins have been |
||||
installed, they can be uninstalled manually, ref. above. |
||||
|
||||
|
||||
Enjoy! :) |
||||
|
||||
- The Qt Solutions Team. |
||||
@ -1,33 +0,0 @@ |
||||
Qt Solutions Component: Single Application |
||||
|
||||
The QtSingleApplication component provides support for |
||||
applications that can be only started once per user. |
||||
|
||||
|
||||
|
||||
Version history: |
||||
|
||||
2.0: - Version 1.3 ported to Qt 4. |
||||
|
||||
2.1: - Fix compilation problem on Mac. |
||||
|
||||
2.2: - Really fix the Mac compilation problem. |
||||
- Mac: fix crash due to wrong object releasing. |
||||
- Mac: Fix memory leak. |
||||
|
||||
2.3: - Windows: Force creation of internal widget to make it work |
||||
with Qt 4.2. |
||||
|
||||
2.4: - Fix the system for automatic window raising on message |
||||
reception. NOTE: minor API change. |
||||
|
||||
2.5: - Mac: Fix isRunning() to work and report correctly. |
||||
|
||||
2.6: - - initialize() is now obsolete, no longer necessary to call |
||||
it |
||||
- - Fixed race condition where multiple instances migth be started |
||||
- - QtSingleCoreApplication variant provided for non-GUI (console) |
||||
usage |
||||
- Complete reimplementation. Visible changes: |
||||
- LGPL release. |
||||
|
||||
@ -1,13 +0,0 @@ |
||||
TEMPLATE=lib |
||||
CONFIG += qt dll qtsingleapplication-buildlib |
||||
mac:CONFIG += absolute_library_soname |
||||
win32|mac:!wince*:!win32-msvc:!macx-xcode:CONFIG += debug_and_release build_all |
||||
include(../src/qtsingleapplication.pri) |
||||
TARGET = $$QTSINGLEAPPLICATION_LIBNAME |
||||
DESTDIR = $$QTSINGLEAPPLICATION_LIBDIR |
||||
win32 { |
||||
DLLDESTDIR = $$[QT_INSTALL_BINS] |
||||
QMAKE_DISTCLEAN += $$[QT_INSTALL_BINS]\\$${QTSINGLEAPPLICATION_LIBNAME}.dll |
||||
} |
||||
target.path = $$DESTDIR |
||||
INSTALLS += target |
||||
@ -1,14 +0,0 @@ |
||||
exists(config.pri):infile(config.pri, SOLUTIONS_LIBRARY, yes): CONFIG += qtsingleapplication-uselib |
||||
|
||||
TEMPLATE += fakelib |
||||
greaterThan(QT_MAJOR_VERSION, 5)|\ |
||||
if(equals(QT_MAJOR_VERSION, 5):greaterThan(QT_MINOR_VERSION, 4))|\ |
||||
if(equals(QT_MAJOR_VERSION, 5):equals(QT_MINOR_VERSION, 4):greaterThan(QT_PATCH_VERSION, 1)) { |
||||
QTSINGLEAPPLICATION_LIBNAME = $$qt5LibraryTarget(QtSolutions_SingleApplication-head) |
||||
} else { |
||||
QTSINGLEAPPLICATION_LIBNAME = $$qtLibraryTarget(QtSolutions_SingleApplication-head) |
||||
} |
||||
TEMPLATE -= fakelib |
||||
|
||||
QTSINGLEAPPLICATION_LIBDIR = $$PWD/lib |
||||
unix:qtsingleapplication-uselib:!qtsingleapplication-buildlib:QMAKE_RPATHDIR += $$QTSINGLEAPPLICATION_LIBDIR |
||||
@ -1,25 +0,0 @@ |
||||
#!/bin/sh |
||||
|
||||
if [ "x$1" != "x" -a "x$1" != "x-library" ]; then |
||||
echo "Usage: $0 [-library]" |
||||
echo |
||||
echo "-library: Build the component as a dynamic library (DLL). Default is to" |
||||
echo " include the component source code directly in the application." |
||||
echo |
||||
exit 0 |
||||
fi |
||||
|
||||
rm -f config.pri |
||||
if [ "x$1" = "x-library" ]; then |
||||
echo "Configuring to build this component as a dynamic library." |
||||
echo "SOLUTIONS_LIBRARY = yes" > config.pri |
||||
fi |
||||
|
||||
echo |
||||
echo "This component is now configured." |
||||
echo |
||||
echo "To build the component library (if requested) and example(s)," |
||||
echo "run qmake and your make command." |
||||
echo |
||||
echo "To remove or reconfigure, run make distclean." |
||||
echo |
||||
@ -1,80 +0,0 @@ |
||||
::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: |
||||
:: |
||||
:: Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies). |
||||
:: Contact: http://www.qt-project.org/legal |
||||
:: |
||||
:: This file is part of the Qt Solutions component. |
||||
:: |
||||
:: $QT_BEGIN_LICENSE:BSD$ |
||||
:: You may use this file under the terms of the BSD license as follows: |
||||
:: |
||||
:: "Redistribution and use in source and binary forms, with or without |
||||
:: modification, are permitted provided that the following conditions are |
||||
:: met: |
||||
:: * Redistributions of source code must retain the above copyright |
||||
:: notice, this list of conditions and the following disclaimer. |
||||
:: * Redistributions in binary form must reproduce the above copyright |
||||
:: notice, this list of conditions and the following disclaimer in |
||||
:: the documentation and/or other materials provided with the |
||||
:: distribution. |
||||
:: * Neither the name of Digia Plc and its Subsidiary(-ies) nor the names |
||||
:: of its contributors may be used to endorse or promote products derived |
||||
:: from this software without specific prior written permission. |
||||
:: |
||||
:: |
||||
:: THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
||||
:: "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
||||
:: LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
||||
:: A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
||||
:: OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
||||
:: SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
||||
:: LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
||||
:: DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
||||
:: THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
||||
:: (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
||||
:: OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE." |
||||
:: |
||||
:: $QT_END_LICENSE$ |
||||
:: |
||||
::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: |
||||
|
||||
@echo off |
||||
|
||||
rem |
||||
rem "Main" |
||||
rem |
||||
|
||||
if not "%1"=="" ( |
||||
if not "%1"=="-library" ( |
||||
call :PrintUsage |
||||
goto EOF |
||||
) |
||||
) |
||||
|
||||
if exist config.pri. del config.pri |
||||
if "%1"=="-library" ( |
||||
echo Configuring to build this component as a dynamic library. |
||||
echo SOLUTIONS_LIBRARY = yes > config.pri |
||||
) |
||||
|
||||
echo . |
||||
echo This component is now configured. |
||||
echo . |
||||
echo To build the component library (if requested) and example(s), |
||||
echo run qmake and your make or nmake command. |
||||
echo . |
||||
echo To remove or reconfigure, run make (nmake) distclean. |
||||
echo . |
||||
goto EOF |
||||
|
||||
:PrintUsage |
||||
echo Usage: configure.bat [-library] |
||||
echo . |
||||
echo -library: Build the component as a dynamic library (DLL). Default is to |
||||
echo include the component source directly in the application. |
||||
echo A DLL may be preferable for technical or licensing (LGPL) reasons. |
||||
echo . |
||||
goto EOF |
||||
|
||||
|
||||
:EOF |
||||
@ -1,284 +0,0 @@ |
||||
BODY,H1,H2,H3,H4,H5,H6,P,CENTER,TD,TH,UL,DL,DIV { |
||||
font-family: Arial, Geneva, Helvetica, sans-serif; |
||||
} |
||||
H1 { |
||||
text-align: center; |
||||
font-size: 160%; |
||||
} |
||||
H2 { |
||||
font-size: 120%; |
||||
} |
||||
H3 { |
||||
font-size: 100%; |
||||
} |
||||
|
||||
h3.fn,span.fn |
||||
{ |
||||
background-color: #eee; |
||||
border-width: 1px; |
||||
border-style: solid; |
||||
border-color: #ddd; |
||||
font-weight: bold; |
||||
padding: 6px 0px 6px 10px; |
||||
margin: 42px 0px 0px 0px; |
||||
} |
||||
|
||||
hr { |
||||
border: 0; |
||||
color: #a0a0a0; |
||||
background-color: #ccc; |
||||
height: 1px; |
||||
width: 100%; |
||||
text-align: left; |
||||
margin: 34px 0px 34px 0px; |
||||
} |
||||
|
||||
table.valuelist { |
||||
border-width: 1px 1px 1px 1px; |
||||
border-style: solid; |
||||
border-color: #dddddd; |
||||
border-collapse: collapse; |
||||
background-color: #f0f0f0; |
||||
} |
||||
|
||||
table.indextable { |
||||
border-width: 1px 1px 1px 1px; |
||||
border-style: solid; |
||||
border-collapse: collapse; |
||||
background-color: #f0f0f0; |
||||
border-color:#555; |
||||
font-size: 100%; |
||||
} |
||||
|
||||
table td.largeindex { |
||||
border-width: 1px 1px 1px 1px; |
||||
border-collapse: collapse; |
||||
background-color: #f0f0f0; |
||||
border-color:#555; |
||||
font-size: 120%; |
||||
} |
||||
|
||||
table.valuelist th { |
||||
border-width: 1px 1px 1px 2px; |
||||
padding: 4px; |
||||
border-style: solid; |
||||
border-color: #666; |
||||
color:white; |
||||
background-color:#666; |
||||
} |
||||
|
||||
th.titleheader { |
||||
border-width: 1px 0px 1px 0px; |
||||
padding: 2px; |
||||
border-style: solid; |
||||
border-color: #666; |
||||
color:white; |
||||
background-color:#555; |
||||
background-image:url('images/gradient.png')}; |
||||
background-repeat: repeat-x; |
||||
font-size: 100%; |
||||
} |
||||
|
||||
|
||||
th.largeheader { |
||||
border-width: 1px 0px 1px 0px; |
||||
padding: 4px; |
||||
border-style: solid; |
||||
border-color: #444; |
||||
color:white; |
||||
background-color:#555555; |
||||
font-size: 120%; |
||||
} |
||||
|
||||
p { |
||||
|
||||
margin-left: 4px; |
||||
margin-top: 8px; |
||||
margin-bottom: 8px; |
||||
} |
||||
|
||||
a:link |
||||
{ |
||||
color: #0046ad; |
||||
text-decoration: none |
||||
} |
||||
|
||||
a:visited |
||||
{ |
||||
color: #672967; |
||||
text-decoration: none |
||||
} |
||||
|
||||
a.obsolete |
||||
{ |
||||
color: #661100; |
||||
text-decoration: none |
||||
} |
||||
|
||||
a.compat |
||||
{ |
||||
color: #661100; |
||||
text-decoration: none |
||||
} |
||||
|
||||
a.obsolete:visited |
||||
{ |
||||
color: #995500; |
||||
text-decoration: none |
||||
} |
||||
|
||||
a.compat:visited |
||||
{ |
||||
color: #995500; |
||||
text-decoration: none |
||||
} |
||||
|
||||
body |
||||
{ |
||||
background: #ffffff; |
||||
color: black |
||||
} |
||||
|
||||
table.generic, table.annotated |
||||
{ |
||||
border-width: 1px; |
||||
border-color:#bbb; |
||||
border-style:solid; |
||||
border-collapse:collapse; |
||||
} |
||||
|
||||
table td.memItemLeft { |
||||
width: 180px; |
||||
padding: 2px 0px 0px 8px; |
||||
margin: 4px; |
||||
border-width: 1px; |
||||
border-color: #E0E0E0; |
||||
border-style: none; |
||||
font-size: 100%; |
||||
white-space: nowrap |
||||
} |
||||
|
||||
table td.memItemRight { |
||||
padding: 2px 8px 0px 8px; |
||||
margin: 4px; |
||||
border-width: 1px; |
||||
border-color: #E0E0E0; |
||||
border-style: none; |
||||
font-size: 100%; |
||||
} |
||||
|
||||
table tr.odd { |
||||
background: #f0f0f0; |
||||
color: black; |
||||
} |
||||
|
||||
table tr.even { |
||||
background: #e4e4e4; |
||||
color: black; |
||||
} |
||||
|
||||
table.annotated th { |
||||
padding: 3px; |
||||
text-align: left |
||||
} |
||||
|
||||
table.annotated td { |
||||
padding: 3px; |
||||
} |
||||
|
||||
table tr pre |
||||
{ |
||||
padding-top: 0px; |
||||
padding-bottom: 0px; |
||||
padding-left: 0px; |
||||
padding-right: 0px; |
||||
border: none; |
||||
background: none |
||||
} |
||||
|
||||
tr.qt-style |
||||
{ |
||||
background: #96E066; |
||||
color: black |
||||
} |
||||
|
||||
body pre |
||||
{ |
||||
padding: 0.2em; |
||||
border: #e7e7e7 1px solid; |
||||
background: #f1f1f1; |
||||
color: black |
||||
} |
||||
|
||||
table tr.qt-code pre |
||||
{ |
||||
padding: 0.2em; |
||||
border: #e7e7e7 1px solid; |
||||
background: #f1f1f1; |
||||
color: black |
||||
} |
||||
|
||||
span.preprocessor, span.preprocessor a |
||||
{ |
||||
color: darkblue; |
||||
} |
||||
|
||||
span.comment |
||||
{ |
||||
color: darkred; |
||||
font-style: italic |
||||
} |
||||
|
||||
span.string,span.char |
||||
{ |
||||
color: darkgreen; |
||||
} |
||||
|
||||
.title |
||||
{ |
||||
text-align: center |
||||
} |
||||
|
||||
.subtitle |
||||
{ |
||||
font-size: 0.8em |
||||
} |
||||
|
||||
.small-subtitle |
||||
{ |
||||
font-size: 0.65em |
||||
} |
||||
|
||||
.qmlitem { |
||||
padding: 0; |
||||
} |
||||
|
||||
.qmlname { |
||||
white-space: nowrap; |
||||
} |
||||
|
||||
.qmltype { |
||||
text-align: center; |
||||
font-size: 160%; |
||||
} |
||||
|
||||
.qmlproto { |
||||
background-color: #eee; |
||||
border-width: 1px; |
||||
border-style: solid; |
||||
border-color: #ddd; |
||||
font-weight: bold; |
||||
padding: 6px 10px 6px 10px; |
||||
margin: 42px 0px 0px 0px; |
||||
} |
||||
|
||||
.qmlreadonly { |
||||
float: right; |
||||
color: red |
||||
} |
||||
|
||||
.qmldoc { |
||||
} |
||||
|
||||
*.qmlitem p { |
||||
} |
||||
|
Before Width: | Height: | Size: 4.0 KiB |
@ -1,48 +0,0 @@ |
||||
<?xml version="1.0" encoding="iso-8859-1"?> |
||||
<!DOCTYPE html |
||||
PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd"> |
||||
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> |
||||
<!-- index.qdoc --> |
||||
<head> |
||||
<title>Single Application</title> |
||||
<link href="classic.css" rel="stylesheet" type="text/css" /> |
||||
</head> |
||||
<body> |
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%"> |
||||
<tr> |
||||
<td align="left" valign="top" width="32"><img src="images/qt-logo.png" align="left" width="57" height="67" border="0" /></td> |
||||
<td width="1"> </td><td class="postheader" valign="center"><a href="index.html"><font color="#004faf">Home</font></a></td> |
||||
</tr></table><h1 class="title">Single Application<br /><span class="subtitle"></span> |
||||
</h1> |
||||
<a name="description"></a> |
||||
<h2>Description</h2> |
||||
<p>The <a href="qtsingleapplication.html">QtSingleApplication</a> component provides support for applications that can be only started once per user.</p> |
||||
<p>For some applications it is useful or even critical that they are started only once by any user. Future attempts to start the application should activate any already running instance, and possibly perform requested actions, e.g. loading a file, in that instance.</p> |
||||
<p>The <a href="qtsingleapplication.html">QtSingleApplication</a> class provides an interface to detect a running instance, and to send command strings to that instance. For console (non-GUI) applications, the <a href="qtsinglecoreapplication.html">QtSingleCoreApplication</a> variant is provided, which avoids dependency on <a href="http://qt.nokia.com/doc/4.6/qtgui.html">QtGui</a>.</p> |
||||
<a name="classes"></a> |
||||
<h2>Classes</h2> |
||||
<ul> |
||||
<li><a href="qtsingleapplication.html">QtSingleApplication</a></li> |
||||
<li><a href="qtsinglecoreapplication.html">QtSingleCoreApplication</a></li> |
||||
</ul> |
||||
<a name="examples"></a> |
||||
<h2>Examples</h2> |
||||
<ul> |
||||
<li><a href="qtsingleapplication-example-trivial.html">A Trivial Example</a></li> |
||||
<li><a href="qtsingleapplication-example-loader.html">Loading Documents</a></li> |
||||
<li><a href="qtsinglecoreapplication-example-console.html">A Non-GUI Example</a></li> |
||||
</ul> |
||||
<a name="tested-platforms"></a> |
||||
<h2>Tested platforms</h2> |
||||
<ul> |
||||
<li>Qt 4.4, 4.5 / Windows XP / MSVC.NET 2005</li> |
||||
<li>Qt 4.4, 4.5 / Linux / gcc</li> |
||||
<li>Qt 4.4, 4.5 / MacOS X 10.5 / gcc</li> |
||||
</ul> |
||||
<p /><address><hr /><div align="center"> |
||||
<table width="100%" cellspacing="0" border="0"><tr class="address"> |
||||
<td width="30%" align="left">Copyright © 2010 Nokia Corporation and/or its subsidiary(-ies)</td> |
||||
<td width="40%" align="center"><a href="http://qt.nokia.com/doc/trademarks.html">Trademarks</a></td> |
||||
<td width="30%" align="right"><div align="right">Qt Solutions</div></td> |
||||
</tr></table></div></address></body> |
||||
</html> |
||||
@ -1,175 +0,0 @@ |
||||
<?xml version="1.0" encoding="iso-8859-1"?> |
||||
<!DOCTYPE html |
||||
PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd"> |
||||
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> |
||||
<!-- loader.qdoc --> |
||||
<head> |
||||
<title>Loading Documents</title> |
||||
<link href="classic.css" rel="stylesheet" type="text/css" /> |
||||
</head> |
||||
<body> |
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%"> |
||||
<tr> |
||||
<td align="left" valign="top" width="32"><img src="images/qt-logo.png" align="left" width="57" height="67" border="0" /></td> |
||||
<td width="1"> </td><td class="postheader" valign="center"><a href="index.html"><font color="#004faf">Home</font></a></td> |
||||
</tr></table><h1 class="title">Loading Documents<br /><span class="subtitle"></span> |
||||
</h1> |
||||
<p>The application in this example loads or prints the documents passed as commandline parameters to further instances of this application.</p> |
||||
<pre><span class="comment"> /**************************************************************************** |
||||
** |
||||
** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies). |
||||
** Contact: http://www.qt-project.org/legal |
||||
** |
||||
** This file is part of the Qt Solutions component. |
||||
** |
||||
** You may use this file under the terms of the BSD license as follows: |
||||
** |
||||
** "Redistribution and use in source and binary forms, with or without |
||||
** modification, are permitted provided that the following conditions are |
||||
** met: |
||||
** * Redistributions of source code must retain the above copyright |
||||
** notice, this list of conditions and the following disclaimer. |
||||
** * Redistributions in binary form must reproduce the above copyright |
||||
** notice, this list of conditions and the following disclaimer in |
||||
** the documentation and/or other materials provided with the |
||||
** distribution. |
||||
** * Neither the name of Nokia Corporation and its Subsidiary(-ies) nor |
||||
** the names of its contributors may be used to endorse or promote |
||||
** products derived from this software without specific prior written |
||||
** permission. |
||||
** |
||||
** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
||||
** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
||||
** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
||||
** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
||||
** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
||||
** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
||||
** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
||||
** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
||||
** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
||||
** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
||||
** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE." |
||||
** |
||||
****************************************************************************/</span> |
||||
|
||||
#include <qtsingleapplication.h> |
||||
#include <QtCore/QFile> |
||||
#include <QtGui/QMainWindow> |
||||
#include <QtGui/QPrinter> |
||||
#include <QtGui/QPainter> |
||||
#include <QtGui/QTextEdit> |
||||
#include <QtGui/QMdiArea> |
||||
#include <QtCore/QTextStream> |
||||
|
||||
class MainWindow : public QMainWindow |
||||
{ |
||||
Q_OBJECT |
||||
public: |
||||
MainWindow(); |
||||
|
||||
public slots: |
||||
void handleMessage(const QString& message); |
||||
|
||||
signals: |
||||
void needToShow(); |
||||
|
||||
private: |
||||
QMdiArea *workspace; |
||||
};</pre> |
||||
<p>The user interface in this application is a <a href="http://qt.nokia.com/doc/4.6/qmainwindow.html">QMainWindow</a> subclass with a <a href="http://qt.nokia.com/doc/4.6/qmdiarea.html">QMdiArea</a> as the central widget. It implements a slot <tt>handleMessage()</tt> that will be connected to the messageReceived() signal of the <a href="qtsingleapplication.html">QtSingleApplication</a> class.</p> |
||||
<pre> MainWindow::MainWindow() |
||||
{ |
||||
workspace = new QMdiArea(this); |
||||
|
||||
setCentralWidget(workspace); |
||||
}</pre> |
||||
<p>The <a href="http://qt.nokia.com/doc/4.6/designer-to-know.html">MainWindow</a> constructor creates a minimal user interface.</p> |
||||
<pre> void MainWindow::handleMessage(const QString& message) |
||||
{ |
||||
enum Action { |
||||
Nothing, |
||||
Open, |
||||
Print |
||||
} action; |
||||
|
||||
action = Nothing; |
||||
QString filename = message; |
||||
if (message.toLower().startsWith("/print ")) { |
||||
filename = filename.mid(7); |
||||
action = Print; |
||||
} else if (!message.isEmpty()) { |
||||
action = Open; |
||||
} |
||||
if (action == Nothing) { |
||||
emit needToShow(); |
||||
return; |
||||
} |
||||
|
||||
QFile file(filename); |
||||
QString contents; |
||||
if (file.open(QIODevice::ReadOnly)) |
||||
contents = file.readAll(); |
||||
else |
||||
contents = "[[Error: Could not load file " + filename + "]]"; |
||||
|
||||
QTextEdit *view = new QTextEdit; |
||||
view->setPlainText(contents); |
||||
|
||||
switch(action) {</pre> |
||||
<p>The handleMessage() slot interprets the message passed in as a filename that can be prepended with <i>/print</i> to indicate that the file should just be printed rather than loaded.</p> |
||||
<pre> case Print: |
||||
{ |
||||
QPrinter printer; |
||||
view->print(&printer); |
||||
delete view; |
||||
} |
||||
break; |
||||
|
||||
case Open: |
||||
{ |
||||
workspace->addSubWindow(view); |
||||
view->setWindowTitle(message); |
||||
view->show(); |
||||
emit needToShow(); |
||||
} |
||||
break; |
||||
default: |
||||
break; |
||||
}; |
||||
}</pre> |
||||
<p>Loading the file will also activate the window.</p> |
||||
<pre> #include "main.moc" |
||||
|
||||
int main(int argc, char **argv) |
||||
{ |
||||
QtSingleApplication instance("File loader QtSingleApplication example", argc, argv); |
||||
QString message; |
||||
for (int a = 1; a < argc; ++a) { |
||||
message += argv[a]; |
||||
if (a < argc-1) |
||||
message += " "; |
||||
} |
||||
|
||||
if (instance.sendMessage(message)) |
||||
return 0;</pre> |
||||
<p>The <tt>main</tt> entry point function creates a <a href="qtsingleapplication.html">QtSingleApplication</a> object, and creates a message to send to a running instance of the application. If the message was sent successfully the process exits immediately.</p> |
||||
<pre> MainWindow mw; |
||||
mw.handleMessage(message); |
||||
mw.show(); |
||||
|
||||
QObject::connect(&instance, SIGNAL(messageReceived(const QString&)), |
||||
&mw, SLOT(handleMessage(const QString&))); |
||||
|
||||
instance.setActivationWindow(&mw, false); |
||||
QObject::connect(&mw, SIGNAL(needToShow()), &instance, SLOT(activateWindow())); |
||||
|
||||
return instance.exec(); |
||||
}</pre> |
||||
<p>If the message could not be sent the application starts up. Note that <tt>false</tt> is passed to the call to setActivationWindow() to prevent automatic activation for every message received, e.g. when the application should just print a file. Instead, the message handling function determines whether activation is requested, and signals that by emitting the needToShow() signal. This is then simply connected directly to <a href="qtsingleapplication.html">QtSingleApplication</a>'s activateWindow() slot.</p> |
||||
<p /><address><hr /><div align="center"> |
||||
<table width="100%" cellspacing="0" border="0"><tr class="address"> |
||||
<td width="30%" align="left">Copyright © 2010 Nokia Corporation and/or its subsidiary(-ies)</td> |
||||
<td width="40%" align="center"><a href="http://qt.nokia.com/doc/trademarks.html">Trademarks</a></td> |
||||
<td width="30%" align="right"><div align="right">Qt Solutions</div></td> |
||||
</tr></table></div></address></body> |
||||
</html> |
||||
@ -1,101 +0,0 @@ |
||||
<?xml version="1.0" encoding="iso-8859-1"?> |
||||
<!DOCTYPE html |
||||
PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd"> |
||||
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> |
||||
<!-- trivial.qdoc --> |
||||
<head> |
||||
<title>A Trivial Example</title> |
||||
<link href="classic.css" rel="stylesheet" type="text/css" /> |
||||
</head> |
||||
<body> |
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%"> |
||||
<tr> |
||||
<td align="left" valign="top" width="32"><img src="images/qt-logo.png" align="left" width="57" height="67" border="0" /></td> |
||||
<td width="1"> </td><td class="postheader" valign="center"><a href="index.html"><font color="#004faf">Home</font></a></td> |
||||
</tr></table><h1 class="title">A Trivial Example<br /><span class="subtitle"></span> |
||||
</h1> |
||||
<p>The application in this example has a log-view that displays messages sent by further instances of the same application.</p> |
||||
<p>The example demonstrates the use of the <a href="qtsingleapplication.html">QtSingleApplication</a> class to detect and communicate with a running instance of the application using the sendMessage() API. The messageReceived() signal is used to display received messages in a <a href="http://qt.nokia.com/doc/4.6/qtextedit.html">QTextEdit</a> log.</p> |
||||
<pre><span class="comment"> /**************************************************************************** |
||||
** |
||||
** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies). |
||||
** Contact: http://www.qt-project.org/legal |
||||
** |
||||
** This file is part of the Qt Solutions component. |
||||
** |
||||
** You may use this file under the terms of the BSD license as follows: |
||||
** |
||||
** "Redistribution and use in source and binary forms, with or without |
||||
** modification, are permitted provided that the following conditions are |
||||
** met: |
||||
** * Redistributions of source code must retain the above copyright |
||||
** notice, this list of conditions and the following disclaimer. |
||||
** * Redistributions in binary form must reproduce the above copyright |
||||
** notice, this list of conditions and the following disclaimer in |
||||
** the documentation and/or other materials provided with the |
||||
** distribution. |
||||
** * Neither the name of Nokia Corporation and its Subsidiary(-ies) nor |
||||
** the names of its contributors may be used to endorse or promote |
||||
** products derived from this software without specific prior written |
||||
** permission. |
||||
** |
||||
** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
||||
** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
||||
** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
||||
** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
||||
** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
||||
** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
||||
** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
||||
** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
||||
** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
||||
** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
||||
** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE." |
||||
** |
||||
****************************************************************************/</span> |
||||
|
||||
#include <qtsingleapplication.h> |
||||
#include <QtGui/QTextEdit> |
||||
|
||||
class TextEdit : public QTextEdit |
||||
{ |
||||
Q_OBJECT |
||||
public: |
||||
TextEdit(QWidget *parent = 0) |
||||
: QTextEdit(parent) |
||||
{} |
||||
public slots: |
||||
void append(const QString &str) |
||||
{ |
||||
QTextEdit::append(str); |
||||
} |
||||
}; |
||||
|
||||
#include "main.moc" |
||||
|
||||
int main(int argc, char **argv) |
||||
{ |
||||
QtSingleApplication instance(argc, argv);</pre> |
||||
<p>The example has only the <tt>main</tt> entry point function. A <a href="qtsingleapplication.html">QtSingleApplication</a> object is created immediately.</p> |
||||
<pre> if (instance.sendMessage("Wake up!")) |
||||
return 0;</pre> |
||||
<p>If another instance of this application is already running, sendMessage() will succeed, and this instance just exits immediately.</p> |
||||
<pre> TextEdit logview; |
||||
logview.setReadOnly(true); |
||||
logview.show();</pre> |
||||
<p>Otherwise the instance continues as normal and creates the user interface.</p> |
||||
<pre> instance.setActivationWindow(&logview); |
||||
|
||||
QObject::connect(&instance, SIGNAL(messageReceived(const QString&)), |
||||
&logview, SLOT(append(const QString&))); |
||||
|
||||
return instance.exec();</pre> |
||||
<p>The <tt>logview</tt> object is also set as the application's activation window. Every time a message is received, the window will be raised and activated automatically.</p> |
||||
<p>The messageReceived() signal is also connected to the <a href="http://qt.nokia.com/doc/4.6/qtextedit.html">QTextEdit</a>'s append() slot. Every message received from further instances of this application will be displayed in the log.</p> |
||||
<p>Finally the event loop is entered.</p> |
||||
<p /><address><hr /><div align="center"> |
||||
<table width="100%" cellspacing="0" border="0"><tr class="address"> |
||||
<td width="30%" align="left">Copyright © 2010 Nokia Corporation and/or its subsidiary(-ies)</td> |
||||
<td width="40%" align="center"><a href="http://qt.nokia.com/doc/trademarks.html">Trademarks</a></td> |
||||
<td width="30%" align="right"><div align="right">Qt Solutions</div></td> |
||||
</tr></table></div></address></body> |
||||
</html> |
||||
@ -1,235 +0,0 @@ |
||||
<?xml version="1.0" encoding="iso-8859-1"?> |
||||
<!DOCTYPE html |
||||
PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd"> |
||||
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> |
||||
<!-- qtsingleapplication.cpp --> |
||||
<head> |
||||
<title>List of All Members for QtSingleApplication</title> |
||||
<link href="classic.css" rel="stylesheet" type="text/css" /> |
||||
</head> |
||||
<body> |
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%"> |
||||
<tr> |
||||
<td align="left" valign="top" width="32"><img src="images/qt-logo.png" align="left" width="57" height="67" border="0" /></td> |
||||
<td width="1"> </td><td class="postheader" valign="center"><a href="index.html"><font color="#004faf">Home</font></a></td> |
||||
</tr></table><h1 class="title">List of All Members for QtSingleApplication</h1> |
||||
<p>This is the complete list of members for <a href="qtsingleapplication.html">QtSingleApplication</a>, including inherited members.</p> |
||||
<p><table class="propsummary" width="100%" border="0" cellpadding="0" cellspacing="0"> |
||||
<tr><td width="45%" valign="top"><ul> |
||||
<li><div class="fn">enum <b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#ColorSpec-enum">ColorSpec</a></b></div></li> |
||||
<li><div class="fn">enum <b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#Encoding-enum">Encoding</a></b></div></li> |
||||
<li><div class="fn">typedef <b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#EventFilter-typedef">EventFilter</a></b></div></li> |
||||
<li><div class="fn">typedef <b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#QS60MainApplicationFactory-typedef">QS60MainApplicationFactory</a></b></div></li> |
||||
<li><div class="fn">enum <b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#Type-enum">Type</a></b></div></li> |
||||
<li><div class="fn"><b><a href="qtsingleapplication.html#QtSingleApplication">QtSingleApplication</a></b> ( int &, char **, bool )</div></li> |
||||
<li><div class="fn"><b><a href="qtsingleapplication.html#QtSingleApplication-2">QtSingleApplication</a></b> ( const QString &, int &, char ** )</div></li> |
||||
<li><div class="fn"><b><a href="qtsingleapplication.html#QtSingleApplication-3">QtSingleApplication</a></b> ( int &, char **, Type )</div></li> |
||||
<li><div class="fn"><b><a href="qtsingleapplication.html#QtSingleApplication-4">QtSingleApplication</a></b> ( Display *, Qt::HANDLE, Qt::HANDLE )</div></li> |
||||
<li><div class="fn"><b><a href="qtsingleapplication.html#QtSingleApplication-5">QtSingleApplication</a></b> ( Display *, int &, char **, Qt::HANDLE, Qt::HANDLE )</div></li> |
||||
<li><div class="fn"><b><a href="qtsingleapplication.html#QtSingleApplication-6">QtSingleApplication</a></b> ( Display *, const QString &, int, char **, Qt::HANDLE, Qt::HANDLE )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#aboutQt">aboutQt</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#aboutToQuit">aboutToQuit</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="qtsingleapplication.html#activateWindow">activateWindow</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="qtsingleapplication.html#activationWindow">activationWindow</a></b> () const : QWidget *</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#activeModalWidget">activeModalWidget</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#activePopupWidget">activePopupWidget</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#activeWindow">activeWindow</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#addLibraryPath">addLibraryPath</a></b> ( const QString & )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#alert">alert</a></b> ( QWidget *, int )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#allWidgets">allWidgets</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#applicationDirPath">applicationDirPath</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#applicationFilePath">applicationFilePath</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#applicationName-prop">applicationName</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#applicationPid">applicationPid</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#applicationVersion-prop">applicationVersion</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#arguments">arguments</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#autoMaximizeThreshold-prop">autoMaximizeThreshold</a></b> () const</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#autoSipEnabled-prop">autoSipEnabled</a></b> () const</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#beep">beep</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#blockSignals">blockSignals</a></b> ( bool )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#changeOverrideCursor">changeOverrideCursor</a></b> ( const QCursor & )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#childEvent">childEvent</a></b> ( QChildEvent * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#children">children</a></b> () const</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#clipboard">clipboard</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#closeAllWindows">closeAllWindows</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#closingDown">closingDown</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#colorSpec">colorSpec</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#commitData">commitData</a></b> ( QSessionManager & )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#commitDataRequest">commitDataRequest</a></b> ( QSessionManager & )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#connect">connect</a></b> ( const QObject *, const char *, const QObject *, const char *, Qt::ConnectionType )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#connect-2">connect</a></b> ( const QObject *, const char *, const char *, Qt::ConnectionType ) const</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#connectNotify">connectNotify</a></b> ( const char * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#cursorFlashTime-prop">cursorFlashTime</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#customEvent">customEvent</a></b> ( QEvent * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#d_ptr-var">d_ptr</a></b> : </div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#deleteLater">deleteLater</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#desktop">desktop</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#desktopSettingsAware">desktopSettingsAware</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#destroyed">destroyed</a></b> ( QObject * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#disconnect">disconnect</a></b> ( const QObject *, const char *, const QObject *, const char * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#disconnect-2">disconnect</a></b> ( const char *, const QObject *, const char * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#disconnect-3">disconnect</a></b> ( const QObject *, const char * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#disconnectNotify">disconnectNotify</a></b> ( const char * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#doubleClickInterval-prop">doubleClickInterval</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#dumpObjectInfo">dumpObjectInfo</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#dumpObjectTree">dumpObjectTree</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#dynamicPropertyNames">dynamicPropertyNames</a></b> () const</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#event">event</a></b> ( QEvent * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#eventFilter">eventFilter</a></b> ( QObject *, QEvent * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#exec">exec</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#exit">exit</a></b> ( int )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#filterEvent">filterEvent</a></b> ( void *, long * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#findChild">findChild</a></b> ( const QString & ) const</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#findChildren">findChildren</a></b> ( const QString & ) const</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#findChildren-2">findChildren</a></b> ( const QRegExp & ) const</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#flush">flush</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#focusChanged">focusChanged</a></b> ( QWidget *, QWidget * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#focusWidget">focusWidget</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#font">font</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#font-2">font</a></b> ( const QWidget * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#font-3">font</a></b> ( const char * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#fontDatabaseChanged">fontDatabaseChanged</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#fontMetrics">fontMetrics</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#globalStrut-prop">globalStrut</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#hasPendingEvents">hasPendingEvents</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="qtsingleapplication.html#id">id</a></b> () const : QString</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#inherits">inherits</a></b> ( const char * ) const</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#inputContext">inputContext</a></b> () const</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#installEventFilter">installEventFilter</a></b> ( QObject * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#installTranslator">installTranslator</a></b> ( QTranslator * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#instance">instance</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#isEffectEnabled">isEffectEnabled</a></b> ( Qt::UIEffect )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#isLeftToRight">isLeftToRight</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#isRightToLeft">isRightToLeft</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="qtsingleapplication.html#isRunning">isRunning</a></b> () : bool</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#isSessionRestored">isSessionRestored</a></b> () const</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#isWidgetType">isWidgetType</a></b> () const</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#keyboardInputDirection">keyboardInputDirection</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#keyboardInputInterval-prop">keyboardInputInterval</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#keyboardInputLocale">keyboardInputLocale</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#keyboardModifiers">keyboardModifiers</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#keypadNavigationEnabled">keypadNavigationEnabled</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#killTimer">killTimer</a></b> ( int )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#lastWindowClosed">lastWindowClosed</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#layoutDirection-prop">layoutDirection</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#libraryPaths">libraryPaths</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#macEventFilter">macEventFilter</a></b> ( EventHandlerCallRef, EventRef )</div></li> |
||||
<li><div class="fn"><b><a href="qtsingleapplication.html#messageReceived">messageReceived</a></b> ( const QString & )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#metaObject">metaObject</a></b> () const</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#mouseButtons">mouseButtons</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#moveToThread">moveToThread</a></b> ( QThread * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#navigationMode">navigationMode</a></b> ()</div></li> |
||||
</ul></td><td valign="top"><ul> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#notify">notify</a></b> ( QObject *, QEvent * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#objectName-prop">objectName</a></b> () const</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#organizationDomain-prop">organizationDomain</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#organizationName-prop">organizationName</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#overrideCursor">overrideCursor</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#palette">palette</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#palette-2">palette</a></b> ( const QWidget * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#palette-3">palette</a></b> ( const char * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#parent">parent</a></b> () const</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#postEvent">postEvent</a></b> ( QObject *, QEvent * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#postEvent-2">postEvent</a></b> ( QObject *, QEvent *, int )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#processEvents">processEvents</a></b> ( QFlags<QEventLoop::ProcessEventsFlag> )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#processEvents-2">processEvents</a></b> ( QFlags<QEventLoop::ProcessEventsFlag>, int )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#property">property</a></b> ( const char * ) const</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#quit">quit</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#quitOnLastWindowClosed-prop">quitOnLastWindowClosed</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#qwsDecoration">qwsDecoration</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#qwsEventFilter">qwsEventFilter</a></b> ( QWSEvent * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#qwsSetCustomColors">qwsSetCustomColors</a></b> ( QRgb *, int, int )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#qwsSetDecoration">qwsSetDecoration</a></b> ( QDecoration * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#qwsSetDecoration-2">qwsSetDecoration</a></b> ( const QString & )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#receivers">receivers</a></b> ( const char * ) const</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#removeEventFilter">removeEventFilter</a></b> ( QObject * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#removeLibraryPath">removeLibraryPath</a></b> ( const QString & )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#removePostedEvents">removePostedEvents</a></b> ( QObject * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#removePostedEvents-2">removePostedEvents</a></b> ( QObject *, int )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#removeTranslator">removeTranslator</a></b> ( QTranslator * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#restoreOverrideCursor">restoreOverrideCursor</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#saveState">saveState</a></b> ( QSessionManager & )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#saveStateRequest">saveStateRequest</a></b> ( QSessionManager & )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#sendEvent">sendEvent</a></b> ( QObject *, QEvent * )</div></li> |
||||
<li><div class="fn"><b><a href="qtsingleapplication.html#sendMessage">sendMessage</a></b> ( const QString &, int ) : bool</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#sendPostedEvents">sendPostedEvents</a></b> ( QObject *, int )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#sendPostedEvents-2">sendPostedEvents</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#sender">sender</a></b> () const</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#sessionId">sessionId</a></b> () const</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#sessionKey">sessionKey</a></b> () const</div></li> |
||||
<li><div class="fn"><b><a href="qtsingleapplication.html#setActivationWindow">setActivationWindow</a></b> ( QWidget *, bool )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#setActiveWindow">setActiveWindow</a></b> ( QWidget * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#applicationName-prop">setApplicationName</a></b> ( const QString & )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#applicationVersion-prop">setApplicationVersion</a></b> ( const QString & )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#setAttribute">setAttribute</a></b> ( Qt::ApplicationAttribute, bool )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#autoMaximizeThreshold-prop">setAutoMaximizeThreshold</a></b> ( const int )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#autoSipEnabled-prop">setAutoSipEnabled</a></b> ( const bool )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#setColorSpec">setColorSpec</a></b> ( int )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#cursorFlashTime-prop">setCursorFlashTime</a></b> ( int )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#setDesktopSettingsAware">setDesktopSettingsAware</a></b> ( bool )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#doubleClickInterval-prop">setDoubleClickInterval</a></b> ( int )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#setEffectEnabled">setEffectEnabled</a></b> ( Qt::UIEffect, bool )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#setEventFilter">setEventFilter</a></b> ( EventFilter )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#setFont">setFont</a></b> ( const QFont &, const char * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#globalStrut-prop">setGlobalStrut</a></b> ( const QSize & )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#setGraphicsSystem">setGraphicsSystem</a></b> ( const QString & )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#setInputContext">setInputContext</a></b> ( QInputContext * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#keyboardInputInterval-prop">setKeyboardInputInterval</a></b> ( int )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#layoutDirection-prop">setLayoutDirection</a></b> ( Qt::LayoutDirection )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#setLibraryPaths">setLibraryPaths</a></b> ( const QStringList & )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#setNavigationMode">setNavigationMode</a></b> ( Qt::NavigationMode )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#objectName-prop">setObjectName</a></b> ( const QString & )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#organizationDomain-prop">setOrganizationDomain</a></b> ( const QString & )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#organizationName-prop">setOrganizationName</a></b> ( const QString & )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#setOverrideCursor">setOverrideCursor</a></b> ( const QCursor & )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#setPalette">setPalette</a></b> ( const QPalette &, const char * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#setParent">setParent</a></b> ( QObject * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#setProperty">setProperty</a></b> ( const char *, const QVariant & )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#quitOnLastWindowClosed-prop">setQuitOnLastWindowClosed</a></b> ( bool )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#startDragDistance-prop">setStartDragDistance</a></b> ( int )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#startDragTime-prop">setStartDragTime</a></b> ( int )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#setStyle">setStyle</a></b> ( QStyle * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#setStyle-2">setStyle</a></b> ( const QString & )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#styleSheet-prop">setStyleSheet</a></b> ( const QString & )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#wheelScrollLines-prop">setWheelScrollLines</a></b> ( int )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#windowIcon-prop">setWindowIcon</a></b> ( const QIcon & )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#signalsBlocked">signalsBlocked</a></b> () const</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#startDragDistance-prop">startDragDistance</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#startDragTime-prop">startDragTime</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#startTimer">startTimer</a></b> ( int )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#startingUp">startingUp</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#staticMetaObject-var">staticMetaObject</a></b> : </div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#staticQtMetaObject-var">staticQtMetaObject</a></b> : </div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#style">style</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#styleSheet-prop">styleSheet</a></b> () const</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#symbianEventFilter">symbianEventFilter</a></b> ( const QSymbianEvent * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#symbianProcessEvent">symbianProcessEvent</a></b> ( const QSymbianEvent * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#syncX">syncX</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#testAttribute">testAttribute</a></b> ( Qt::ApplicationAttribute )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#thread">thread</a></b> () const</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#timerEvent">timerEvent</a></b> ( QTimerEvent * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#topLevelAt">topLevelAt</a></b> ( const QPoint & )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#topLevelAt-2">topLevelAt</a></b> ( int, int )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#topLevelWidgets">topLevelWidgets</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#tr">tr</a></b> ( const char *, const char *, int )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#trUtf8">trUtf8</a></b> ( const char *, const char *, int )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#translate">translate</a></b> ( const char *, const char *, const char *, Encoding, int )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#translate-2">translate</a></b> ( const char *, const char *, const char *, Encoding )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#type">type</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#wheelScrollLines-prop">wheelScrollLines</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#widgetAt">widgetAt</a></b> ( const QPoint & )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#widgetAt-4">widgetAt</a></b> ( int, int )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#winEventFilter">winEventFilter</a></b> ( MSG *, long * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#windowIcon-prop">windowIcon</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#x11EventFilter">x11EventFilter</a></b> ( XEvent * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qapplication.html#x11ProcessEvent">x11ProcessEvent</a></b> ( XEvent * )</div></li> |
||||
</ul> |
||||
</td></tr> |
||||
</table></p> |
||||
<p /><address><hr /><div align="center"> |
||||
<table width="100%" cellspacing="0" border="0"><tr class="address"> |
||||
<td width="30%" align="left">Copyright © 2010 Nokia Corporation and/or its subsidiary(-ies)</td> |
||||
<td width="40%" align="center"><a href="http://qt.nokia.com/doc/trademarks.html">Trademarks</a></td> |
||||
<td width="30%" align="right"><div align="right">Qt Solutions</div></td> |
||||
</tr></table></div></address></body> |
||||
</html> |
||||
@ -1,31 +0,0 @@ |
||||
<?xml version="1.0" encoding="iso-8859-1"?> |
||||
<!DOCTYPE html |
||||
PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd"> |
||||
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> |
||||
<!-- qtsingleapplication.cpp --> |
||||
<head> |
||||
<title>Obsolete Members for QtSingleApplication</title> |
||||
<link href="classic.css" rel="stylesheet" type="text/css" /> |
||||
</head> |
||||
<body> |
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%"> |
||||
<tr> |
||||
<td align="left" valign="top" width="32"><img src="images/qt-logo.png" align="left" width="57" height="67" border="0" /></td> |
||||
<td width="1"> </td><td class="postheader" valign="center"><a href="index.html"><font color="#004faf">Home</font></a></td> |
||||
</tr></table><h1 class="title">Obsolete Members for QtSingleApplication</h1> |
||||
<p><b>The following class members are obsolete.</b> They are provided to keep old source code working. We strongly advise against using them in new code.</p> |
||||
<p><ul><li><a href="qtsingleapplication.html">QtSingleApplication class reference</a></li></ul></p> |
||||
<h2>Public Functions</h2> |
||||
<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%"> |
||||
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qtsingleapplication-obsolete.html#initialize">initialize</a></b> ( bool <i>dummy</i> = true ) <tt> (obsolete)</tt></td></tr> |
||||
</table> |
||||
<hr /> |
||||
<h2>Member Function Documentation</h2> |
||||
<h3 class="fn"><a name="initialize"></a>void QtSingleApplication::initialize ( bool <i>dummy</i> = true )</h3> |
||||
<p /><address><hr /><div align="center"> |
||||
<table width="100%" cellspacing="0" border="0"><tr class="address"> |
||||
<td width="30%" align="left">Copyright © 2010 Nokia Corporation and/or its subsidiary(-ies)</td> |
||||
<td width="40%" align="center"><a href="http://qt.nokia.com/doc/trademarks.html">Trademarks</a></td> |
||||
<td width="30%" align="right"><div align="right">Qt Solutions</div></td> |
||||
</tr></table></div></address></body> |
||||
</html> |
||||
@ -1,40 +0,0 @@ |
||||
<!DOCTYPE DCF> |
||||
<DCF ref="index.html" icon="qtsingleapplication.png" imagedir="../../gif" title="Qt Solutions: Single Application Documentation"> |
||||
<section ref="classes.html" title="Classes"> |
||||
<section ref="qtsingleapplication.html" title="QtSingleApplication Class Reference"> |
||||
<keyword ref="qtsingleapplication.html">QtSingleApplication</keyword> |
||||
<keyword ref="qtsingleapplication.html#activateWindow">activateWindow</keyword> |
||||
<keyword ref="qtsingleapplication.html#activationWindow">activationWindow</keyword> |
||||
<keyword ref="qtsingleapplication.html#id">id</keyword> |
||||
<keyword ref="qtsingleapplication.html#isRunning">isRunning</keyword> |
||||
<keyword ref="qtsingleapplication.html#messageReceived">messageReceived</keyword> |
||||
<keyword ref="qtsingleapplication.html#sendMessage">sendMessage</keyword> |
||||
<keyword ref="qtsingleapplication.html#setActivationWindow">setActivationWindow</keyword> |
||||
<section ref="qtsingleapplication-members.html" title="List of all members"/> |
||||
<section ref="qtsingleapplication-obsolete.html" title="Obsolete members"/> |
||||
</section> |
||||
<section ref="qtsinglecoreapplication.html" title="QtSingleCoreApplication Class Reference"> |
||||
<keyword ref="qtsinglecoreapplication.html">QtSingleCoreApplication</keyword> |
||||
<keyword ref="qtsinglecoreapplication.html#id">id</keyword> |
||||
<keyword ref="qtsinglecoreapplication.html#isRunning">isRunning</keyword> |
||||
<keyword ref="qtsinglecoreapplication.html#messageReceived">messageReceived</keyword> |
||||
<keyword ref="qtsinglecoreapplication.html#sendMessage">sendMessage</keyword> |
||||
<section ref="qtsinglecoreapplication-members.html" title="List of all members"/> |
||||
</section> |
||||
</section> |
||||
<section ref="overviews.html" title="Overviews"> |
||||
<section ref="qtsinglecoreapplication-example-console.html" title="A non-GUI example"> |
||||
<keyword ref="qtsinglecoreapplication-example-console.html">A non-GUI example</keyword> |
||||
</section> |
||||
<section ref="qtsingleapplication-example-trivial.html" title="A Trivial Example"> |
||||
<keyword ref="qtsingleapplication-example-trivial.html">A Trivial Example</keyword> |
||||
</section> |
||||
<section ref="qtsingleapplication-example-loader.html" title="Loading Documents"> |
||||
<keyword ref="qtsingleapplication-example-loader.html">Loading Documents</keyword> |
||||
</section> |
||||
<section ref="index.html" title="Single Application"> |
||||
<keyword ref="index.html">Single Application</keyword> |
||||
</section> |
||||
</section> |
||||
<section ref="examples.html" title="Tutorial & Examples"/> |
||||
</DCF> |
||||
@ -1,162 +0,0 @@ |
||||
<?xml version="1.0" encoding="iso-8859-1"?> |
||||
<!DOCTYPE html |
||||
PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd"> |
||||
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> |
||||
<!-- qtsingleapplication.cpp --> |
||||
<head> |
||||
<title>QtSingleApplication Class Reference</title> |
||||
<link href="classic.css" rel="stylesheet" type="text/css" /> |
||||
</head> |
||||
<body> |
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%"> |
||||
<tr> |
||||
<td align="left" valign="top" width="32"><img src="images/qt-logo.png" align="left" width="57" height="67" border="0" /></td> |
||||
<td width="1"> </td><td class="postheader" valign="center"><a href="index.html"><font color="#004faf">Home</font></a></td> |
||||
</tr></table><h1 class="title">QtSingleApplication Class Reference</h1> |
||||
<p>The QtSingleApplication class provides an API to detect and communicate with running instances of an application. <a href="#details">More...</a></p> |
||||
<pre> #include <QtSingleApplication></pre><p>Inherits <a href="http://qt.nokia.com/doc/4.6/qapplication.html">QApplication</a>.</p> |
||||
<ul> |
||||
<li><a href="qtsingleapplication-members.html">List of all members, including inherited members</a></li> |
||||
<li><a href="qtsingleapplication-obsolete.html">Obsolete members</a></li> |
||||
</ul> |
||||
<hr /> |
||||
<a name="public-functions"></a> |
||||
<h2>Public Functions</h2> |
||||
<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%"> |
||||
<tr><td class="memItemLeft" align="right" valign="top"></td><td class="memItemRight" valign="bottom"><b><a href="qtsingleapplication.html#QtSingleApplication">QtSingleApplication</a></b> ( int & <i>argc</i>, char ** <i>argv</i>, bool <i>GUIenabled</i> = true )</td></tr> |
||||
<tr><td class="memItemLeft" align="right" valign="top"></td><td class="memItemRight" valign="bottom"><b><a href="qtsingleapplication.html#QtSingleApplication-2">QtSingleApplication</a></b> ( const QString & <i>appId</i>, int & <i>argc</i>, char ** <i>argv</i> )</td></tr> |
||||
<tr><td class="memItemLeft" align="right" valign="top"></td><td class="memItemRight" valign="bottom"><b><a href="qtsingleapplication.html#QtSingleApplication-3">QtSingleApplication</a></b> ( int & <i>argc</i>, char ** <i>argv</i>, Type <i>type</i> )</td></tr> |
||||
<tr><td class="memItemLeft" align="right" valign="top"></td><td class="memItemRight" valign="bottom"><b><a href="qtsingleapplication.html#QtSingleApplication-4">QtSingleApplication</a></b> ( Display * <i>dpy</i>, Qt::HANDLE <i>visual</i> = 0, Qt::HANDLE <i>cmap</i> = 0 )</td></tr> |
||||
<tr><td class="memItemLeft" align="right" valign="top"></td><td class="memItemRight" valign="bottom"><b><a href="qtsingleapplication.html#QtSingleApplication-5">QtSingleApplication</a></b> ( Display * <i>dpy</i>, int & <i>argc</i>, char ** <i>argv</i>, Qt::HANDLE <i>visual</i> = 0, Qt::HANDLE <i>cmap</i> = 0 )</td></tr> |
||||
<tr><td class="memItemLeft" align="right" valign="top"></td><td class="memItemRight" valign="bottom"><b><a href="qtsingleapplication.html#QtSingleApplication-6">QtSingleApplication</a></b> ( Display * <i>dpy</i>, const QString & <i>appId</i>, int <i>argc</i>, char ** <i>argv</i>, Qt::HANDLE <i>visual</i> = 0, Qt::HANDLE <i>cmap</i> = 0 )</td></tr> |
||||
<tr><td class="memItemLeft" align="right" valign="top">QWidget * </td><td class="memItemRight" valign="bottom"><b><a href="qtsingleapplication.html#activationWindow">activationWindow</a></b> () const</td></tr> |
||||
<tr><td class="memItemLeft" align="right" valign="top">QString </td><td class="memItemRight" valign="bottom"><b><a href="qtsingleapplication.html#id">id</a></b> () const</td></tr> |
||||
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><b><a href="qtsingleapplication.html#isRunning">isRunning</a></b> ()</td></tr> |
||||
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qtsingleapplication.html#setActivationWindow">setActivationWindow</a></b> ( QWidget * <i>aw</i>, bool <i>activateOnMessage</i> = true )</td></tr> |
||||
</table> |
||||
<ul> |
||||
<li><div bar="2" class="fn"></div>16 public functions inherited from <a href="http://qt.nokia.com/doc/4.6/qapplication.html#public-functions">QApplication</a></li> |
||||
<li><div bar="2" class="fn"></div>4 public functions inherited from <a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#public-functions">QCoreApplication</a></li> |
||||
<li><div bar="2" class="fn"></div>29 public functions inherited from <a href="http://qt.nokia.com/doc/4.6/qobject.html#public-functions">QObject</a></li> |
||||
</ul> |
||||
<hr /> |
||||
<a name="public-slots"></a> |
||||
<h2>Public Slots</h2> |
||||
<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%"> |
||||
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qtsingleapplication.html#activateWindow">activateWindow</a></b> ()</td></tr> |
||||
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><b><a href="qtsingleapplication.html#sendMessage">sendMessage</a></b> ( const QString & <i>message</i>, int <i>timeout</i> = 5000 )</td></tr> |
||||
</table> |
||||
<ul> |
||||
<li><div bar="2" class="fn"></div>7 public slots inherited from <a href="http://qt.nokia.com/doc/4.6/qapplication.html#public-slots">QApplication</a></li> |
||||
<li><div bar="2" class="fn"></div>1 public slot inherited from <a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#public-slots">QCoreApplication</a></li> |
||||
<li><div bar="2" class="fn"></div>1 public slot inherited from <a href="http://qt.nokia.com/doc/4.6/qobject.html#public-slots">QObject</a></li> |
||||
</ul> |
||||
<hr /> |
||||
<a name="signals"></a> |
||||
<h2>Signals</h2> |
||||
<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%"> |
||||
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qtsingleapplication.html#messageReceived">messageReceived</a></b> ( const QString & <i>message</i> )</td></tr> |
||||
</table> |
||||
<ul> |
||||
<li><div bar="2" class="fn"></div>5 signals inherited from <a href="http://qt.nokia.com/doc/4.6/qapplication.html#signals">QApplication</a></li> |
||||
<li><div bar="2" class="fn"></div>1 signal inherited from <a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#signals">QCoreApplication</a></li> |
||||
<li><div bar="2" class="fn"></div>1 signal inherited from <a href="http://qt.nokia.com/doc/4.6/qobject.html#signals">QObject</a></li> |
||||
</ul> |
||||
<h3>Additional Inherited Members</h3> |
||||
<ul> |
||||
<li><div class="fn"></div>13 properties inherited from <a href="http://qt.nokia.com/doc/4.6/qapplication.html#properties">QApplication</a></li> |
||||
<li><div class="fn"></div>4 properties inherited from <a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#properties">QCoreApplication</a></li> |
||||
<li><div class="fn"></div>1 property inherited from <a href="http://qt.nokia.com/doc/4.6/qobject.html#properties">QObject</a></li> |
||||
<li><div class="fn"></div>1 public type inherited from <a href="http://qt.nokia.com/doc/4.6/qobject.html#public-variables">QObject</a></li> |
||||
<li><div class="fn"></div>73 static public members inherited from <a href="http://qt.nokia.com/doc/4.6/qapplication.html#static-public-members">QApplication</a></li> |
||||
<li><div class="fn"></div>38 static public members inherited from <a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#static-public-members">QCoreApplication</a></li> |
||||
<li><div class="fn"></div>4 static public members inherited from <a href="http://qt.nokia.com/doc/4.6/qobject.html#static-public-members">QObject</a></li> |
||||
<li><div class="fn"></div>1 protected function inherited from <a href="http://qt.nokia.com/doc/4.6/qapplication.html#protected-functions">QApplication</a></li> |
||||
<li><div class="fn"></div>1 protected function inherited from <a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#protected-functions">QCoreApplication</a></li> |
||||
<li><div class="fn"></div>7 protected functions inherited from <a href="http://qt.nokia.com/doc/4.6/qobject.html#protected-functions">QObject</a></li> |
||||
<li><div class="fn"></div>2 protected variables inherited from <a href="http://qt.nokia.com/doc/4.6/qobject.html#protected-variables">QObject</a></li> |
||||
</ul> |
||||
<a name="details"></a> |
||||
<hr /> |
||||
<h2>Detailed Description</h2> |
||||
<p>The QtSingleApplication class provides an API to detect and communicate with running instances of an application.</p> |
||||
<p>This class allows you to create applications where only one instance should be running at a time. I.e., if the user tries to launch another instance, the already running instance will be activated instead. Another usecase is a client-server system, where the first started instance will assume the role of server, and the later instances will act as clients of that server.</p> |
||||
<p>By default, the full path of the executable file is used to determine whether two processes are instances of the same application. You can also provide an explicit identifier string that will be compared instead.</p> |
||||
<p>The application should create the QtSingleApplication object early in the startup phase, and call <a href="qtsingleapplication.html#isRunning">isRunning</a>() to find out if another instance of this application is already running. If <a href="qtsingleapplication.html#isRunning">isRunning</a>() returns false, it means that no other instance is running, and this instance has assumed the role as the running instance. In this case, the application should continue with the initialization of the application user interface before entering the event loop with <a href="http://qt.nokia.com/doc/4.6/qapplication.html#exec">exec</a>(), as normal.</p> |
||||
<p>The <a href="qtsingleapplication.html#messageReceived">messageReceived</a>() signal will be emitted when the running application receives messages from another instance of the same application. When a message is received it might be helpful to the user to raise the application so that it becomes visible. To facilitate this, QtSingleApplication provides the <a href="qtsingleapplication.html#setActivationWindow">setActivationWindow</a>() function and the <a href="qtsingleapplication.html#activateWindow">activateWindow</a>() slot.</p> |
||||
<p>If <a href="qtsingleapplication.html#isRunning">isRunning</a>() returns true, another instance is already running. It may be alerted to the fact that another instance has started by using the <a href="qtsingleapplication.html#sendMessage">sendMessage</a>() function. Also data such as startup parameters (e.g. the name of the file the user wanted this new instance to open) can be passed to the running instance with this function. Then, the application should terminate (or enter client mode).</p> |
||||
<p>If <a href="qtsingleapplication.html#isRunning">isRunning</a>() returns true, but <a href="qtsingleapplication.html#sendMessage">sendMessage</a>() fails, that is an indication that the running instance is frozen.</p> |
||||
<p>Here's an example that shows how to convert an existing application to use QtSingleApplication. It is very simple and does not make use of all QtSingleApplication's functionality (see the examples for that).</p> |
||||
<pre><span class="comment"> // Original</span> |
||||
int main(int argc, char **argv) |
||||
{ |
||||
QApplication app(argc, argv); |
||||
|
||||
MyMainWidget mmw; |
||||
mmw.show(); |
||||
return app.exec(); |
||||
} |
||||
|
||||
<span class="comment"> // Single instance</span> |
||||
int main(int argc, char **argv) |
||||
{ |
||||
QtSingleApplication app(argc, argv); |
||||
|
||||
if (app.isRunning()) |
||||
return !app.sendMessage(someDataString); |
||||
|
||||
MyMainWidget mmw; |
||||
app.setActivationWindow(&mmw); |
||||
mmw.show(); |
||||
return app.exec(); |
||||
}</pre> |
||||
<p>Once this QtSingleApplication instance is destroyed (normally when the process exits or crashes), when the user next attempts to run the application this instance will not, of course, be encountered. The next instance to call <a href="qtsingleapplication.html#isRunning">isRunning</a>() or <a href="qtsingleapplication.html#sendMessage">sendMessage</a>() will assume the role as the new running instance.</p> |
||||
<p>For console (non-GUI) applications, <a href="qtsinglecoreapplication.html">QtSingleCoreApplication</a> may be used instead of this class, to avoid the dependency on the <a href="http://qt.nokia.com/doc/4.6/qtgui.html">QtGui</a> library.</p> |
||||
<p>See also <a href="qtsinglecoreapplication.html">QtSingleCoreApplication</a>.</p> |
||||
<hr /> |
||||
<h2>Member Function Documentation</h2> |
||||
<h3 class="fn"><a name="QtSingleApplication"></a>QtSingleApplication::QtSingleApplication ( int & <i>argc</i>, char ** <i>argv</i>, bool <i>GUIenabled</i> = true )</h3> |
||||
<p>Creates a <a href="qtsingleapplication.html">QtSingleApplication</a> object. The application identifier will be <a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#applicationFilePath">QCoreApplication::applicationFilePath</a>(). <i>argc</i>, <i>argv</i>, and <i>GUIenabled</i> are passed on to the QAppliation constructor.</p> |
||||
<p>If you are creating a console application (i.e. setting <i>GUIenabled</i> to false), you may consider using <a href="qtsinglecoreapplication.html">QtSingleCoreApplication</a> instead.</p> |
||||
<h3 class="fn"><a name="QtSingleApplication-2"></a>QtSingleApplication::QtSingleApplication ( const <a href="http://qt.nokia.com/doc/4.6/qstring.html">QString</a> & <i>appId</i>, int & <i>argc</i>, char ** <i>argv</i> )</h3> |
||||
<p>Creates a <a href="qtsingleapplication.html">QtSingleApplication</a> object with the application identifier <i>appId</i>. <i>argc</i> and <i>argv</i> are passed on to the QAppliation constructor.</p> |
||||
<h3 class="fn"><a name="QtSingleApplication-3"></a>QtSingleApplication::QtSingleApplication ( int & <i>argc</i>, char ** <i>argv</i>, <a href="http://qt.nokia.com/doc/4.6/qapplication.html#Type-enum">Type</a> <i>type</i> )</h3> |
||||
<p>Creates a <a href="qtsingleapplication.html">QtSingleApplication</a> object. The application identifier will be <a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#applicationFilePath">QCoreApplication::applicationFilePath</a>(). <i>argc</i>, <i>argv</i>, and <i>type</i> are passed on to the QAppliation constructor.</p> |
||||
<h3 class="fn"><a name="QtSingleApplication-4"></a>QtSingleApplication::QtSingleApplication ( Display * <i>dpy</i>, <a href="http://qt.nokia.com/doc/4.6/qt.html#HANDLE-typedef">Qt::HANDLE</a> <i>visual</i> = 0, <a href="http://qt.nokia.com/doc/4.6/qt.html#HANDLE-typedef">Qt::HANDLE</a> <i>cmap</i> = 0 )</h3> |
||||
<p>Special constructor for X11, ref. the documentation of <a href="http://qt.nokia.com/doc/4.6/qapplication.html">QApplication</a>'s corresponding constructor. The application identifier will be <a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#applicationFilePath">QCoreApplication::applicationFilePath</a>(). <i>dpy</i>, <i>visual</i>, and <i>cmap</i> are passed on to the <a href="http://qt.nokia.com/doc/4.6/qapplication.html">QApplication</a> constructor.</p> |
||||
<h3 class="fn"><a name="QtSingleApplication-5"></a>QtSingleApplication::QtSingleApplication ( Display * <i>dpy</i>, int & <i>argc</i>, char ** <i>argv</i>, <a href="http://qt.nokia.com/doc/4.6/qt.html#HANDLE-typedef">Qt::HANDLE</a> <i>visual</i> = 0, <a href="http://qt.nokia.com/doc/4.6/qt.html#HANDLE-typedef">Qt::HANDLE</a> <i>cmap</i> = 0 )</h3> |
||||
<p>Special constructor for X11, ref. the documentation of <a href="http://qt.nokia.com/doc/4.6/qapplication.html">QApplication</a>'s corresponding constructor. The application identifier will be <a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#applicationFilePath">QCoreApplication::applicationFilePath</a>(). <i>dpy</i>, <i>argc</i>, <i>argv</i>, <i>visual</i>, and <i>cmap</i> are passed on to the <a href="http://qt.nokia.com/doc/4.6/qapplication.html">QApplication</a> constructor.</p> |
||||
<h3 class="fn"><a name="QtSingleApplication-6"></a>QtSingleApplication::QtSingleApplication ( Display * <i>dpy</i>, const <a href="http://qt.nokia.com/doc/4.6/qstring.html">QString</a> & <i>appId</i>, int <i>argc</i>, char ** <i>argv</i>, <a href="http://qt.nokia.com/doc/4.6/qt.html#HANDLE-typedef">Qt::HANDLE</a> <i>visual</i> = 0, <a href="http://qt.nokia.com/doc/4.6/qt.html#HANDLE-typedef">Qt::HANDLE</a> <i>cmap</i> = 0 )</h3> |
||||
<p>Special constructor for X11, ref. the documentation of <a href="http://qt.nokia.com/doc/4.6/qapplication.html">QApplication</a>'s corresponding constructor. The application identifier will be <i>appId</i>. <i>dpy</i>, <i>argc</i>, <i>argv</i>, <i>visual</i>, and <i>cmap</i> are passed on to the <a href="http://qt.nokia.com/doc/4.6/qapplication.html">QApplication</a> constructor.</p> |
||||
<h3 class="fn"><a name="activateWindow"></a>void QtSingleApplication::activateWindow () <tt> [slot]</tt></h3> |
||||
<p>De-minimizes, raises, and activates this application's activation window. This function does nothing if no activation window has been set.</p> |
||||
<p>This is a convenience function to show the user that this application instance has been activated when he has tried to start another instance.</p> |
||||
<p>This function should typically be called in response to the <a href="qtsingleapplication.html#messageReceived">messageReceived</a>() signal. By default, that will happen automatically, if an activation window has been set.</p> |
||||
<p>See also <a href="qtsingleapplication.html#setActivationWindow">setActivationWindow</a>(), <a href="qtsingleapplication.html#messageReceived">messageReceived</a>(), and <a href="qtsingleapplication-obsolete.html#initialize" class="obsolete">initialize</a>().</p> |
||||
<h3 class="fn"><a name="activationWindow"></a><a href="http://qt.nokia.com/doc/4.6/qwidget.html">QWidget</a> * QtSingleApplication::activationWindow () const</h3> |
||||
<p>Returns the applications activation window if one has been set by calling <a href="qtsingleapplication.html#setActivationWindow">setActivationWindow</a>(), otherwise returns 0.</p> |
||||
<p>See also <a href="qtsingleapplication.html#setActivationWindow">setActivationWindow</a>().</p> |
||||
<h3 class="fn"><a name="id"></a><a href="http://qt.nokia.com/doc/4.6/qstring.html">QString</a> QtSingleApplication::id () const</h3> |
||||
<p>Returns the application identifier. Two processes with the same identifier will be regarded as instances of the same application.</p> |
||||
<h3 class="fn"><a name="isRunning"></a>bool QtSingleApplication::isRunning ()</h3> |
||||
<p>Returns true if another instance of this application is running; otherwise false.</p> |
||||
<p>This function does not find instances of this application that are being run by a different user (on Windows: that are running in another session).</p> |
||||
<p>See also <a href="qtsingleapplication.html#sendMessage">sendMessage</a>().</p> |
||||
<h3 class="fn"><a name="messageReceived"></a>void QtSingleApplication::messageReceived ( const <a href="http://qt.nokia.com/doc/4.6/qstring.html">QString</a> & <i>message</i> ) <tt> [signal]</tt></h3> |
||||
<p>This signal is emitted when the current instance receives a <i>message</i> from another instance of this application.</p> |
||||
<p>See also <a href="qtsingleapplication.html#sendMessage">sendMessage</a>(), <a href="qtsingleapplication.html#setActivationWindow">setActivationWindow</a>(), and <a href="qtsingleapplication.html#activateWindow">activateWindow</a>().</p> |
||||
<h3 class="fn"><a name="sendMessage"></a>bool QtSingleApplication::sendMessage ( const <a href="http://qt.nokia.com/doc/4.6/qstring.html">QString</a> & <i>message</i>, int <i>timeout</i> = 5000 ) <tt> [slot]</tt></h3> |
||||
<p>Tries to send the text <i>message</i> to the currently running instance. The <a href="qtsingleapplication.html">QtSingleApplication</a> object in the running instance will emit the <a href="qtsingleapplication.html#messageReceived">messageReceived</a>() signal when it receives the message.</p> |
||||
<p>This function returns true if the message has been sent to, and processed by, the current instance. If there is no instance currently running, or if the running instance fails to process the message within <i>timeout</i> milliseconds, this function return false.</p> |
||||
<p>See also <a href="qtsingleapplication.html#isRunning">isRunning</a>() and <a href="qtsingleapplication.html#messageReceived">messageReceived</a>().</p> |
||||
<h3 class="fn"><a name="setActivationWindow"></a>void QtSingleApplication::setActivationWindow ( <a href="http://qt.nokia.com/doc/4.6/qwidget.html">QWidget</a> * <i>aw</i>, bool <i>activateOnMessage</i> = true )</h3> |
||||
<p>Sets the activation window of this application to <i>aw</i>. The activation window is the widget that will be activated by <a href="qtsingleapplication.html#activateWindow">activateWindow</a>(). This is typically the application's main window.</p> |
||||
<p>If <i>activateOnMessage</i> is true (the default), the window will be activated automatically every time a message is received, just prior to the <a href="qtsingleapplication.html#messageReceived">messageReceived</a>() signal being emitted.</p> |
||||
<p>See also <a href="qtsingleapplication.html#activationWindow">activationWindow</a>(), <a href="qtsingleapplication.html#activateWindow">activateWindow</a>(), and <a href="qtsingleapplication.html#messageReceived">messageReceived</a>().</p> |
||||
<p /><address><hr /><div align="center"> |
||||
<table width="100%" cellspacing="0" border="0"><tr class="address"> |
||||
<td width="30%" align="left">Copyright © 2010 Nokia Corporation and/or its subsidiary(-ies)</td> |
||||
<td width="40%" align="center"><a href="http://qt.nokia.com/doc/trademarks.html">Trademarks</a></td> |
||||
<td width="30%" align="right"><div align="right">Qt Solutions</div></td> |
||||
</tr></table></div></address></body> |
||||
</html> |
||||
@ -1,90 +0,0 @@ |
||||
<?xml version="1.0" encoding="UTF-8"?> |
||||
<!DOCTYPE QDOCINDEX> |
||||
<INDEX url="" title="Qt Solutions: Single Application Documentation" version=""> |
||||
<namespace access="public" threadsafety="unspecified" status="commendable" name="" href="" location="" module=""> |
||||
<class access="public" threadsafety="unspecified" status="commendable" name="QtSingleCoreApplication" href="qtsinglecoreapplication.html" location="qtsinglecoreapplication.h" bases="QCoreApplication" module=""> |
||||
<function access="public" threadsafety="unspecified" status="commendable" name="QtSingleCoreApplication" fullname="QtSingleCoreApplication::QtSingleCoreApplication" href="qtsinglecoreapplication.html#QtSingleCoreApplication" location="qtsinglecoreapplication.h" virtual="non" meta="constructor" const="false" static="false" overload="false" type="" signature="QtSingleCoreApplication(int & argc, char ** argv)"> |
||||
<parameter left="int &" right="" name="argc" default=""/> |
||||
<parameter left="char **" right="" name="argv" default=""/> |
||||
</function> |
||||
<function access="public" threadsafety="unspecified" status="commendable" name="QtSingleCoreApplication" fullname="QtSingleCoreApplication::QtSingleCoreApplication" href="qtsinglecoreapplication.html#QtSingleCoreApplication-2" location="qtsinglecoreapplication.h" virtual="non" meta="constructor" const="false" static="false" overload="true" overload-number="2" type="" signature="QtSingleCoreApplication(const QString & appId, int & argc, char ** argv)"> |
||||
<parameter left="const QString &" right="" name="appId" default=""/> |
||||
<parameter left="int &" right="" name="argc" default=""/> |
||||
<parameter left="char **" right="" name="argv" default=""/> |
||||
</function> |
||||
<function access="public" threadsafety="unspecified" status="commendable" name="isRunning" fullname="QtSingleCoreApplication::isRunning" href="qtsinglecoreapplication.html#isRunning" location="qtsinglecoreapplication.h" virtual="non" meta="plain" const="false" static="false" overload="false" type="bool" signature="isRunning()"/> |
||||
<function access="public" threadsafety="unspecified" status="commendable" name="id" fullname="QtSingleCoreApplication::id" href="qtsinglecoreapplication.html#id" location="qtsinglecoreapplication.h" virtual="non" meta="plain" const="true" static="false" overload="false" type="QString" signature="id() const"/> |
||||
<function access="public" threadsafety="unspecified" status="commendable" name="sendMessage" fullname="QtSingleCoreApplication::sendMessage" href="qtsinglecoreapplication.html#sendMessage" location="qtsinglecoreapplication.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="bool" signature="sendMessage(const QString & message, int timeout)"> |
||||
<parameter left="const QString &" right="" name="message" default=""/> |
||||
<parameter left="int" right="" name="timeout" default="5000"/> |
||||
</function> |
||||
<function access="public" threadsafety="unspecified" status="commendable" name="messageReceived" fullname="QtSingleCoreApplication::messageReceived" href="qtsinglecoreapplication.html#messageReceived" location="qtsinglecoreapplication.h" virtual="non" meta="signal" const="false" static="false" overload="false" type="void" signature="messageReceived(const QString & message)"> |
||||
<parameter left="const QString &" right="" name="message" default=""/> |
||||
</function> |
||||
</class> |
||||
<class access="public" threadsafety="unspecified" status="commendable" name="QtSingleApplication" href="qtsingleapplication.html" location="qtsingleapplication.h" bases="QApplication" module=""> |
||||
<function access="public" threadsafety="unspecified" status="commendable" name="QtSingleApplication" fullname="QtSingleApplication::QtSingleApplication" href="qtsingleapplication.html#QtSingleApplication" location="qtsingleapplication.h" virtual="non" meta="constructor" const="false" static="false" overload="false" type="" signature="QtSingleApplication(int & argc, char ** argv, bool GUIenabled)"> |
||||
<parameter left="int &" right="" name="argc" default=""/> |
||||
<parameter left="char **" right="" name="argv" default=""/> |
||||
<parameter left="bool" right="" name="GUIenabled" default="true"/> |
||||
</function> |
||||
<function access="public" threadsafety="unspecified" status="commendable" name="QtSingleApplication" fullname="QtSingleApplication::QtSingleApplication" href="qtsingleapplication.html#QtSingleApplication-2" location="qtsingleapplication.h" virtual="non" meta="constructor" const="false" static="false" overload="true" overload-number="2" type="" signature="QtSingleApplication(const QString & appId, int & argc, char ** argv)"> |
||||
<parameter left="const QString &" right="" name="appId" default=""/> |
||||
<parameter left="int &" right="" name="argc" default=""/> |
||||
<parameter left="char **" right="" name="argv" default=""/> |
||||
</function> |
||||
<function access="public" threadsafety="unspecified" status="commendable" name="QtSingleApplication" fullname="QtSingleApplication::QtSingleApplication" href="qtsingleapplication.html#QtSingleApplication-3" location="qtsingleapplication.h" virtual="non" meta="constructor" const="false" static="false" overload="true" overload-number="3" type="" signature="QtSingleApplication(int & argc, char ** argv, Type type)"> |
||||
<parameter left="int &" right="" name="argc" default=""/> |
||||
<parameter left="char **" right="" name="argv" default=""/> |
||||
<parameter left="Type" right="" name="type" default=""/> |
||||
</function> |
||||
<function access="public" threadsafety="unspecified" status="commendable" name="QtSingleApplication" fullname="QtSingleApplication::QtSingleApplication" href="qtsingleapplication.html#QtSingleApplication-4" location="qtsingleapplication.h" virtual="non" meta="constructor" const="false" static="false" overload="true" overload-number="4" type="" signature="QtSingleApplication(Display * dpy, Qt::HANDLE visual, Qt::HANDLE cmap)"> |
||||
<parameter left="Display *" right="" name="dpy" default=""/> |
||||
<parameter left="Qt::HANDLE" right="" name="visual" default="0"/> |
||||
<parameter left="Qt::HANDLE" right="" name="cmap" default="0"/> |
||||
</function> |
||||
<function access="public" threadsafety="unspecified" status="commendable" name="QtSingleApplication" fullname="QtSingleApplication::QtSingleApplication" href="qtsingleapplication.html#QtSingleApplication-5" location="qtsingleapplication.h" virtual="non" meta="constructor" const="false" static="false" overload="true" overload-number="5" type="" signature="QtSingleApplication(Display * dpy, int & argc, char ** argv, Qt::HANDLE visual, Qt::HANDLE cmap)"> |
||||
<parameter left="Display *" right="" name="dpy" default=""/> |
||||
<parameter left="int &" right="" name="argc" default=""/> |
||||
<parameter left="char **" right="" name="argv" default=""/> |
||||
<parameter left="Qt::HANDLE" right="" name="visual" default="0"/> |
||||
<parameter left="Qt::HANDLE" right="" name="cmap" default="0"/> |
||||
</function> |
||||
<function access="public" threadsafety="unspecified" status="commendable" name="QtSingleApplication" fullname="QtSingleApplication::QtSingleApplication" href="qtsingleapplication.html#QtSingleApplication-6" location="qtsingleapplication.h" virtual="non" meta="constructor" const="false" static="false" overload="true" overload-number="6" type="" signature="QtSingleApplication(Display * dpy, const QString & appId, int argc, char ** argv, Qt::HANDLE visual, Qt::HANDLE cmap)"> |
||||
<parameter left="Display *" right="" name="dpy" default=""/> |
||||
<parameter left="const QString &" right="" name="appId" default=""/> |
||||
<parameter left="int" right="" name="argc" default=""/> |
||||
<parameter left="char **" right="" name="argv" default=""/> |
||||
<parameter left="Qt::HANDLE" right="" name="visual" default="0"/> |
||||
<parameter left="Qt::HANDLE" right="" name="cmap" default="0"/> |
||||
</function> |
||||
<function access="public" threadsafety="unspecified" status="commendable" name="isRunning" fullname="QtSingleApplication::isRunning" href="qtsingleapplication.html#isRunning" location="qtsingleapplication.h" virtual="non" meta="plain" const="false" static="false" overload="false" type="bool" signature="isRunning()"/> |
||||
<function access="public" threadsafety="unspecified" status="commendable" name="id" fullname="QtSingleApplication::id" href="qtsingleapplication.html#id" location="qtsingleapplication.h" virtual="non" meta="plain" const="true" static="false" overload="false" type="QString" signature="id() const"/> |
||||
<function access="public" threadsafety="unspecified" status="commendable" name="setActivationWindow" fullname="QtSingleApplication::setActivationWindow" href="qtsingleapplication.html#setActivationWindow" location="qtsingleapplication.h" virtual="non" meta="plain" const="false" static="false" overload="false" type="void" signature="setActivationWindow(QWidget * aw, bool activateOnMessage)"> |
||||
<parameter left="QWidget *" right="" name="aw" default=""/> |
||||
<parameter left="bool" right="" name="activateOnMessage" default="true"/> |
||||
</function> |
||||
<function access="public" threadsafety="unspecified" status="commendable" name="activationWindow" fullname="QtSingleApplication::activationWindow" href="qtsingleapplication.html#activationWindow" location="qtsingleapplication.h" virtual="non" meta="plain" const="true" static="false" overload="false" type="QWidget *" signature="activationWindow() const"/> |
||||
<function access="public" threadsafety="unspecified" status="obsolete" name="initialize" fullname="QtSingleApplication::initialize" href="qtsingleapplication-obsolete.html#initialize" location="qtsingleapplication.h" virtual="non" meta="plain" const="false" static="false" overload="false" type="void" signature="initialize(bool dummy)"> |
||||
<parameter left="bool" right="" name="dummy" default="true"/> |
||||
</function> |
||||
<function access="public" threadsafety="unspecified" status="commendable" name="sendMessage" fullname="QtSingleApplication::sendMessage" href="qtsingleapplication.html#sendMessage" location="qtsingleapplication.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="bool" signature="sendMessage(const QString & message, int timeout)"> |
||||
<parameter left="const QString &" right="" name="message" default=""/> |
||||
<parameter left="int" right="" name="timeout" default="5000"/> |
||||
</function> |
||||
<function access="public" threadsafety="unspecified" status="commendable" name="activateWindow" fullname="QtSingleApplication::activateWindow" href="qtsingleapplication.html#activateWindow" location="qtsingleapplication.h" virtual="non" meta="slot" const="false" static="false" overload="false" type="void" signature="activateWindow()"/> |
||||
<function access="public" threadsafety="unspecified" status="commendable" name="messageReceived" fullname="QtSingleApplication::messageReceived" href="qtsingleapplication.html#messageReceived" location="qtsingleapplication.h" virtual="non" meta="signal" const="false" static="false" overload="false" type="void" signature="messageReceived(const QString & message)"> |
||||
<parameter left="const QString &" right="" name="message" default=""/> |
||||
</function> |
||||
</class> |
||||
<page access="public" status="commendable" name="index.html" href="index.html" subtype="page" title="Single Application" fulltitle="Single Application" subtitle="" location="index.qdoc"> |
||||
<contents name="description" title="Description" level="1"/> |
||||
<contents name="classes" title="Classes" level="1"/> |
||||
<contents name="examples" title="Examples" level="1"/> |
||||
<contents name="tested-platforms" title="Tested platforms" level="1"/> |
||||
</page> |
||||
<page access="public" status="commendable" name="qtsingleapplication-example-trivial.html" href="qtsingleapplication-example-trivial.html" subtype="page" title="A Trivial Example" fulltitle="A Trivial Example" subtitle="" location="trivial.qdoc"/> |
||||
<page access="public" status="commendable" name="qtsinglecoreapplication-example-console.html" href="qtsinglecoreapplication-example-console.html" subtype="page" title="A non-GUI example" fulltitle="A non-GUI example" subtitle="" location="console.qdoc"/> |
||||
<page access="public" status="commendable" name="qtsingleapplication-example-loader.html" href="qtsingleapplication-example-loader.html" subtype="page" title="Loading Documents" fulltitle="Loading Documents" subtitle="" location="loader.qdoc"/> |
||||
</namespace> |
||||
</INDEX> |
||||
@ -1,53 +0,0 @@ |
||||
<?xml version="1.0" encoding="UTF-8"?> |
||||
<QtHelpProject version="1.0"> |
||||
<namespace>com.nokia.qtsolutions.qtsingleapplication_head</namespace> |
||||
<virtualFolder>qdoc</virtualFolder> |
||||
<customFilter name="Qt Solutions: Single Application"> |
||||
<filterAttribute>qt</filterAttribute> |
||||
<filterAttribute>solutions</filterAttribute> |
||||
<filterAttribute>qtsingleapplication</filterAttribute> |
||||
</customFilter> |
||||
<filterSection> |
||||
<filterAttribute>qt</filterAttribute> |
||||
<filterAttribute>solutions</filterAttribute> |
||||
<filterAttribute>qtsingleapplication</filterAttribute> |
||||
<toc> |
||||
<section ref="index.html" title="Qt Solutions: Single Application Documentation"> |
||||
<section ref="qtsingleapplication-example-trivial.html" title="A Trivial Example"/> |
||||
<section ref="qtsinglecoreapplication-example-console.html" title="A non-GUI example"/> |
||||
<section ref="qtsingleapplication-example-loader.html" title="Loading Documents"/> |
||||
<section ref="index.html" title="Single Application"/> |
||||
</section> |
||||
</toc> |
||||
<keywords> |
||||
<keyword name="A Trivial Example" id="A Trivial Example" ref="qtsingleapplication-example-trivial.html"/> |
||||
<keyword name="A non-GUI example" id="A non-GUI example" ref="qtsinglecoreapplication-example-console.html"/> |
||||
<keyword name="Loading Documents" id="Loading Documents" ref="qtsingleapplication-example-loader.html"/> |
||||
<keyword name="QtSingleApplication" id="QtSingleApplication" ref="qtsingleapplication.html"/> |
||||
<keyword name="activateWindow" id="QtSingleApplication::activateWindow" ref="qtsingleapplication.html#activateWindow"/> |
||||
<keyword name="activationWindow" id="QtSingleApplication::activationWindow" ref="qtsingleapplication.html#activationWindow"/> |
||||
<keyword name="id" id="QtSingleApplication::id" ref="qtsingleapplication.html#id"/> |
||||
<keyword name="initialize" id="QtSingleApplication::initialize" ref="qtsingleapplication-obsolete.html#initialize"/> |
||||
<keyword name="isRunning" id="QtSingleApplication::isRunning" ref="qtsingleapplication.html#isRunning"/> |
||||
<keyword name="messageReceived" id="QtSingleApplication::messageReceived" ref="qtsingleapplication.html#messageReceived"/> |
||||
<keyword name="sendMessage" id="QtSingleApplication::sendMessage" ref="qtsingleapplication.html#sendMessage"/> |
||||
<keyword name="setActivationWindow" id="QtSingleApplication::setActivationWindow" ref="qtsingleapplication.html#setActivationWindow"/> |
||||
<keyword name="QtSingleCoreApplication" id="QtSingleCoreApplication" ref="qtsinglecoreapplication.html"/> |
||||
<keyword name="id" id="QtSingleCoreApplication::id" ref="qtsinglecoreapplication.html#id"/> |
||||
<keyword name="isRunning" id="QtSingleCoreApplication::isRunning" ref="qtsinglecoreapplication.html#isRunning"/> |
||||
<keyword name="messageReceived" id="QtSingleCoreApplication::messageReceived" ref="qtsinglecoreapplication.html#messageReceived"/> |
||||
<keyword name="sendMessage" id="QtSingleCoreApplication::sendMessage" ref="qtsinglecoreapplication.html#sendMessage"/> |
||||
<keyword name="Single Application" id="Single Application" ref="index.html"/> |
||||
</keywords> |
||||
<files> |
||||
<file>qtsingleapplication.html</file> |
||||
<file>index.html</file> |
||||
<file>qtsingleapplication-example-trivial.html</file> |
||||
<file>qtsinglecoreapplication.html</file> |
||||
<file>qtsingleapplication-example-loader.html</file> |
||||
<file>qtsinglecoreapplication-example-console.html</file> |
||||
<file>classic.css</file> |
||||
<file>images/qt-logo.png</file> |
||||
</files> |
||||
</filterSection> |
||||
</QtHelpProject> |
||||
@ -1,118 +0,0 @@ |
||||
<?xml version="1.0" encoding="iso-8859-1"?> |
||||
<!DOCTYPE html |
||||
PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd"> |
||||
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> |
||||
<!-- console.qdoc --> |
||||
<head> |
||||
<title>A non-GUI example</title> |
||||
<link href="classic.css" rel="stylesheet" type="text/css" /> |
||||
</head> |
||||
<body> |
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%"> |
||||
<tr> |
||||
<td align="left" valign="top" width="32"><img src="images/qt-logo.png" align="left" width="57" height="67" border="0" /></td> |
||||
<td width="1"> </td><td class="postheader" valign="center"><a href="index.html"><font color="#004faf">Home</font></a></td> |
||||
</tr></table><h1 class="title">A non-GUI example<br /><span class="subtitle"></span> |
||||
</h1> |
||||
<p>This example shows how to use the single-application functionality in a console application. It does not require the <tt>QtGui</tt> library at all.</p> |
||||
<p>The only differences from the GUI application usage demonstrated in the other examples are:</p> |
||||
<p>1) The <tt>.pro</tt> file should include <tt>qtsinglecoreapplication.pri</tt> instead of <tt>qtsingleapplication.pri</tt></p> |
||||
<p>2) The class name is <tt>QtSingleCoreApplication</tt> instead of <tt>QtSingleApplication</tt>.</p> |
||||
<p>3) No calls are made regarding window activation, for obvious reasons.</p> |
||||
<p>console.pro:</p> |
||||
<pre> TEMPLATE = app |
||||
CONFIG += console |
||||
SOURCES += main.cpp |
||||
include(../../src/qtsinglecoreapplication.pri) |
||||
QT -= gui</pre> |
||||
<p>main.cpp:</p> |
||||
<pre><span class="comment"> /**************************************************************************** |
||||
** |
||||
** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies). |
||||
** Contact: http://www.qt-project.org/legal |
||||
** |
||||
** This file is part of the Qt Solutions component. |
||||
** |
||||
** You may use this file under the terms of the BSD license as follows: |
||||
** |
||||
** "Redistribution and use in source and binary forms, with or without |
||||
** modification, are permitted provided that the following conditions are |
||||
** met: |
||||
** * Redistributions of source code must retain the above copyright |
||||
** notice, this list of conditions and the following disclaimer. |
||||
** * Redistributions in binary form must reproduce the above copyright |
||||
** notice, this list of conditions and the following disclaimer in |
||||
** the documentation and/or other materials provided with the |
||||
** distribution. |
||||
** * Neither the name of Nokia Corporation and its Subsidiary(-ies) nor |
||||
** the names of its contributors may be used to endorse or promote |
||||
** products derived from this software without specific prior written |
||||
** permission. |
||||
** |
||||
** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
||||
** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
||||
** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
||||
** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
||||
** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
||||
** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
||||
** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
||||
** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
||||
** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
||||
** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
||||
** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE." |
||||
** |
||||
****************************************************************************/</span> |
||||
|
||||
#include "qtsinglecoreapplication.h" |
||||
#include <QtCore/QDebug> |
||||
|
||||
void report(const QString& msg) |
||||
{ |
||||
qDebug("[%i] %s", (int)QCoreApplication::applicationPid(), qPrintable(msg)); |
||||
} |
||||
|
||||
class MainClass : public QObject |
||||
{ |
||||
Q_OBJECT |
||||
public: |
||||
MainClass() |
||||
: QObject() |
||||
{} |
||||
|
||||
public slots: |
||||
void handleMessage(const QString& message) |
||||
{ |
||||
report( "Message received: \"" + message + "\""); |
||||
} |
||||
}; |
||||
|
||||
int main(int argc, char **argv) |
||||
{ |
||||
report("Starting up"); |
||||
|
||||
QtSingleCoreApplication app(argc, argv); |
||||
|
||||
if (app.isRunning()) { |
||||
QString msg(QString("Hi master, I am %1.").arg(QCoreApplication::applicationPid())); |
||||
bool sentok = app.sendMessage(msg, 2000); |
||||
QString rep("Another instance is running, so I will exit."); |
||||
rep += sentok ? " Message sent ok." : " Message sending failed; the other instance may be frozen."; |
||||
report(rep); |
||||
return 0; |
||||
} else { |
||||
report("No other instance is running; so I will."); |
||||
MainClass mainObj; |
||||
QObject::connect(&app, SIGNAL(messageReceived(const QString&)), |
||||
&mainObj, SLOT(handleMessage(const QString&))); |
||||
return app.exec(); |
||||
} |
||||
} |
||||
|
||||
#include "main.moc"</pre> |
||||
<p /><address><hr /><div align="center"> |
||||
<table width="100%" cellspacing="0" border="0"><tr class="address"> |
||||
<td width="30%" align="left">Copyright © 2010 Nokia Corporation and/or its subsidiary(-ies)</td> |
||||
<td width="40%" align="center"><a href="http://qt.nokia.com/doc/trademarks.html">Trademarks</a></td> |
||||
<td width="30%" align="right"><div align="right">Qt Solutions</div></td> |
||||
</tr></table></div></address></body> |
||||
</html> |
||||
@ -1,126 +0,0 @@ |
||||
<?xml version="1.0" encoding="iso-8859-1"?> |
||||
<!DOCTYPE html |
||||
PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd"> |
||||
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> |
||||
<!-- qtsinglecoreapplication.cpp --> |
||||
<head> |
||||
<title>List of All Members for QtSingleCoreApplication</title> |
||||
<link href="classic.css" rel="stylesheet" type="text/css" /> |
||||
</head> |
||||
<body> |
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%"> |
||||
<tr> |
||||
<td align="left" valign="top" width="32"><img src="images/qt-logo.png" align="left" width="57" height="67" border="0" /></td> |
||||
<td width="1"> </td><td class="postheader" valign="center"><a href="index.html"><font color="#004faf">Home</font></a></td> |
||||
</tr></table><h1 class="title">List of All Members for QtSingleCoreApplication</h1> |
||||
<p>This is the complete list of members for <a href="qtsinglecoreapplication.html">QtSingleCoreApplication</a>, including inherited members.</p> |
||||
<p><table class="propsummary" width="100%" border="0" cellpadding="0" cellspacing="0"> |
||||
<tr><td width="45%" valign="top"><ul> |
||||
<li><div class="fn">enum <b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#Encoding-enum">Encoding</a></b></div></li> |
||||
<li><div class="fn">typedef <b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#EventFilter-typedef">EventFilter</a></b></div></li> |
||||
<li><div class="fn"><b><a href="qtsinglecoreapplication.html#QtSingleCoreApplication">QtSingleCoreApplication</a></b> ( int &, char ** )</div></li> |
||||
<li><div class="fn"><b><a href="qtsinglecoreapplication.html#QtSingleCoreApplication-2">QtSingleCoreApplication</a></b> ( const QString &, int &, char ** )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#aboutToQuit">aboutToQuit</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#addLibraryPath">addLibraryPath</a></b> ( const QString & )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#applicationDirPath">applicationDirPath</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#applicationFilePath">applicationFilePath</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#applicationName-prop">applicationName</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#applicationPid">applicationPid</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#applicationVersion-prop">applicationVersion</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#arguments">arguments</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#blockSignals">blockSignals</a></b> ( bool )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#childEvent">childEvent</a></b> ( QChildEvent * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#children">children</a></b> () const</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#closingDown">closingDown</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#connect">connect</a></b> ( const QObject *, const char *, const QObject *, const char *, Qt::ConnectionType )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#connect-2">connect</a></b> ( const QObject *, const char *, const char *, Qt::ConnectionType ) const</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#connectNotify">connectNotify</a></b> ( const char * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#customEvent">customEvent</a></b> ( QEvent * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#d_ptr-var">d_ptr</a></b> : </div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#deleteLater">deleteLater</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#destroyed">destroyed</a></b> ( QObject * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#disconnect">disconnect</a></b> ( const QObject *, const char *, const QObject *, const char * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#disconnect-2">disconnect</a></b> ( const char *, const QObject *, const char * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#disconnect-3">disconnect</a></b> ( const QObject *, const char * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#disconnectNotify">disconnectNotify</a></b> ( const char * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#dumpObjectInfo">dumpObjectInfo</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#dumpObjectTree">dumpObjectTree</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#dynamicPropertyNames">dynamicPropertyNames</a></b> () const</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#event">event</a></b> ( QEvent * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#eventFilter">eventFilter</a></b> ( QObject *, QEvent * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#exec">exec</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#exit">exit</a></b> ( int )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#filterEvent">filterEvent</a></b> ( void *, long * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#findChild">findChild</a></b> ( const QString & ) const</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#findChildren">findChildren</a></b> ( const QString & ) const</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#findChildren-2">findChildren</a></b> ( const QRegExp & ) const</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#flush">flush</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#hasPendingEvents">hasPendingEvents</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="qtsinglecoreapplication.html#id">id</a></b> () const : QString</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#inherits">inherits</a></b> ( const char * ) const</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#installEventFilter">installEventFilter</a></b> ( QObject * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#installTranslator">installTranslator</a></b> ( QTranslator * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#instance">instance</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="qtsinglecoreapplication.html#isRunning">isRunning</a></b> () : bool</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#isWidgetType">isWidgetType</a></b> () const</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#killTimer">killTimer</a></b> ( int )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#libraryPaths">libraryPaths</a></b> ()</div></li> |
||||
</ul></td><td valign="top"><ul> |
||||
<li><div class="fn"><b><a href="qtsinglecoreapplication.html#messageReceived">messageReceived</a></b> ( const QString & )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#metaObject">metaObject</a></b> () const</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#moveToThread">moveToThread</a></b> ( QThread * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#notify">notify</a></b> ( QObject *, QEvent * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#objectName-prop">objectName</a></b> () const</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#organizationDomain-prop">organizationDomain</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#organizationName-prop">organizationName</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#parent">parent</a></b> () const</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#postEvent">postEvent</a></b> ( QObject *, QEvent * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#postEvent-2">postEvent</a></b> ( QObject *, QEvent *, int )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#processEvents">processEvents</a></b> ( QFlags<QEventLoop::ProcessEventsFlag> )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#processEvents-2">processEvents</a></b> ( QFlags<QEventLoop::ProcessEventsFlag>, int )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#property">property</a></b> ( const char * ) const</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#quit">quit</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#receivers">receivers</a></b> ( const char * ) const</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#removeEventFilter">removeEventFilter</a></b> ( QObject * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#removeLibraryPath">removeLibraryPath</a></b> ( const QString & )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#removePostedEvents">removePostedEvents</a></b> ( QObject * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#removePostedEvents-2">removePostedEvents</a></b> ( QObject *, int )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#removeTranslator">removeTranslator</a></b> ( QTranslator * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#sendEvent">sendEvent</a></b> ( QObject *, QEvent * )</div></li> |
||||
<li><div class="fn"><b><a href="qtsinglecoreapplication.html#sendMessage">sendMessage</a></b> ( const QString &, int ) : bool</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#sendPostedEvents">sendPostedEvents</a></b> ( QObject *, int )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#sendPostedEvents-2">sendPostedEvents</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#sender">sender</a></b> () const</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#applicationName-prop">setApplicationName</a></b> ( const QString & )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#applicationVersion-prop">setApplicationVersion</a></b> ( const QString & )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#setAttribute">setAttribute</a></b> ( Qt::ApplicationAttribute, bool )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#setEventFilter">setEventFilter</a></b> ( EventFilter )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#setLibraryPaths">setLibraryPaths</a></b> ( const QStringList & )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#objectName-prop">setObjectName</a></b> ( const QString & )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#organizationDomain-prop">setOrganizationDomain</a></b> ( const QString & )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#organizationName-prop">setOrganizationName</a></b> ( const QString & )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#setParent">setParent</a></b> ( QObject * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#setProperty">setProperty</a></b> ( const char *, const QVariant & )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#signalsBlocked">signalsBlocked</a></b> () const</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#startTimer">startTimer</a></b> ( int )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#startingUp">startingUp</a></b> ()</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#staticMetaObject-var">staticMetaObject</a></b> : </div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#staticQtMetaObject-var">staticQtMetaObject</a></b> : </div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#testAttribute">testAttribute</a></b> ( Qt::ApplicationAttribute )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#thread">thread</a></b> () const</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#timerEvent">timerEvent</a></b> ( QTimerEvent * )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#tr">tr</a></b> ( const char *, const char *, int )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qobject.html#trUtf8">trUtf8</a></b> ( const char *, const char *, int )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#translate">translate</a></b> ( const char *, const char *, const char *, Encoding, int )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#translate-2">translate</a></b> ( const char *, const char *, const char *, Encoding )</div></li> |
||||
<li><div class="fn"><b><a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#winEventFilter">winEventFilter</a></b> ( MSG *, long * )</div></li> |
||||
</ul> |
||||
</td></tr> |
||||
</table></p> |
||||
<p /><address><hr /><div align="center"> |
||||
<table width="100%" cellspacing="0" border="0"><tr class="address"> |
||||
<td width="30%" align="left">Copyright © 2010 Nokia Corporation and/or its subsidiary(-ies)</td> |
||||
<td width="40%" align="center"><a href="http://qt.nokia.com/doc/trademarks.html">Trademarks</a></td> |
||||
<td width="30%" align="right"><div align="right">Qt Solutions</div></td> |
||||
</tr></table></div></address></body> |
||||
</html> |
||||
@ -1,98 +0,0 @@ |
||||
<?xml version="1.0" encoding="iso-8859-1"?> |
||||
<!DOCTYPE html |
||||
PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd"> |
||||
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> |
||||
<!-- qtsinglecoreapplication.cpp --> |
||||
<head> |
||||
<title>QtSingleCoreApplication Class Reference</title> |
||||
<link href="classic.css" rel="stylesheet" type="text/css" /> |
||||
</head> |
||||
<body> |
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%"> |
||||
<tr> |
||||
<td align="left" valign="top" width="32"><img src="images/qt-logo.png" align="left" width="57" height="67" border="0" /></td> |
||||
<td width="1"> </td><td class="postheader" valign="center"><a href="index.html"><font color="#004faf">Home</font></a></td> |
||||
</tr></table><h1 class="title">QtSingleCoreApplication Class Reference</h1> |
||||
<p>A variant of the <a href="qtsingleapplication.html">QtSingleApplication</a> class for non-GUI applications. <a href="#details">More...</a></p> |
||||
<pre> #include <QtSingleCoreApplication></pre><p>Inherits <a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html">QCoreApplication</a>.</p> |
||||
<ul> |
||||
<li><a href="qtsinglecoreapplication-members.html">List of all members, including inherited members</a></li> |
||||
</ul> |
||||
<hr /> |
||||
<a name="public-functions"></a> |
||||
<h2>Public Functions</h2> |
||||
<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%"> |
||||
<tr><td class="memItemLeft" align="right" valign="top"></td><td class="memItemRight" valign="bottom"><b><a href="qtsinglecoreapplication.html#QtSingleCoreApplication">QtSingleCoreApplication</a></b> ( int & <i>argc</i>, char ** <i>argv</i> )</td></tr> |
||||
<tr><td class="memItemLeft" align="right" valign="top"></td><td class="memItemRight" valign="bottom"><b><a href="qtsinglecoreapplication.html#QtSingleCoreApplication-2">QtSingleCoreApplication</a></b> ( const QString & <i>appId</i>, int & <i>argc</i>, char ** <i>argv</i> )</td></tr> |
||||
<tr><td class="memItemLeft" align="right" valign="top">QString </td><td class="memItemRight" valign="bottom"><b><a href="qtsinglecoreapplication.html#id">id</a></b> () const</td></tr> |
||||
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><b><a href="qtsinglecoreapplication.html#isRunning">isRunning</a></b> ()</td></tr> |
||||
</table> |
||||
<ul> |
||||
<li><div bar="2" class="fn"></div>4 public functions inherited from <a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#public-functions">QCoreApplication</a></li> |
||||
<li><div bar="2" class="fn"></div>29 public functions inherited from <a href="http://qt.nokia.com/doc/4.6/qobject.html#public-functions">QObject</a></li> |
||||
</ul> |
||||
<hr /> |
||||
<a name="public-slots"></a> |
||||
<h2>Public Slots</h2> |
||||
<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%"> |
||||
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><b><a href="qtsinglecoreapplication.html#sendMessage">sendMessage</a></b> ( const QString & <i>message</i>, int <i>timeout</i> = 5000 )</td></tr> |
||||
</table> |
||||
<ul> |
||||
<li><div bar="2" class="fn"></div>1 public slot inherited from <a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#public-slots">QCoreApplication</a></li> |
||||
<li><div bar="2" class="fn"></div>1 public slot inherited from <a href="http://qt.nokia.com/doc/4.6/qobject.html#public-slots">QObject</a></li> |
||||
</ul> |
||||
<hr /> |
||||
<a name="signals"></a> |
||||
<h2>Signals</h2> |
||||
<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%"> |
||||
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qtsinglecoreapplication.html#messageReceived">messageReceived</a></b> ( const QString & <i>message</i> )</td></tr> |
||||
</table> |
||||
<ul> |
||||
<li><div bar="2" class="fn"></div>1 signal inherited from <a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#signals">QCoreApplication</a></li> |
||||
<li><div bar="2" class="fn"></div>1 signal inherited from <a href="http://qt.nokia.com/doc/4.6/qobject.html#signals">QObject</a></li> |
||||
</ul> |
||||
<h3>Additional Inherited Members</h3> |
||||
<ul> |
||||
<li><div class="fn"></div>4 properties inherited from <a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#properties">QCoreApplication</a></li> |
||||
<li><div class="fn"></div>1 property inherited from <a href="http://qt.nokia.com/doc/4.6/qobject.html#properties">QObject</a></li> |
||||
<li><div class="fn"></div>1 public type inherited from <a href="http://qt.nokia.com/doc/4.6/qobject.html#public-variables">QObject</a></li> |
||||
<li><div class="fn"></div>38 static public members inherited from <a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#static-public-members">QCoreApplication</a></li> |
||||
<li><div class="fn"></div>4 static public members inherited from <a href="http://qt.nokia.com/doc/4.6/qobject.html#static-public-members">QObject</a></li> |
||||
<li><div class="fn"></div>1 protected function inherited from <a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#protected-functions">QCoreApplication</a></li> |
||||
<li><div class="fn"></div>7 protected functions inherited from <a href="http://qt.nokia.com/doc/4.6/qobject.html#protected-functions">QObject</a></li> |
||||
<li><div class="fn"></div>2 protected variables inherited from <a href="http://qt.nokia.com/doc/4.6/qobject.html#protected-variables">QObject</a></li> |
||||
</ul> |
||||
<a name="details"></a> |
||||
<hr /> |
||||
<h2>Detailed Description</h2> |
||||
<p>A variant of the <a href="qtsingleapplication.html">QtSingleApplication</a> class for non-GUI applications.</p> |
||||
<p>This class is a variant of <a href="qtsingleapplication.html">QtSingleApplication</a> suited for use in console (non-GUI) applications. It is an extension of <a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html">QCoreApplication</a> (instead of <a href="http://qt.nokia.com/doc/4.6/qapplication.html">QApplication</a>). It does not require the <a href="http://qt.nokia.com/doc/4.6/qtgui.html">QtGui</a> library.</p> |
||||
<p>The API and usage is identical to <a href="qtsingleapplication.html">QtSingleApplication</a>, except that functions relating to the "activation window" are not present, for obvious reasons. Please refer to the <a href="qtsingleapplication.html">QtSingleApplication</a> documentation for explanation of the usage.</p> |
||||
<p>A QtSingleCoreApplication instance can communicate to a <a href="qtsingleapplication.html">QtSingleApplication</a> instance if they share the same application id. Hence, this class can be used to create a light-weight command-line tool that sends commands to a GUI application.</p> |
||||
<p>See also <a href="qtsingleapplication.html">QtSingleApplication</a>.</p> |
||||
<hr /> |
||||
<h2>Member Function Documentation</h2> |
||||
<h3 class="fn"><a name="QtSingleCoreApplication"></a>QtSingleCoreApplication::QtSingleCoreApplication ( int & <i>argc</i>, char ** <i>argv</i> )</h3> |
||||
<p>Creates a <a href="qtsinglecoreapplication.html">QtSingleCoreApplication</a> object. The application identifier will be <a href="http://qt.nokia.com/doc/4.6/qcoreapplication.html#applicationFilePath">QCoreApplication::applicationFilePath</a>(). <i>argc</i> and <i>argv</i> are passed on to the QCoreAppliation constructor.</p> |
||||
<h3 class="fn"><a name="QtSingleCoreApplication-2"></a>QtSingleCoreApplication::QtSingleCoreApplication ( const <a href="http://qt.nokia.com/doc/4.6/qstring.html">QString</a> & <i>appId</i>, int & <i>argc</i>, char ** <i>argv</i> )</h3> |
||||
<p>Creates a <a href="qtsinglecoreapplication.html">QtSingleCoreApplication</a> object with the application identifier <i>appId</i>. <i>argc</i> and <i>argv</i> are passed on to the QCoreAppliation constructor.</p> |
||||
<h3 class="fn"><a name="id"></a><a href="http://qt.nokia.com/doc/4.6/qstring.html">QString</a> QtSingleCoreApplication::id () const</h3> |
||||
<p>Returns the application identifier. Two processes with the same identifier will be regarded as instances of the same application.</p> |
||||
<h3 class="fn"><a name="isRunning"></a>bool QtSingleCoreApplication::isRunning ()</h3> |
||||
<p>Returns true if another instance of this application is running; otherwise false.</p> |
||||
<p>This function does not find instances of this application that are being run by a different user (on Windows: that are running in another session).</p> |
||||
<p>See also <a href="qtsinglecoreapplication.html#sendMessage">sendMessage</a>().</p> |
||||
<h3 class="fn"><a name="messageReceived"></a>void QtSingleCoreApplication::messageReceived ( const <a href="http://qt.nokia.com/doc/4.6/qstring.html">QString</a> & <i>message</i> ) <tt> [signal]</tt></h3> |
||||
<p>This signal is emitted when the current instance receives a <i>message</i> from another instance of this application.</p> |
||||
<p>See also <a href="qtsinglecoreapplication.html#sendMessage">sendMessage</a>().</p> |
||||
<h3 class="fn"><a name="sendMessage"></a>bool QtSingleCoreApplication::sendMessage ( const <a href="http://qt.nokia.com/doc/4.6/qstring.html">QString</a> & <i>message</i>, int <i>timeout</i> = 5000 ) <tt> [slot]</tt></h3> |
||||
<p>Tries to send the text <i>message</i> to the currently running instance. The <a href="qtsinglecoreapplication.html">QtSingleCoreApplication</a> object in the running instance will emit the <a href="qtsinglecoreapplication.html#messageReceived">messageReceived</a>() signal when it receives the message.</p> |
||||
<p>This function returns true if the message has been sent to, and processed by, the current instance. If there is no instance currently running, or if the running instance fails to process the message within <i>timeout</i> milliseconds, this function return false.</p> |
||||
<p>See also <a href="qtsinglecoreapplication.html#isRunning">isRunning</a>() and <a href="qtsinglecoreapplication.html#messageReceived">messageReceived</a>().</p> |
||||
<p /><address><hr /><div align="center"> |
||||
<table width="100%" cellspacing="0" border="0"><tr class="address"> |
||||
<td width="30%" align="left">Copyright © 2010 Nokia Corporation and/or its subsidiary(-ies)</td> |
||||
<td width="40%" align="center"><a href="http://qt.nokia.com/doc/trademarks.html">Trademarks</a></td> |
||||
<td width="30%" align="right"><div align="right">Qt Solutions</div></td> |
||||
</tr></table></div></address></body> |
||||
</html> |
||||
|
Before Width: | Height: | Size: 4.0 KiB |
@ -1,87 +0,0 @@ |
||||
/**************************************************************************** |
||||
** |
||||
** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies). |
||||
** Contact: http://www.qt-project.org/legal |
||||
** |
||||
** This file is part of the Qt Solutions component. |
||||
** |
||||
** $QT_BEGIN_LICENSE:BSD$ |
||||
** You may use this file under the terms of the BSD license as follows: |
||||
** |
||||
** "Redistribution and use in source and binary forms, with or without |
||||
** modification, are permitted provided that the following conditions are |
||||
** met: |
||||
** * Redistributions of source code must retain the above copyright |
||||
** notice, this list of conditions and the following disclaimer. |
||||
** * Redistributions in binary form must reproduce the above copyright |
||||
** notice, this list of conditions and the following disclaimer in |
||||
** the documentation and/or other materials provided with the |
||||
** distribution. |
||||
** * Neither the name of Digia Plc and its Subsidiary(-ies) nor the names |
||||
** of its contributors may be used to endorse or promote products derived |
||||
** from this software without specific prior written permission. |
||||
** |
||||
** |
||||
** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
||||
** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
||||
** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
||||
** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
||||
** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
||||
** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
||||
** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
||||
** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
||||
** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
||||
** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
||||
** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE." |
||||
** |
||||
** $QT_END_LICENSE$ |
||||
** |
||||
****************************************************************************/ |
||||
|
||||
/*! |
||||
\page index.html |
||||
\title Single Application |
||||
|
||||
\section1 Description |
||||
|
||||
The QtSingleApplication component provides support |
||||
for applications that can be only started once per user. |
||||
|
||||
|
||||
|
||||
For some applications it is useful or even critical that they are started |
||||
only once by any user. Future attempts to start the application should |
||||
activate any already running instance, and possibly perform requested |
||||
actions, e.g. loading a file, in that instance. |
||||
|
||||
The QtSingleApplication class provides an interface to detect a running |
||||
instance, and to send command strings to that instance. |
||||
For console (non-GUI) applications, the QtSingleCoreApplication variant is provided, which avoids dependency on QtGui. |
||||
|
||||
|
||||
|
||||
|
||||
\section1 Classes |
||||
\list |
||||
\i QtSingleApplication \i QtSingleCoreApplication\endlist |
||||
|
||||
\section1 Examples |
||||
\list |
||||
\i \link qtsingleapplication-example-trivial.html A Trivial Example \endlink \i \link qtsingleapplication-example-loader.html Loading Documents \endlink \i \link qtsinglecoreapplication-example-console.html A Non-GUI Example \endlink \endlist |
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
\section1 Tested platforms |
||||
\list |
||||
\i Qt 4.4, 4.5 / Windows XP / MSVC.NET 2005 |
||||
\i Qt 4.4, 4.5 / Linux / gcc |
||||
\i Qt 4.4, 4.5 / MacOS X 10.5 / gcc |
||||
\endlist |
||||
|
||||
|
||||
|
||||
|
||||
*/ |
||||
@ -1,5 +0,0 @@ |
||||
TEMPLATE = app |
||||
CONFIG += console |
||||
SOURCES += main.cpp |
||||
include(../../src/qtsinglecoreapplication.pri) |
||||
QT -= gui |
||||
@ -1,65 +0,0 @@ |
||||
/**************************************************************************** |
||||
** |
||||
** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies). |
||||
** Contact: http://www.qt-project.org/legal |
||||
** |
||||
** This file is part of the Qt Solutions component. |
||||
** |
||||
** $QT_BEGIN_LICENSE:BSD$ |
||||
** You may use this file under the terms of the BSD license as follows: |
||||
** |
||||
** "Redistribution and use in source and binary forms, with or without |
||||
** modification, are permitted provided that the following conditions are |
||||
** met: |
||||
** * Redistributions of source code must retain the above copyright |
||||
** notice, this list of conditions and the following disclaimer. |
||||
** * Redistributions in binary form must reproduce the above copyright |
||||
** notice, this list of conditions and the following disclaimer in |
||||
** the documentation and/or other materials provided with the |
||||
** distribution. |
||||
** * Neither the name of Digia Plc and its Subsidiary(-ies) nor the names |
||||
** of its contributors may be used to endorse or promote products derived |
||||
** from this software without specific prior written permission. |
||||
** |
||||
** |
||||
** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
||||
** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
||||
** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
||||
** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
||||
** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
||||
** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
||||
** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
||||
** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
||||
** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
||||
** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
||||
** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE." |
||||
** |
||||
** $QT_END_LICENSE$ |
||||
** |
||||
****************************************************************************/ |
||||
|
||||
/*! \page qtsinglecoreapplication-example-console.html |
||||
\title A non-GUI example |
||||
|
||||
This example shows how to use the single-application functionality |
||||
in a console application. It does not require the \c QtGui library |
||||
at all. |
||||
|
||||
The only differences from the GUI application usage demonstrated |
||||
in the other examples are: |
||||
|
||||
1) The \c.pro file should include \c qtsinglecoreapplication.pri |
||||
instead of \c qtsingleapplication.pri |
||||
|
||||
2) The class name is \c QtSingleCoreApplication instead of \c |
||||
QtSingleApplication. |
||||
|
||||
3) No calls are made regarding window activation, for obvious reasons. |
||||
|
||||
console.pro: |
||||
\quotefile console/console.pro |
||||
|
||||
main.cpp: |
||||
\quotefile console/main.cpp |
||||
|
||||
*/ |
||||
@ -1,89 +0,0 @@ |
||||
/****************************************************************************
|
||||
** |
||||
** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies). |
||||
** Contact: http://www.qt-project.org/legal
|
||||
** |
||||
** This file is part of the Qt Solutions component. |
||||
** |
||||
** $QT_BEGIN_LICENSE:BSD$ |
||||
** You may use this file under the terms of the BSD license as follows: |
||||
** |
||||
** "Redistribution and use in source and binary forms, with or without |
||||
** modification, are permitted provided that the following conditions are |
||||
** met: |
||||
** * Redistributions of source code must retain the above copyright |
||||
** notice, this list of conditions and the following disclaimer. |
||||
** * Redistributions in binary form must reproduce the above copyright |
||||
** notice, this list of conditions and the following disclaimer in |
||||
** the documentation and/or other materials provided with the |
||||
** distribution. |
||||
** * Neither the name of Digia Plc and its Subsidiary(-ies) nor the names |
||||
** of its contributors may be used to endorse or promote products derived |
||||
** from this software without specific prior written permission. |
||||
** |
||||
** |
||||
** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
||||
** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
||||
** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
||||
** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
||||
** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
||||
** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
||||
** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
||||
** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
||||
** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
||||
** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
||||
** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE." |
||||
** |
||||
** $QT_END_LICENSE$ |
||||
** |
||||
****************************************************************************/ |
||||
|
||||
|
||||
#include "qtsinglecoreapplication.h" |
||||
#include <QDebug> |
||||
|
||||
|
||||
void report(const QString& msg) |
||||
{ |
||||
qDebug("[%i] %s", (int)QCoreApplication::applicationPid(), qPrintable(msg)); |
||||
} |
||||
|
||||
class MainClass : public QObject |
||||
{ |
||||
Q_OBJECT |
||||
public: |
||||
MainClass() |
||||
: QObject() |
||||
{} |
||||
|
||||
public slots: |
||||
void handleMessage(const QString& message) |
||||
{ |
||||
report( "Message received: \"" + message + "\""); |
||||
} |
||||
}; |
||||
|
||||
int main(int argc, char **argv) |
||||
{ |
||||
report("Starting up"); |
||||
|
||||
QtSingleCoreApplication app(argc, argv); |
||||
|
||||
if (app.isRunning()) { |
||||
QString msg(QString("Hi master, I am %1.").arg(QCoreApplication::applicationPid())); |
||||
bool sentok = app.sendMessage(msg, 2000); |
||||
QString rep("Another instance is running, so I will exit."); |
||||
rep += sentok ? " Message sent ok." : " Message sending failed; the other instance may be frozen."; |
||||
report(rep); |
||||
return 0; |
||||
} else { |
||||
report("No other instance is running; so I will."); |
||||
MainClass mainObj; |
||||
QObject::connect(&app, SIGNAL(messageReceived(const QString&)), |
||||
&mainObj, SLOT(handleMessage(const QString&))); |
||||
return app.exec(); |
||||
} |
||||
} |
||||
|
||||
|
||||
#include "main.moc" |
||||
@ -1,4 +0,0 @@ |
||||
TEMPLATE = subdirs |
||||
SUBDIRS = trivial \ |
||||
loader \ |
||||
console |
||||
@ -1 +0,0 @@ |
||||
File 1 |
||||
@ -1 +0,0 @@ |
||||
File 2 |
||||
@ -1,6 +0,0 @@ |
||||
greaterThan(QT_MAJOR_VERSION, 4): QT += printsupport |
||||
TEMPLATE = app |
||||
|
||||
include(../../src/qtsingleapplication.pri) |
||||
|
||||
SOURCES += main.cpp |
||||
@ -1,81 +0,0 @@ |
||||
/**************************************************************************** |
||||
** |
||||
** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies). |
||||
** Contact: http://www.qt-project.org/legal |
||||
** |
||||
** This file is part of the Qt Solutions component. |
||||
** |
||||
** $QT_BEGIN_LICENSE:BSD$ |
||||
** You may use this file under the terms of the BSD license as follows: |
||||
** |
||||
** "Redistribution and use in source and binary forms, with or without |
||||
** modification, are permitted provided that the following conditions are |
||||
** met: |
||||
** * Redistributions of source code must retain the above copyright |
||||
** notice, this list of conditions and the following disclaimer. |
||||
** * Redistributions in binary form must reproduce the above copyright |
||||
** notice, this list of conditions and the following disclaimer in |
||||
** the documentation and/or other materials provided with the |
||||
** distribution. |
||||
** * Neither the name of Digia Plc and its Subsidiary(-ies) nor the names |
||||
** of its contributors may be used to endorse or promote products derived |
||||
** from this software without specific prior written permission. |
||||
** |
||||
** |
||||
** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
||||
** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
||||
** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
||||
** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
||||
** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
||||
** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
||||
** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
||||
** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
||||
** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
||||
** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
||||
** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE." |
||||
** |
||||
** $QT_END_LICENSE$ |
||||
** |
||||
****************************************************************************/ |
||||
|
||||
/*! \page qtsingleapplication-example-loader.html |
||||
\title Loading Documents |
||||
|
||||
The application in this example loads or prints the documents |
||||
passed as commandline parameters to further instances of this |
||||
application. |
||||
|
||||
\quotefromfile loader/main.cpp |
||||
\printuntil }; |
||||
The user interface in this application is a QMainWindow subclass |
||||
with a QMdiArea as the central widget. It implements a slot |
||||
\c handleMessage() that will be connected to the messageReceived() |
||||
signal of the QtSingleApplication class. |
||||
|
||||
\printuntil } |
||||
The MainWindow constructor creates a minimal user interface. |
||||
|
||||
\printto case Print: |
||||
The handleMessage() slot interprets the message passed in as a |
||||
filename that can be prepended with \e /print to indicate that |
||||
the file should just be printed rather than loaded. |
||||
|
||||
\printto #include |
||||
Loading the file will also activate the window. |
||||
|
||||
\printto mw |
||||
The \c main entry point function creates a QtSingleApplication |
||||
object, and creates a message to send to a running instance |
||||
of the application. If the message was sent successfully the |
||||
process exits immediately. |
||||
|
||||
\printuntil } |
||||
If the message could not be sent the application starts up. Note |
||||
that \c false is passed to the call to setActivationWindow() to |
||||
prevent automatic activation for every message received, e.g. when |
||||
the application should just print a file. Instead, the message |
||||
handling function determines whether activation is requested, and |
||||
signals that by emitting the needToShow() signal. This is then |
||||
simply connected directly to QtSingleApplication's |
||||
activateWindow() slot. |
||||
*/ |
||||
@ -1,152 +0,0 @@ |
||||
/****************************************************************************
|
||||
** |
||||
** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies). |
||||
** Contact: http://www.qt-project.org/legal
|
||||
** |
||||
** This file is part of the Qt Solutions component. |
||||
** |
||||
** $QT_BEGIN_LICENSE:BSD$ |
||||
** You may use this file under the terms of the BSD license as follows: |
||||
** |
||||
** "Redistribution and use in source and binary forms, with or without |
||||
** modification, are permitted provided that the following conditions are |
||||
** met: |
||||
** * Redistributions of source code must retain the above copyright |
||||
** notice, this list of conditions and the following disclaimer. |
||||
** * Redistributions in binary form must reproduce the above copyright |
||||
** notice, this list of conditions and the following disclaimer in |
||||
** the documentation and/or other materials provided with the |
||||
** distribution. |
||||
** * Neither the name of Digia Plc and its Subsidiary(-ies) nor the names |
||||
** of its contributors may be used to endorse or promote products derived |
||||
** from this software without specific prior written permission. |
||||
** |
||||
** |
||||
** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
||||
** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
||||
** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
||||
** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
||||
** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
||||
** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
||||
** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
||||
** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
||||
** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
||||
** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
||||
** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE." |
||||
** |
||||
** $QT_END_LICENSE$ |
||||
** |
||||
****************************************************************************/ |
||||
|
||||
#include <qtsingleapplication.h> |
||||
#include <QFile> |
||||
#include <QMainWindow> |
||||
#include <QPrinter> |
||||
#include <QPainter> |
||||
#include <QTextEdit> |
||||
#include <QMdiArea> |
||||
#include <QTextStream> |
||||
|
||||
class MainWindow : public QMainWindow |
||||
{ |
||||
Q_OBJECT |
||||
public: |
||||
MainWindow(); |
||||
|
||||
public slots: |
||||
void handleMessage(const QString& message); |
||||
|
||||
signals: |
||||
void needToShow(); |
||||
|
||||
private: |
||||
QMdiArea *workspace; |
||||
}; |
||||
|
||||
MainWindow::MainWindow() |
||||
{ |
||||
workspace = new QMdiArea(this); |
||||
|
||||
setCentralWidget(workspace); |
||||
} |
||||
|
||||
void MainWindow::handleMessage(const QString& message) |
||||
{ |
||||
enum Action { |
||||
Nothing, |
||||
Open, |
||||
Print |
||||
} action; |
||||
|
||||
action = Nothing; |
||||
QString filename = message; |
||||
if (message.toLower().startsWith("/print ")) { |
||||
filename = filename.mid(7); |
||||
action = Print; |
||||
} else if (!message.isEmpty()) { |
||||
action = Open; |
||||
} |
||||
if (action == Nothing) { |
||||
emit needToShow(); |
||||
return; |
||||
} |
||||
|
||||
QFile file(filename); |
||||
QString contents; |
||||
if (file.open(QIODevice::ReadOnly)) |
||||
contents = file.readAll(); |
||||
else |
||||
contents = "[[Error: Could not load file " + filename + "]]"; |
||||
|
||||
QTextEdit *view = new QTextEdit; |
||||
view->setPlainText(contents); |
||||
|
||||
switch(action) { |
||||
case Print: |
||||
{ |
||||
QPrinter printer; |
||||
view->print(&printer); |
||||
delete view; |
||||
} |
||||
break; |
||||
|
||||
case Open: |
||||
{ |
||||
workspace->addSubWindow(view); |
||||
view->setWindowTitle(message); |
||||
view->show(); |
||||
emit needToShow(); |
||||
} |
||||
break; |
||||
default: |
||||
break; |
||||
}; |
||||
} |
||||
|
||||
#include "main.moc" |
||||
|
||||
int main(int argc, char **argv) |
||||
{ |
||||
QtSingleApplication instance("File loader QtSingleApplication example", argc, argv); |
||||
QString message; |
||||
for (int a = 1; a < argc; ++a) { |
||||
message += argv[a]; |
||||
if (a < argc-1) |
||||
message += " "; |
||||
} |
||||
|
||||
if (instance.sendMessage(message)) |
||||
return 0; |
||||
|
||||
MainWindow mw; |
||||
mw.handleMessage(message); |
||||
mw.show(); |
||||
|
||||
QObject::connect(&instance, SIGNAL(messageReceived(const QString&)), |
||||
&mw, SLOT(handleMessage(const QString&))); |
||||
|
||||
instance.setActivationWindow(&mw, false); |
||||
QObject::connect(&mw, SIGNAL(needToShow()), &instance, SLOT(activateWindow())); |
||||
|
||||
return instance.exec(); |
||||
} |
||||
@ -1,78 +0,0 @@ |
||||
/****************************************************************************
|
||||
** |
||||
** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies). |
||||
** Contact: http://www.qt-project.org/legal
|
||||
** |
||||
** This file is part of the Qt Solutions component. |
||||
** |
||||
** $QT_BEGIN_LICENSE:BSD$ |
||||
** You may use this file under the terms of the BSD license as follows: |
||||
** |
||||
** "Redistribution and use in source and binary forms, with or without |
||||
** modification, are permitted provided that the following conditions are |
||||
** met: |
||||
** * Redistributions of source code must retain the above copyright |
||||
** notice, this list of conditions and the following disclaimer. |
||||
** * Redistributions in binary form must reproduce the above copyright |
||||
** notice, this list of conditions and the following disclaimer in |
||||
** the documentation and/or other materials provided with the |
||||
** distribution. |
||||
** * Neither the name of Digia Plc and its Subsidiary(-ies) nor the names |
||||
** of its contributors may be used to endorse or promote products derived |
||||
** from this software without specific prior written permission. |
||||
** |
||||
** |
||||
** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
||||
** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
||||
** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
||||
** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
||||
** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
||||
** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
||||
** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
||||
** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
||||
** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
||||
** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
||||
** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE." |
||||
** |
||||
** $QT_END_LICENSE$ |
||||
** |
||||
****************************************************************************/ |
||||
|
||||
#include <qtsingleapplication.h> |
||||
#include <QTextEdit> |
||||
|
||||
class TextEdit : public QTextEdit |
||||
{ |
||||
Q_OBJECT |
||||
public: |
||||
TextEdit(QWidget *parent = 0) |
||||
: QTextEdit(parent) |
||||
{} |
||||
public slots: |
||||
void append(const QString &str) |
||||
{ |
||||
QTextEdit::append(str); |
||||
} |
||||
}; |
||||
|
||||
#include "main.moc" |
||||
|
||||
|
||||
|
||||
int main(int argc, char **argv) |
||||
{ |
||||
QtSingleApplication instance(argc, argv); |
||||
if (instance.sendMessage("Wake up!")) |
||||
return 0; |
||||
|
||||
TextEdit logview; |
||||
logview.setReadOnly(true); |
||||
logview.show(); |
||||
|
||||
instance.setActivationWindow(&logview); |
||||
|
||||
QObject::connect(&instance, SIGNAL(messageReceived(const QString&)), |
||||
&logview, SLOT(append(const QString&))); |
||||
|
||||
return instance.exec(); |
||||
} |
||||
@ -1,5 +0,0 @@ |
||||
TEMPLATE = app |
||||
|
||||
include(../../src/qtsingleapplication.pri) |
||||
|
||||
SOURCES += main.cpp |
||||
@ -1,76 +0,0 @@ |
||||
/**************************************************************************** |
||||
** |
||||
** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies). |
||||
** Contact: http://www.qt-project.org/legal |
||||
** |
||||
** This file is part of the Qt Solutions component. |
||||
** |
||||
** $QT_BEGIN_LICENSE:BSD$ |
||||
** You may use this file under the terms of the BSD license as follows: |
||||
** |
||||
** "Redistribution and use in source and binary forms, with or without |
||||
** modification, are permitted provided that the following conditions are |
||||
** met: |
||||
** * Redistributions of source code must retain the above copyright |
||||
** notice, this list of conditions and the following disclaimer. |
||||
** * Redistributions in binary form must reproduce the above copyright |
||||
** notice, this list of conditions and the following disclaimer in |
||||
** the documentation and/or other materials provided with the |
||||
** distribution. |
||||
** * Neither the name of Digia Plc and its Subsidiary(-ies) nor the names |
||||
** of its contributors may be used to endorse or promote products derived |
||||
** from this software without specific prior written permission. |
||||
** |
||||
** |
||||
** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
||||
** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
||||
** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
||||
** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
||||
** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
||||
** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
||||
** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
||||
** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
||||
** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
||||
** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
||||
** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE." |
||||
** |
||||
** $QT_END_LICENSE$ |
||||
** |
||||
****************************************************************************/ |
||||
|
||||
/*! \page qtsingleapplication-example-trivial.html |
||||
\title A Trivial Example |
||||
|
||||
The application in this example has a log-view that displays |
||||
messages sent by further instances of the same application. |
||||
|
||||
The example demonstrates the use of the QtSingleApplication |
||||
class to detect and communicate with a running instance of |
||||
the application using the sendMessage() API. The messageReceived() |
||||
signal is used to display received messages in a QTextEdit log. |
||||
|
||||
\quotefromfile trivial/main.cpp |
||||
\printuntil instance |
||||
The example has only the \c main entry point function. |
||||
A QtSingleApplication object is created immediately. |
||||
|
||||
\printuntil return |
||||
If another instance of this application is already running, |
||||
sendMessage() will succeed, and this instance just exits |
||||
immediately. |
||||
|
||||
\printuntil show() |
||||
Otherwise the instance continues as normal and creates the |
||||
user interface. |
||||
|
||||
\printuntil return instance.exec(); |
||||
The \c logview object is also set as the application's activation |
||||
window. Every time a message is received, the window will be raised |
||||
and activated automatically. |
||||
|
||||
The messageReceived() signal is also connected to the QTextEdit's |
||||
append() slot. Every message received from further instances of |
||||
this application will be displayed in the log. |
||||
|
||||
Finally the event loop is entered. |
||||
*/ |
||||
@ -1,5 +0,0 @@ |
||||
TEMPLATE=subdirs |
||||
CONFIG += ordered |
||||
include(common.pri) |
||||
qtsingleapplication-uselib:SUBDIRS=buildlib |
||||
SUBDIRS+=examples |
||||
@ -1 +0,0 @@ |
||||
#include "qtlockedfile.h" |
||||
@ -1 +0,0 @@ |
||||
#include "qtsingleapplication.h" |
||||
@ -1,213 +0,0 @@ |
||||
/****************************************************************************
|
||||
** |
||||
** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies). |
||||
** Contact: http://www.qt-project.org/legal
|
||||
** |
||||
** This file is part of the Qt Solutions component. |
||||
** |
||||
** $QT_BEGIN_LICENSE:BSD$ |
||||
** You may use this file under the terms of the BSD license as follows: |
||||
** |
||||
** "Redistribution and use in source and binary forms, with or without |
||||
** modification, are permitted provided that the following conditions are |
||||
** met: |
||||
** * Redistributions of source code must retain the above copyright |
||||
** notice, this list of conditions and the following disclaimer. |
||||
** * Redistributions in binary form must reproduce the above copyright |
||||
** notice, this list of conditions and the following disclaimer in |
||||
** the documentation and/or other materials provided with the |
||||
** distribution. |
||||
** * Neither the name of Digia Plc and its Subsidiary(-ies) nor the names |
||||
** of its contributors may be used to endorse or promote products derived |
||||
** from this software without specific prior written permission. |
||||
** |
||||
** |
||||
** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
||||
** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
||||
** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
||||
** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
||||
** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
||||
** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
||||
** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
||||
** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
||||
** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
||||
** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
||||
** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE." |
||||
** |
||||
** $QT_END_LICENSE$ |
||||
** |
||||
****************************************************************************/ |
||||
|
||||
|
||||
#include "qtlocalpeer.h" |
||||
#include <QCoreApplication> |
||||
#include <QDataStream> |
||||
#include <QTime> |
||||
|
||||
#if defined(Q_OS_WIN) |
||||
#include <QLibrary> |
||||
#include <qt_windows.h> |
||||
typedef BOOL(WINAPI*PProcessIdToSessionId)(DWORD,DWORD*); |
||||
static PProcessIdToSessionId pProcessIdToSessionId = 0; |
||||
#endif |
||||
#if defined(Q_OS_UNIX) |
||||
#include <sys/types.h> |
||||
#include <time.h> |
||||
#include <unistd.h> |
||||
#endif |
||||
|
||||
namespace QtLP_Private { |
||||
#include "qtlockedfile.cpp" |
||||
#if defined(Q_OS_WIN) |
||||
#include "qtlockedfile_win.cpp" |
||||
#else |
||||
#include "qtlockedfile_unix.cpp" |
||||
#endif |
||||
} |
||||
|
||||
const char* QtLocalPeer::ack = "ack"; |
||||
|
||||
QtLocalPeer::QtLocalPeer(QObject* parent, const QString &appId) |
||||
: QObject(parent), id(appId) |
||||
{ |
||||
QString prefix = id; |
||||
if (id.isEmpty()) { |
||||
id = QCoreApplication::applicationFilePath(); |
||||
#if defined(Q_OS_WIN) |
||||
id = id.toLower(); |
||||
#endif |
||||
prefix = id.section(QLatin1Char('/'), -1); |
||||
} |
||||
prefix.remove(QRegExp("[^a-zA-Z]")); |
||||
prefix.truncate(6); |
||||
|
||||
QByteArray idc = id.toUtf8(); |
||||
quint16 idNum = qChecksum(idc.constData(), idc.size()); |
||||
socketName = QLatin1String("qtsingleapp-") + prefix |
||||
+ QLatin1Char('-') + QString::number(idNum, 16); |
||||
|
||||
#if defined(Q_OS_WIN) |
||||
if (!pProcessIdToSessionId) { |
||||
QLibrary lib("kernel32"); |
||||
pProcessIdToSessionId = (PProcessIdToSessionId)lib.resolve("ProcessIdToSessionId"); |
||||
} |
||||
if (pProcessIdToSessionId) { |
||||
DWORD sessionId = 0; |
||||
pProcessIdToSessionId(GetCurrentProcessId(), &sessionId); |
||||
socketName += QLatin1Char('-') + QString::number(sessionId, 16); |
||||
} |
||||
#else |
||||
socketName += QLatin1Char('-') + QString::number(::getuid(), 16); |
||||
#endif |
||||
|
||||
server = new QLocalServer(this); |
||||
QString lockName = QDir(QDir::tempPath()).absolutePath() |
||||
+ QLatin1Char('/') + socketName |
||||
+ QLatin1String("-lockfile"); |
||||
lockFile.setFileName(lockName); |
||||
lockFile.open(QIODevice::ReadWrite); |
||||
} |
||||
|
||||
|
||||
|
||||
bool QtLocalPeer::isClient() |
||||
{ |
||||
if (lockFile.isLocked()) |
||||
return false; |
||||
|
||||
if (!lockFile.lock(QtLP_Private::QtLockedFile::WriteLock, false)) |
||||
return true; |
||||
|
||||
bool res = server->listen(socketName); |
||||
#if defined(Q_OS_UNIX) && (QT_VERSION >= QT_VERSION_CHECK(4,5,0)) |
||||
// ### Workaround
|
||||
if (!res && server->serverError() == QAbstractSocket::AddressInUseError) { |
||||
QFile::remove(QDir::cleanPath(QDir::tempPath())+QLatin1Char('/')+socketName); |
||||
res = server->listen(socketName); |
||||
} |
||||
#endif |
||||
if (!res) |
||||
qWarning("QtSingleCoreApplication: listen on local socket failed, %s", qPrintable(server->errorString())); |
||||
QObject::connect(server, SIGNAL(newConnection()), SLOT(receiveConnection())); |
||||
return false; |
||||
} |
||||
|
||||
|
||||
bool QtLocalPeer::sendMessage(const QString &message, int timeout) |
||||
{ |
||||
if (!isClient()) |
||||
return false; |
||||
|
||||
QLocalSocket socket; |
||||
bool connOk = false; |
||||
for(int i = 0; i < 2; i++) { |
||||
// Try twice, in case the other instance is just starting up
|
||||
socket.connectToServer(socketName); |
||||
connOk = socket.waitForConnected(timeout/2); |
||||
if (connOk || i) |
||||
break; |
||||
int ms = 250; |
||||
#if defined(Q_OS_WIN) |
||||
Sleep(DWORD(ms)); |
||||
#else |
||||
struct timespec ts = { ms / 1000, (ms % 1000) * 1000 * 1000 }; |
||||
nanosleep(&ts, NULL); |
||||
#endif |
||||
} |
||||
if (!connOk) |
||||
return false; |
||||
|
||||
QByteArray uMsg(message.toUtf8()); |
||||
QDataStream ds(&socket); |
||||
ds.writeBytes(uMsg.constData(), uMsg.size()); |
||||
bool res = socket.waitForBytesWritten(timeout); |
||||
if (res) { |
||||
res &= socket.waitForReadyRead(timeout); // wait for ack
|
||||
if (res) |
||||
res &= (socket.read(qstrlen(ack)) == ack); |
||||
} |
||||
return res; |
||||
} |
||||
|
||||
|
||||
void QtLocalPeer::receiveConnection() |
||||
{ |
||||
QLocalSocket* socket = server->nextPendingConnection(); |
||||
if (!socket) |
||||
return; |
||||
|
||||
while (true) { |
||||
if (socket->state() == QLocalSocket::UnconnectedState) { |
||||
qWarning("QtLocalPeer: Peer disconnected"); |
||||
delete socket; |
||||
return; |
||||
} |
||||
if (socket->bytesAvailable() >= qint64(sizeof(quint32))) |
||||
break; |
||||
socket->waitForReadyRead(); |
||||
} |
||||
|
||||
QDataStream ds(socket); |
||||
QByteArray uMsg; |
||||
quint32 remaining; |
||||
ds >> remaining; |
||||
uMsg.resize(remaining); |
||||
int got = 0; |
||||
char* uMsgBuf = uMsg.data(); |
||||
do { |
||||
got = ds.readRawData(uMsgBuf, remaining); |
||||
remaining -= got; |
||||
uMsgBuf += got; |
||||
} while (remaining && got >= 0 && socket->waitForReadyRead(2000)); |
||||
if (got < 0) { |
||||
qWarning("QtLocalPeer: Message reception failed %s", socket->errorString().toLatin1().constData()); |
||||
delete socket; |
||||
return; |
||||
} |
||||
QString message(QString::fromUtf8(uMsg)); |
||||
socket->write(ack, qstrlen(ack)); |
||||
socket->waitForBytesWritten(1000); |
||||
socket->waitForDisconnected(1000); // make sure client reads ack
|
||||
delete socket; |
||||
emit messageReceived(message); //### (might take a long time to return)
|
||||
} |
||||
@ -1,77 +0,0 @@ |
||||
/****************************************************************************
|
||||
** |
||||
** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies). |
||||
** Contact: http://www.qt-project.org/legal
|
||||
** |
||||
** This file is part of the Qt Solutions component. |
||||
** |
||||
** $QT_BEGIN_LICENSE:BSD$ |
||||
** You may use this file under the terms of the BSD license as follows: |
||||
** |
||||
** "Redistribution and use in source and binary forms, with or without |
||||
** modification, are permitted provided that the following conditions are |
||||
** met: |
||||
** * Redistributions of source code must retain the above copyright |
||||
** notice, this list of conditions and the following disclaimer. |
||||
** * Redistributions in binary form must reproduce the above copyright |
||||
** notice, this list of conditions and the following disclaimer in |
||||
** the documentation and/or other materials provided with the |
||||
** distribution. |
||||
** * Neither the name of Digia Plc and its Subsidiary(-ies) nor the names |
||||
** of its contributors may be used to endorse or promote products derived |
||||
** from this software without specific prior written permission. |
||||
** |
||||
** |
||||
** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
||||
** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
||||
** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
||||
** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
||||
** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
||||
** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
||||
** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
||||
** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
||||
** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
||||
** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
||||
** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE." |
||||
** |
||||
** $QT_END_LICENSE$ |
||||
** |
||||
****************************************************************************/ |
||||
|
||||
#ifndef QTLOCALPEER_H |
||||
#define QTLOCALPEER_H |
||||
|
||||
#include <QLocalServer> |
||||
#include <QLocalSocket> |
||||
#include <QDir> |
||||
|
||||
#include "qtlockedfile.h" |
||||
|
||||
class QtLocalPeer : public QObject |
||||
{ |
||||
Q_OBJECT |
||||
|
||||
public: |
||||
QtLocalPeer(QObject *parent = 0, const QString &appId = QString()); |
||||
bool isClient(); |
||||
bool sendMessage(const QString &message, int timeout); |
||||
QString applicationId() const |
||||
{ return id; } |
||||
|
||||
Q_SIGNALS: |
||||
void messageReceived(const QString &message); |
||||
|
||||
protected Q_SLOTS: |
||||
void receiveConnection(); |
||||
|
||||
protected: |
||||
QString id; |
||||
QString socketName; |
||||
QLocalServer* server; |
||||
QtLP_Private::QtLockedFile lockFile; |
||||
|
||||
private: |
||||
static const char* ack; |
||||
}; |
||||
|
||||
#endif // QTLOCALPEER_H
|
||||
@ -1,193 +0,0 @@ |
||||
/****************************************************************************
|
||||
** |
||||
** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies). |
||||
** Contact: http://www.qt-project.org/legal
|
||||
** |
||||
** This file is part of the Qt Solutions component. |
||||
** |
||||
** $QT_BEGIN_LICENSE:BSD$ |
||||
** You may use this file under the terms of the BSD license as follows: |
||||
** |
||||
** "Redistribution and use in source and binary forms, with or without |
||||
** modification, are permitted provided that the following conditions are |
||||
** met: |
||||
** * Redistributions of source code must retain the above copyright |
||||
** notice, this list of conditions and the following disclaimer. |
||||
** * Redistributions in binary form must reproduce the above copyright |
||||
** notice, this list of conditions and the following disclaimer in |
||||
** the documentation and/or other materials provided with the |
||||
** distribution. |
||||
** * Neither the name of Digia Plc and its Subsidiary(-ies) nor the names |
||||
** of its contributors may be used to endorse or promote products derived |
||||
** from this software without specific prior written permission. |
||||
** |
||||
** |
||||
** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
||||
** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
||||
** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
||||
** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
||||
** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
||||
** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
||||
** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
||||
** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
||||
** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
||||
** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
||||
** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE." |
||||
** |
||||
** $QT_END_LICENSE$ |
||||
** |
||||
****************************************************************************/ |
||||
|
||||
#include "qtlockedfile.h" |
||||
|
||||
/*!
|
||||
\class QtLockedFile |
||||
|
||||
\brief The QtLockedFile class extends QFile with advisory locking |
||||
functions. |
||||
|
||||
A file may be locked in read or write mode. Multiple instances of |
||||
\e QtLockedFile, created in multiple processes running on the same |
||||
machine, may have a file locked in read mode. Exactly one instance |
||||
may have it locked in write mode. A read and a write lock cannot |
||||
exist simultaneously on the same file. |
||||
|
||||
The file locks are advisory. This means that nothing prevents |
||||
another process from manipulating a locked file using QFile or |
||||
file system functions offered by the OS. Serialization is only |
||||
guaranteed if all processes that access the file use |
||||
QLockedFile. Also, while holding a lock on a file, a process |
||||
must not open the same file again (through any API), or locks |
||||
can be unexpectedly lost. |
||||
|
||||
The lock provided by an instance of \e QtLockedFile is released |
||||
whenever the program terminates. This is true even when the |
||||
program crashes and no destructors are called. |
||||
*/ |
||||
|
||||
/*! \enum QtLockedFile::LockMode
|
||||
|
||||
This enum describes the available lock modes. |
||||
|
||||
\value ReadLock A read lock. |
||||
\value WriteLock A write lock. |
||||
\value NoLock Neither a read lock nor a write lock. |
||||
*/ |
||||
|
||||
/*!
|
||||
Constructs an unlocked \e QtLockedFile object. This constructor |
||||
behaves in the same way as \e QFile::QFile(). |
||||
|
||||
\sa QFile::QFile() |
||||
*/ |
||||
QtLockedFile::QtLockedFile() |
||||
: QFile() |
||||
{ |
||||
#ifdef Q_OS_WIN |
||||
wmutex = 0; |
||||
rmutex = 0; |
||||
#endif |
||||
m_lock_mode = NoLock; |
||||
} |
||||
|
||||
/*!
|
||||
Constructs an unlocked QtLockedFile object with file \a name. This |
||||
constructor behaves in the same way as \e QFile::QFile(const |
||||
QString&). |
||||
|
||||
\sa QFile::QFile() |
||||
*/ |
||||
QtLockedFile::QtLockedFile(const QString &name) |
||||
: QFile(name) |
||||
{ |
||||
#ifdef Q_OS_WIN |
||||
wmutex = 0; |
||||
rmutex = 0; |
||||
#endif |
||||
m_lock_mode = NoLock; |
||||
} |
||||
|
||||
/*!
|
||||
Opens the file in OpenMode \a mode. |
||||
|
||||
This is identical to QFile::open(), with the one exception that the |
||||
Truncate mode flag is disallowed. Truncation would conflict with the |
||||
advisory file locking, since the file would be modified before the |
||||
write lock is obtained. If truncation is required, use resize(0) |
||||
after obtaining the write lock. |
||||
|
||||
Returns true if successful; otherwise false. |
||||
|
||||
\sa QFile::open(), QFile::resize() |
||||
*/ |
||||
bool QtLockedFile::open(OpenMode mode) |
||||
{ |
||||
if (mode & QIODevice::Truncate) { |
||||
qWarning("QtLockedFile::open(): Truncate mode not allowed."); |
||||
return false; |
||||
} |
||||
return QFile::open(mode); |
||||
} |
||||
|
||||
/*!
|
||||
Returns \e true if this object has a in read or write lock; |
||||
otherwise returns \e false. |
||||
|
||||
\sa lockMode() |
||||
*/ |
||||
bool QtLockedFile::isLocked() const |
||||
{ |
||||
return m_lock_mode != NoLock; |
||||
} |
||||
|
||||
/*!
|
||||
Returns the type of lock currently held by this object, or \e |
||||
QtLockedFile::NoLock. |
||||
|
||||
\sa isLocked() |
||||
*/ |
||||
QtLockedFile::LockMode QtLockedFile::lockMode() const |
||||
{ |
||||
return m_lock_mode; |
||||
} |
||||
|
||||
/*!
|
||||
\fn bool QtLockedFile::lock(LockMode mode, bool block = true) |
||||
|
||||
Obtains a lock of type \a mode. The file must be opened before it |
||||
can be locked. |
||||
|
||||
If \a block is true, this function will block until the lock is |
||||
aquired. If \a block is false, this function returns \e false |
||||
immediately if the lock cannot be aquired. |
||||
|
||||
If this object already has a lock of type \a mode, this function |
||||
returns \e true immediately. If this object has a lock of a |
||||
different type than \a mode, the lock is first released and then a |
||||
new lock is obtained. |
||||
|
||||
This function returns \e true if, after it executes, the file is |
||||
locked by this object, and \e false otherwise. |
||||
|
||||
\sa unlock(), isLocked(), lockMode() |
||||
*/ |
||||
|
||||
/*!
|
||||
\fn bool QtLockedFile::unlock() |
||||
|
||||
Releases a lock. |
||||
|
||||
If the object has no lock, this function returns immediately. |
||||
|
||||
This function returns \e true if, after it executes, the file is |
||||
not locked by this object, and \e false otherwise. |
||||
|
||||
\sa lock(), isLocked(), lockMode() |
||||
*/ |
||||
|
||||
/*!
|
||||
\fn QtLockedFile::~QtLockedFile() |
||||
|
||||
Destroys the \e QtLockedFile object. If any locks were held, they |
||||
are released. |
||||
*/ |
||||
@ -1,97 +0,0 @@ |
||||
/****************************************************************************
|
||||
** |
||||
** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies). |
||||
** Contact: http://www.qt-project.org/legal
|
||||
** |
||||
** This file is part of the Qt Solutions component. |
||||
** |
||||
** $QT_BEGIN_LICENSE:BSD$ |
||||
** You may use this file under the terms of the BSD license as follows: |
||||
** |
||||
** "Redistribution and use in source and binary forms, with or without |
||||
** modification, are permitted provided that the following conditions are |
||||
** met: |
||||
** * Redistributions of source code must retain the above copyright |
||||
** notice, this list of conditions and the following disclaimer. |
||||
** * Redistributions in binary form must reproduce the above copyright |
||||
** notice, this list of conditions and the following disclaimer in |
||||
** the documentation and/or other materials provided with the |
||||
** distribution. |
||||
** * Neither the name of Digia Plc and its Subsidiary(-ies) nor the names |
||||
** of its contributors may be used to endorse or promote products derived |
||||
** from this software without specific prior written permission. |
||||
** |
||||
** |
||||
** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
||||
** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
||||
** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
||||
** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
||||
** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
||||
** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
||||
** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
||||
** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
||||
** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
||||
** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
||||
** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE." |
||||
** |
||||
** $QT_END_LICENSE$ |
||||
** |
||||
****************************************************************************/ |
||||
|
||||
#ifndef QTLOCKEDFILE_H |
||||
#define QTLOCKEDFILE_H |
||||
|
||||
#include <QFile> |
||||
#ifdef Q_OS_WIN |
||||
#include <QVector> |
||||
#endif |
||||
|
||||
#if defined(Q_OS_WIN) |
||||
# if !defined(QT_QTLOCKEDFILE_EXPORT) && !defined(QT_QTLOCKEDFILE_IMPORT) |
||||
# define QT_QTLOCKEDFILE_EXPORT |
||||
# elif defined(QT_QTLOCKEDFILE_IMPORT) |
||||
# if defined(QT_QTLOCKEDFILE_EXPORT) |
||||
# undef QT_QTLOCKEDFILE_EXPORT |
||||
# endif |
||||
# define QT_QTLOCKEDFILE_EXPORT __declspec(dllimport) |
||||
# elif defined(QT_QTLOCKEDFILE_EXPORT) |
||||
# undef QT_QTLOCKEDFILE_EXPORT |
||||
# define QT_QTLOCKEDFILE_EXPORT __declspec(dllexport) |
||||
# endif |
||||
#else |
||||
# define QT_QTLOCKEDFILE_EXPORT |
||||
#endif |
||||
|
||||
namespace QtLP_Private { |
||||
|
||||
class QT_QTLOCKEDFILE_EXPORT QtLockedFile : public QFile |
||||
{ |
||||
public: |
||||
enum LockMode { NoLock = 0, ReadLock, WriteLock }; |
||||
|
||||
QtLockedFile(); |
||||
QtLockedFile(const QString &name); |
||||
~QtLockedFile(); |
||||
|
||||
bool open(OpenMode mode); |
||||
|
||||
bool lock(LockMode mode, bool block = true); |
||||
bool unlock(); |
||||
bool isLocked() const; |
||||
LockMode lockMode() const; |
||||
|
||||
private: |
||||
#ifdef Q_OS_WIN |
||||
Qt::HANDLE wmutex; |
||||
Qt::HANDLE rmutex; |
||||
QVector<Qt::HANDLE> rmutexes; |
||||
QString mutexname; |
||||
|
||||
Qt::HANDLE getMutexHandle(int idx, bool doCreate); |
||||
bool waitMutex(Qt::HANDLE mutex, bool doBlock); |
||||
|
||||
#endif |
||||
LockMode m_lock_mode; |
||||
}; |
||||
} |
||||
#endif |
||||
@ -1,115 +0,0 @@ |
||||
/****************************************************************************
|
||||
** |
||||
** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies). |
||||
** Contact: http://www.qt-project.org/legal
|
||||
** |
||||
** This file is part of the Qt Solutions component. |
||||
** |
||||
** $QT_BEGIN_LICENSE:BSD$ |
||||
** You may use this file under the terms of the BSD license as follows: |
||||
** |
||||
** "Redistribution and use in source and binary forms, with or without |
||||
** modification, are permitted provided that the following conditions are |
||||
** met: |
||||
** * Redistributions of source code must retain the above copyright |
||||
** notice, this list of conditions and the following disclaimer. |
||||
** * Redistributions in binary form must reproduce the above copyright |
||||
** notice, this list of conditions and the following disclaimer in |
||||
** the documentation and/or other materials provided with the |
||||
** distribution. |
||||
** * Neither the name of Digia Plc and its Subsidiary(-ies) nor the names |
||||
** of its contributors may be used to endorse or promote products derived |
||||
** from this software without specific prior written permission. |
||||
** |
||||
** |
||||
** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
||||
** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
||||
** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
||||
** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
||||
** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
||||
** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
||||
** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
||||
** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
||||
** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
||||
** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
||||
** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE." |
||||
** |
||||
** $QT_END_LICENSE$ |
||||
** |
||||
****************************************************************************/ |
||||
|
||||
#include <string.h> |
||||
#include <errno.h> |
||||
#include <unistd.h> |
||||
#include <fcntl.h> |
||||
|
||||
#include "qtlockedfile.h" |
||||
|
||||
bool QtLockedFile::lock(LockMode mode, bool block) |
||||
{ |
||||
if (!isOpen()) { |
||||
qWarning("QtLockedFile::lock(): file is not opened"); |
||||
return false; |
||||
} |
||||
|
||||
if (mode == NoLock) |
||||
return unlock(); |
||||
|
||||
if (mode == m_lock_mode) |
||||
return true; |
||||
|
||||
if (m_lock_mode != NoLock) |
||||
unlock(); |
||||
|
||||
struct flock fl; |
||||
fl.l_whence = SEEK_SET; |
||||
fl.l_start = 0; |
||||
fl.l_len = 0; |
||||
fl.l_type = (mode == ReadLock) ? F_RDLCK : F_WRLCK; |
||||
int cmd = block ? F_SETLKW : F_SETLK; |
||||
int ret = fcntl(handle(), cmd, &fl); |
||||
|
||||
if (ret == -1) { |
||||
if (errno != EINTR && errno != EAGAIN) |
||||
qWarning("QtLockedFile::lock(): fcntl: %s", strerror(errno)); |
||||
return false; |
||||
} |
||||
|
||||
|
||||
m_lock_mode = mode; |
||||
return true; |
||||
} |
||||
|
||||
|
||||
bool QtLockedFile::unlock() |
||||
{ |
||||
if (!isOpen()) { |
||||
qWarning("QtLockedFile::unlock(): file is not opened"); |
||||
return false; |
||||
} |
||||
|
||||
if (!isLocked()) |
||||
return true; |
||||
|
||||
struct flock fl; |
||||
fl.l_whence = SEEK_SET; |
||||
fl.l_start = 0; |
||||
fl.l_len = 0; |
||||
fl.l_type = F_UNLCK; |
||||
int ret = fcntl(handle(), F_SETLKW, &fl); |
||||
|
||||
if (ret == -1) { |
||||
qWarning("QtLockedFile::lock(): fcntl: %s", strerror(errno)); |
||||
return false; |
||||
} |
||||
|
||||
m_lock_mode = NoLock; |
||||
return true; |
||||
} |
||||
|
||||
QtLockedFile::~QtLockedFile() |
||||
{ |
||||
if (isOpen()) |
||||
unlock(); |
||||
} |
||||
|
||||
@ -1,211 +0,0 @@ |
||||
/****************************************************************************
|
||||
** |
||||
** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies). |
||||
** Contact: http://www.qt-project.org/legal
|
||||
** |
||||
** This file is part of the Qt Solutions component. |
||||
** |
||||
** $QT_BEGIN_LICENSE:BSD$ |
||||
** You may use this file under the terms of the BSD license as follows: |
||||
** |
||||
** "Redistribution and use in source and binary forms, with or without |
||||
** modification, are permitted provided that the following conditions are |
||||
** met: |
||||
** * Redistributions of source code must retain the above copyright |
||||
** notice, this list of conditions and the following disclaimer. |
||||
** * Redistributions in binary form must reproduce the above copyright |
||||
** notice, this list of conditions and the following disclaimer in |
||||
** the documentation and/or other materials provided with the |
||||
** distribution. |
||||
** * Neither the name of Digia Plc and its Subsidiary(-ies) nor the names |
||||
** of its contributors may be used to endorse or promote products derived |
||||
** from this software without specific prior written permission. |
||||
** |
||||
** |
||||
** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
||||
** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
||||
** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
||||
** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
||||
** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
||||
** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
||||
** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
||||
** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
||||
** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
||||
** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
||||
** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE." |
||||
** |
||||
** $QT_END_LICENSE$ |
||||
** |
||||
****************************************************************************/ |
||||
|
||||
#include "qtlockedfile.h" |
||||
#include <qt_windows.h> |
||||
#include <QFileInfo> |
||||
|
||||
#define MUTEX_PREFIX "QtLockedFile mutex " |
||||
// Maximum number of concurrent read locks. Must not be greater than MAXIMUM_WAIT_OBJECTS
|
||||
#define MAX_READERS MAXIMUM_WAIT_OBJECTS |
||||
|
||||
#if QT_VERSION >= 0x050000 |
||||
#define QT_WA(unicode, ansi) unicode |
||||
#endif |
||||
|
||||
Qt::HANDLE QtLockedFile::getMutexHandle(int idx, bool doCreate) |
||||
{ |
||||
if (mutexname.isEmpty()) { |
||||
QFileInfo fi(*this); |
||||
mutexname = QString::fromLatin1(MUTEX_PREFIX) |
||||
+ fi.absoluteFilePath().toLower(); |
||||
} |
||||
QString mname(mutexname); |
||||
if (idx >= 0) |
||||
mname += QString::number(idx); |
||||
|
||||
Qt::HANDLE mutex; |
||||
if (doCreate) { |
||||
QT_WA( { mutex = CreateMutexW(NULL, FALSE, (TCHAR*)mname.utf16()); }, |
||||
{ mutex = CreateMutexA(NULL, FALSE, mname.toLocal8Bit().constData()); } ); |
||||
if (!mutex) { |
||||
qErrnoWarning("QtLockedFile::lock(): CreateMutex failed"); |
||||
return 0; |
||||
} |
||||
} |
||||
else { |
||||
QT_WA( { mutex = OpenMutexW(SYNCHRONIZE | MUTEX_MODIFY_STATE, FALSE, (TCHAR*)mname.utf16()); }, |
||||
{ mutex = OpenMutexA(SYNCHRONIZE | MUTEX_MODIFY_STATE, FALSE, mname.toLocal8Bit().constData()); } ); |
||||
if (!mutex) { |
||||
if (GetLastError() != ERROR_FILE_NOT_FOUND) |
||||
qErrnoWarning("QtLockedFile::lock(): OpenMutex failed"); |
||||
return 0; |
||||
} |
||||
} |
||||
return mutex; |
||||
} |
||||
|
||||
bool QtLockedFile::waitMutex(Qt::HANDLE mutex, bool doBlock) |
||||
{ |
||||
Q_ASSERT(mutex); |
||||
DWORD res = WaitForSingleObject(mutex, doBlock ? INFINITE : 0); |
||||
switch (res) { |
||||
case WAIT_OBJECT_0: |
||||
case WAIT_ABANDONED: |
||||
return true; |
||||
break; |
||||
case WAIT_TIMEOUT: |
||||
break; |
||||
default: |
||||
qErrnoWarning("QtLockedFile::lock(): WaitForSingleObject failed"); |
||||
} |
||||
return false; |
||||
} |
||||
|
||||
|
||||
|
||||
bool QtLockedFile::lock(LockMode mode, bool block) |
||||
{ |
||||
if (!isOpen()) { |
||||
qWarning("QtLockedFile::lock(): file is not opened"); |
||||
return false; |
||||
} |
||||
|
||||
if (mode == NoLock) |
||||
return unlock(); |
||||
|
||||
if (mode == m_lock_mode) |
||||
return true; |
||||
|
||||
if (m_lock_mode != NoLock) |
||||
unlock(); |
||||
|
||||
if (!wmutex && !(wmutex = getMutexHandle(-1, true))) |
||||
return false; |
||||
|
||||
if (!waitMutex(wmutex, block)) |
||||
return false; |
||||
|
||||
if (mode == ReadLock) { |
||||
int idx = 0; |
||||
for (; idx < MAX_READERS; idx++) { |
||||
rmutex = getMutexHandle(idx, false); |
||||
if (!rmutex || waitMutex(rmutex, false)) |
||||
break; |
||||
CloseHandle(rmutex); |
||||
} |
||||
bool ok = true; |
||||
if (idx >= MAX_READERS) { |
||||
qWarning("QtLockedFile::lock(): too many readers"); |
||||
rmutex = 0; |
||||
ok = false; |
||||
} |
||||
else if (!rmutex) { |
||||
rmutex = getMutexHandle(idx, true); |
||||
if (!rmutex || !waitMutex(rmutex, false)) |
||||
ok = false; |
||||
} |
||||
if (!ok && rmutex) { |
||||
CloseHandle(rmutex); |
||||
rmutex = 0; |
||||
} |
||||
ReleaseMutex(wmutex); |
||||
if (!ok) |
||||
return false; |
||||
} |
||||
else { |
||||
Q_ASSERT(rmutexes.isEmpty()); |
||||
for (int i = 0; i < MAX_READERS; i++) { |
||||
Qt::HANDLE mutex = getMutexHandle(i, false); |
||||
if (mutex) |
||||
rmutexes.append(mutex); |
||||
} |
||||
if (rmutexes.size()) { |
||||
DWORD res = WaitForMultipleObjects(rmutexes.size(), rmutexes.constData(), |
||||
TRUE, block ? INFINITE : 0); |
||||
if (res != WAIT_OBJECT_0 && res != WAIT_ABANDONED) { |
||||
if (res != WAIT_TIMEOUT) |
||||
qErrnoWarning("QtLockedFile::lock(): WaitForMultipleObjects failed"); |
||||
m_lock_mode = WriteLock; // trick unlock() to clean up - semiyucky
|
||||
unlock(); |
||||
return false; |
||||
} |
||||
} |
||||
} |
||||
|
||||
m_lock_mode = mode; |
||||
return true; |
||||
} |
||||
|
||||
bool QtLockedFile::unlock() |
||||
{ |
||||
if (!isOpen()) { |
||||
qWarning("QtLockedFile::unlock(): file is not opened"); |
||||
return false; |
||||
} |
||||
|
||||
if (!isLocked()) |
||||
return true; |
||||
|
||||
if (m_lock_mode == ReadLock) { |
||||
ReleaseMutex(rmutex); |
||||
CloseHandle(rmutex); |
||||
rmutex = 0; |
||||
} |
||||
else { |
||||
foreach(Qt::HANDLE mutex, rmutexes) { |
||||
ReleaseMutex(mutex); |
||||
CloseHandle(mutex); |
||||
} |
||||
rmutexes.clear(); |
||||
ReleaseMutex(wmutex); |
||||
} |
||||
|
||||
m_lock_mode = QtLockedFile::NoLock; |
||||
return true; |
||||
} |
||||
|
||||
QtLockedFile::~QtLockedFile() |
||||
{ |
||||
if (isOpen()) |
||||
unlock(); |
||||
if (wmutex) |
||||
CloseHandle(wmutex); |
||||
} |
||||
@ -1,347 +0,0 @@ |
||||
/****************************************************************************
|
||||
** |
||||
** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies). |
||||
** Contact: http://www.qt-project.org/legal
|
||||
** |
||||
** This file is part of the Qt Solutions component. |
||||
** |
||||
** $QT_BEGIN_LICENSE:BSD$ |
||||
** You may use this file under the terms of the BSD license as follows: |
||||
** |
||||
** "Redistribution and use in source and binary forms, with or without |
||||
** modification, are permitted provided that the following conditions are |
||||
** met: |
||||
** * Redistributions of source code must retain the above copyright |
||||
** notice, this list of conditions and the following disclaimer. |
||||
** * Redistributions in binary form must reproduce the above copyright |
||||
** notice, this list of conditions and the following disclaimer in |
||||
** the documentation and/or other materials provided with the |
||||
** distribution. |
||||
** * Neither the name of Digia Plc and its Subsidiary(-ies) nor the names |
||||
** of its contributors may be used to endorse or promote products derived |
||||
** from this software without specific prior written permission. |
||||
** |
||||
** |
||||
** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
||||
** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
||||
** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
||||
** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
||||
** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
||||
** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
||||
** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
||||
** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
||||
** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
||||
** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
||||
** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE." |
||||
** |
||||
** $QT_END_LICENSE$ |
||||
** |
||||
****************************************************************************/ |
||||
|
||||
|
||||
#include "qtsingleapplication.h" |
||||
#include "qtlocalpeer.h" |
||||
#include <QWidget> |
||||
|
||||
|
||||
/*!
|
||||
\class QtSingleApplication qtsingleapplication.h |
||||
\brief The QtSingleApplication class provides an API to detect and |
||||
communicate with running instances of an application. |
||||
|
||||
This class allows you to create applications where only one |
||||
instance should be running at a time. I.e., if the user tries to |
||||
launch another instance, the already running instance will be |
||||
activated instead. Another usecase is a client-server system, |
||||
where the first started instance will assume the role of server, |
||||
and the later instances will act as clients of that server. |
||||
|
||||
By default, the full path of the executable file is used to |
||||
determine whether two processes are instances of the same |
||||
application. You can also provide an explicit identifier string |
||||
that will be compared instead. |
||||
|
||||
The application should create the QtSingleApplication object early |
||||
in the startup phase, and call isRunning() to find out if another |
||||
instance of this application is already running. If isRunning() |
||||
returns false, it means that no other instance is running, and |
||||
this instance has assumed the role as the running instance. In |
||||
this case, the application should continue with the initialization |
||||
of the application user interface before entering the event loop |
||||
with exec(), as normal. |
||||
|
||||
The messageReceived() signal will be emitted when the running |
||||
application receives messages from another instance of the same |
||||
application. When a message is received it might be helpful to the |
||||
user to raise the application so that it becomes visible. To |
||||
facilitate this, QtSingleApplication provides the |
||||
setActivationWindow() function and the activateWindow() slot. |
||||
|
||||
If isRunning() returns true, another instance is already |
||||
running. It may be alerted to the fact that another instance has |
||||
started by using the sendMessage() function. Also data such as |
||||
startup parameters (e.g. the name of the file the user wanted this |
||||
new instance to open) can be passed to the running instance with |
||||
this function. Then, the application should terminate (or enter |
||||
client mode). |
||||
|
||||
If isRunning() returns true, but sendMessage() fails, that is an |
||||
indication that the running instance is frozen. |
||||
|
||||
Here's an example that shows how to convert an existing |
||||
application to use QtSingleApplication. It is very simple and does |
||||
not make use of all QtSingleApplication's functionality (see the |
||||
examples for that). |
||||
|
||||
\code |
||||
// Original
|
||||
int main(int argc, char **argv) |
||||
{ |
||||
QApplication app(argc, argv); |
||||
|
||||
MyMainWidget mmw; |
||||
mmw.show(); |
||||
return app.exec(); |
||||
} |
||||
|
||||
// Single instance
|
||||
int main(int argc, char **argv) |
||||
{ |
||||
QtSingleApplication app(argc, argv); |
||||
|
||||
if (app.isRunning()) |
||||
return !app.sendMessage(someDataString); |
||||
|
||||
MyMainWidget mmw; |
||||
app.setActivationWindow(&mmw); |
||||
mmw.show(); |
||||
return app.exec(); |
||||
} |
||||
\endcode |
||||
|
||||
Once this QtSingleApplication instance is destroyed (normally when |
||||
the process exits or crashes), when the user next attempts to run the |
||||
application this instance will not, of course, be encountered. The |
||||
next instance to call isRunning() or sendMessage() will assume the |
||||
role as the new running instance. |
||||
|
||||
For console (non-GUI) applications, QtSingleCoreApplication may be |
||||
used instead of this class, to avoid the dependency on the QtGui |
||||
library. |
||||
|
||||
\sa QtSingleCoreApplication |
||||
*/ |
||||
|
||||
|
||||
void QtSingleApplication::sysInit(const QString &appId) |
||||
{ |
||||
actWin = 0; |
||||
peer = new QtLocalPeer(this, appId); |
||||
connect(peer, SIGNAL(messageReceived(const QString&)), SIGNAL(messageReceived(const QString&))); |
||||
} |
||||
|
||||
|
||||
/*!
|
||||
Creates a QtSingleApplication object. The application identifier |
||||
will be QCoreApplication::applicationFilePath(). \a argc, \a |
||||
argv, and \a GUIenabled are passed on to the QAppliation constructor. |
||||
|
||||
If you are creating a console application (i.e. setting \a |
||||
GUIenabled to false), you may consider using |
||||
QtSingleCoreApplication instead. |
||||
*/ |
||||
|
||||
QtSingleApplication::QtSingleApplication(int &argc, char **argv, bool GUIenabled) |
||||
: QApplication(argc, argv, GUIenabled) |
||||
{ |
||||
sysInit(); |
||||
} |
||||
|
||||
|
||||
/*!
|
||||
Creates a QtSingleApplication object with the application |
||||
identifier \a appId. \a argc and \a argv are passed on to the |
||||
QAppliation constructor. |
||||
*/ |
||||
|
||||
QtSingleApplication::QtSingleApplication(const QString &appId, int &argc, char **argv) |
||||
: QApplication(argc, argv) |
||||
{ |
||||
sysInit(appId); |
||||
} |
||||
|
||||
#if QT_VERSION < 0x050000 |
||||
|
||||
/*!
|
||||
Creates a QtSingleApplication object. The application identifier |
||||
will be QCoreApplication::applicationFilePath(). \a argc, \a |
||||
argv, and \a type are passed on to the QAppliation constructor. |
||||
*/ |
||||
QtSingleApplication::QtSingleApplication(int &argc, char **argv, Type type) |
||||
: QApplication(argc, argv, type) |
||||
{ |
||||
sysInit(); |
||||
} |
||||
|
||||
|
||||
# if defined(Q_WS_X11) |
||||
/*!
|
||||
Special constructor for X11, ref. the documentation of |
||||
QApplication's corresponding constructor. The application identifier |
||||
will be QCoreApplication::applicationFilePath(). \a dpy, \a visual, |
||||
and \a cmap are passed on to the QApplication constructor. |
||||
*/ |
||||
QtSingleApplication::QtSingleApplication(Display* dpy, Qt::HANDLE visual, Qt::HANDLE cmap) |
||||
: QApplication(dpy, visual, cmap) |
||||
{ |
||||
sysInit(); |
||||
} |
||||
|
||||
/*!
|
||||
Special constructor for X11, ref. the documentation of |
||||
QApplication's corresponding constructor. The application identifier |
||||
will be QCoreApplication::applicationFilePath(). \a dpy, \a argc, \a |
||||
argv, \a visual, and \a cmap are passed on to the QApplication |
||||
constructor. |
||||
*/ |
||||
QtSingleApplication::QtSingleApplication(Display *dpy, int &argc, char **argv, Qt::HANDLE visual, Qt::HANDLE cmap) |
||||
: QApplication(dpy, argc, argv, visual, cmap) |
||||
{ |
||||
sysInit(); |
||||
} |
||||
|
||||
/*!
|
||||
Special constructor for X11, ref. the documentation of |
||||
QApplication's corresponding constructor. The application identifier |
||||
will be \a appId. \a dpy, \a argc, \a |
||||
argv, \a visual, and \a cmap are passed on to the QApplication |
||||
constructor. |
||||
*/ |
||||
QtSingleApplication::QtSingleApplication(Display* dpy, const QString &appId, int argc, char **argv, Qt::HANDLE visual, Qt::HANDLE cmap) |
||||
: QApplication(dpy, argc, argv, visual, cmap) |
||||
{ |
||||
sysInit(appId); |
||||
} |
||||
# endif // Q_WS_X11
|
||||
#endif // QT_VERSION < 0x050000
|
||||
|
||||
|
||||
/*!
|
||||
Returns true if another instance of this application is running; |
||||
otherwise false. |
||||
|
||||
This function does not find instances of this application that are |
||||
being run by a different user (on Windows: that are running in |
||||
another session). |
||||
|
||||
\sa sendMessage() |
||||
*/ |
||||
|
||||
bool QtSingleApplication::isRunning() |
||||
{ |
||||
return peer->isClient(); |
||||
} |
||||
|
||||
|
||||
/*!
|
||||
Tries to send the text \a message to the currently running |
||||
instance. The QtSingleApplication object in the running instance |
||||
will emit the messageReceived() signal when it receives the |
||||
message. |
||||
|
||||
This function returns true if the message has been sent to, and |
||||
processed by, the current instance. If there is no instance |
||||
currently running, or if the running instance fails to process the |
||||
message within \a timeout milliseconds, this function return false. |
||||
|
||||
\sa isRunning(), messageReceived() |
||||
*/ |
||||
bool QtSingleApplication::sendMessage(const QString &message, int timeout) |
||||
{ |
||||
return peer->sendMessage(message, timeout); |
||||
} |
||||
|
||||
|
||||
/*!
|
||||
Returns the application identifier. Two processes with the same |
||||
identifier will be regarded as instances of the same application. |
||||
*/ |
||||
QString QtSingleApplication::id() const |
||||
{ |
||||
return peer->applicationId(); |
||||
} |
||||
|
||||
|
||||
/*!
|
||||
Sets the activation window of this application to \a aw. The |
||||
activation window is the widget that will be activated by |
||||
activateWindow(). This is typically the application's main window. |
||||
|
||||
If \a activateOnMessage is true (the default), the window will be |
||||
activated automatically every time a message is received, just prior |
||||
to the messageReceived() signal being emitted. |
||||
|
||||
\sa activateWindow(), messageReceived() |
||||
*/ |
||||
|
||||
void QtSingleApplication::setActivationWindow(QWidget* aw, bool activateOnMessage) |
||||
{ |
||||
actWin = aw; |
||||
if (activateOnMessage) |
||||
connect(peer, SIGNAL(messageReceived(const QString&)), this, SLOT(activateWindow())); |
||||
else |
||||
disconnect(peer, SIGNAL(messageReceived(const QString&)), this, SLOT(activateWindow())); |
||||
} |
||||
|
||||
|
||||
/*!
|
||||
Returns the applications activation window if one has been set by |
||||
calling setActivationWindow(), otherwise returns 0. |
||||
|
||||
\sa setActivationWindow() |
||||
*/ |
||||
QWidget* QtSingleApplication::activationWindow() const |
||||
{ |
||||
return actWin; |
||||
} |
||||
|
||||
|
||||
/*!
|
||||
De-minimizes, raises, and activates this application's activation window. |
||||
This function does nothing if no activation window has been set. |
||||
|
||||
This is a convenience function to show the user that this |
||||
application instance has been activated when he has tried to start |
||||
another instance. |
||||
|
||||
This function should typically be called in response to the |
||||
messageReceived() signal. By default, that will happen |
||||
automatically, if an activation window has been set. |
||||
|
||||
\sa setActivationWindow(), messageReceived(), initialize() |
||||
*/ |
||||
void QtSingleApplication::activateWindow() |
||||
{ |
||||
if (actWin) { |
||||
actWin->setWindowState(actWin->windowState() & ~Qt::WindowMinimized); |
||||
actWin->raise(); |
||||
actWin->activateWindow(); |
||||
} |
||||
} |
||||
|
||||
|
||||
/*!
|
||||
\fn void QtSingleApplication::messageReceived(const QString& message) |
||||
|
||||
This signal is emitted when the current instance receives a \a |
||||
message from another instance of this application. |
||||
|
||||
\sa sendMessage(), setActivationWindow(), activateWindow() |
||||
*/ |
||||
|
||||
|
||||
/*!
|
||||
\fn void QtSingleApplication::initialize(bool dummy = true) |
||||
|
||||
\obsolete |
||||
*/ |
||||
@ -1,105 +0,0 @@ |
||||
/****************************************************************************
|
||||
** |
||||
** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies). |
||||
** Contact: http://www.qt-project.org/legal
|
||||
** |
||||
** This file is part of the Qt Solutions component. |
||||
** |
||||
** $QT_BEGIN_LICENSE:BSD$ |
||||
** You may use this file under the terms of the BSD license as follows: |
||||
** |
||||
** "Redistribution and use in source and binary forms, with or without |
||||
** modification, are permitted provided that the following conditions are |
||||
** met: |
||||
** * Redistributions of source code must retain the above copyright |
||||
** notice, this list of conditions and the following disclaimer. |
||||
** * Redistributions in binary form must reproduce the above copyright |
||||
** notice, this list of conditions and the following disclaimer in |
||||
** the documentation and/or other materials provided with the |
||||
** distribution. |
||||
** * Neither the name of Digia Plc and its Subsidiary(-ies) nor the names |
||||
** of its contributors may be used to endorse or promote products derived |
||||
** from this software without specific prior written permission. |
||||
** |
||||
** |
||||
** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
||||
** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
||||
** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
||||
** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
||||
** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
||||
** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
||||
** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
||||
** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
||||
** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
||||
** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
||||
** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE." |
||||
** |
||||
** $QT_END_LICENSE$ |
||||
** |
||||
****************************************************************************/ |
||||
|
||||
#ifndef QTSINGLEAPPLICATION_H |
||||
#define QTSINGLEAPPLICATION_H |
||||
|
||||
#include <QApplication> |
||||
|
||||
class QtLocalPeer; |
||||
|
||||
#if defined(Q_OS_WIN) |
||||
# if !defined(QT_QTSINGLEAPPLICATION_EXPORT) && !defined(QT_QTSINGLEAPPLICATION_IMPORT) |
||||
# define QT_QTSINGLEAPPLICATION_EXPORT |
||||
# elif defined(QT_QTSINGLEAPPLICATION_IMPORT) |
||||
# if defined(QT_QTSINGLEAPPLICATION_EXPORT) |
||||
# undef QT_QTSINGLEAPPLICATION_EXPORT |
||||
# endif |
||||
# define QT_QTSINGLEAPPLICATION_EXPORT __declspec(dllimport) |
||||
# elif defined(QT_QTSINGLEAPPLICATION_EXPORT) |
||||
# undef QT_QTSINGLEAPPLICATION_EXPORT |
||||
# define QT_QTSINGLEAPPLICATION_EXPORT __declspec(dllexport) |
||||
# endif |
||||
#else |
||||
# define QT_QTSINGLEAPPLICATION_EXPORT |
||||
#endif |
||||
|
||||
class QT_QTSINGLEAPPLICATION_EXPORT QtSingleApplication : public QApplication |
||||
{ |
||||
Q_OBJECT |
||||
|
||||
public: |
||||
QtSingleApplication(int &argc, char **argv, bool GUIenabled = true); |
||||
QtSingleApplication(const QString &id, int &argc, char **argv); |
||||
#if QT_VERSION < 0x050000 |
||||
QtSingleApplication(int &argc, char **argv, Type type); |
||||
# if defined(Q_WS_X11) |
||||
QtSingleApplication(Display* dpy, Qt::HANDLE visual = 0, Qt::HANDLE colormap = 0); |
||||
QtSingleApplication(Display *dpy, int &argc, char **argv, Qt::HANDLE visual = 0, Qt::HANDLE cmap= 0); |
||||
QtSingleApplication(Display* dpy, const QString &appId, int argc, char **argv, Qt::HANDLE visual = 0, Qt::HANDLE colormap = 0); |
||||
# endif // Q_WS_X11
|
||||
#endif // QT_VERSION < 0x050000
|
||||
|
||||
bool isRunning(); |
||||
QString id() const; |
||||
|
||||
void setActivationWindow(QWidget* aw, bool activateOnMessage = true); |
||||
QWidget* activationWindow() const; |
||||
|
||||
// Obsolete:
|
||||
void initialize(bool dummy = true) |
||||
{ isRunning(); Q_UNUSED(dummy) } |
||||
|
||||
public Q_SLOTS: |
||||
bool sendMessage(const QString &message, int timeout = 5000); |
||||
void activateWindow(); |
||||
|
||||
|
||||
Q_SIGNALS: |
||||
void messageReceived(const QString &message); |
||||
|
||||
|
||||
private: |
||||
void sysInit(const QString &appId = QString()); |
||||
QtLocalPeer *peer; |
||||
QWidget *actWin; |
||||
}; |
||||
|
||||
#endif // QTSINGLEAPPLICATION_H
|
||||
@ -1,17 +0,0 @@ |
||||
include(../common.pri) |
||||
INCLUDEPATH += $$PWD |
||||
DEPENDPATH += $$PWD |
||||
QT *= network |
||||
greaterThan(QT_MAJOR_VERSION, 4): QT *= widgets |
||||
|
||||
qtsingleapplication-uselib:!qtsingleapplication-buildlib { |
||||
LIBS += -L$$QTSINGLEAPPLICATION_LIBDIR -l$$QTSINGLEAPPLICATION_LIBNAME |
||||
} else { |
||||
SOURCES += $$PWD/qtsingleapplication.cpp $$PWD/qtlocalpeer.cpp |
||||
HEADERS += $$PWD/qtsingleapplication.h $$PWD/qtlocalpeer.h |
||||
} |
||||
|
||||
win32 { |
||||
contains(TEMPLATE, lib):contains(CONFIG, shared):DEFINES += QT_QTSINGLEAPPLICATION_EXPORT |
||||
else:qtsingleapplication-uselib:DEFINES += QT_QTSINGLEAPPLICATION_IMPORT |
||||
} |
||||
@ -1,149 +0,0 @@ |
||||
/****************************************************************************
|
||||
** |
||||
** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies). |
||||
** Contact: http://www.qt-project.org/legal
|
||||
** |
||||
** This file is part of the Qt Solutions component. |
||||
** |
||||
** $QT_BEGIN_LICENSE:BSD$ |
||||
** You may use this file under the terms of the BSD license as follows: |
||||
** |
||||
** "Redistribution and use in source and binary forms, with or without |
||||
** modification, are permitted provided that the following conditions are |
||||
** met: |
||||
** * Redistributions of source code must retain the above copyright |
||||
** notice, this list of conditions and the following disclaimer. |
||||
** * Redistributions in binary form must reproduce the above copyright |
||||
** notice, this list of conditions and the following disclaimer in |
||||
** the documentation and/or other materials provided with the |
||||
** distribution. |
||||
** * Neither the name of Digia Plc and its Subsidiary(-ies) nor the names |
||||
** of its contributors may be used to endorse or promote products derived |
||||
** from this software without specific prior written permission. |
||||
** |
||||
** |
||||
** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
||||
** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
||||
** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
||||
** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
||||
** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
||||
** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
||||
** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
||||
** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
||||
** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
||||
** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
||||
** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE." |
||||
** |
||||
** $QT_END_LICENSE$ |
||||
** |
||||
****************************************************************************/ |
||||
|
||||
|
||||
#include "qtsinglecoreapplication.h" |
||||
#include "qtlocalpeer.h" |
||||
|
||||
/*!
|
||||
\class QtSingleCoreApplication qtsinglecoreapplication.h |
||||
\brief A variant of the QtSingleApplication class for non-GUI applications. |
||||
|
||||
This class is a variant of QtSingleApplication suited for use in |
||||
console (non-GUI) applications. It is an extension of |
||||
QCoreApplication (instead of QApplication). It does not require |
||||
the QtGui library. |
||||
|
||||
The API and usage is identical to QtSingleApplication, except that |
||||
functions relating to the "activation window" are not present, for |
||||
obvious reasons. Please refer to the QtSingleApplication |
||||
documentation for explanation of the usage. |
||||
|
||||
A QtSingleCoreApplication instance can communicate to a |
||||
QtSingleApplication instance if they share the same application |
||||
id. Hence, this class can be used to create a light-weight |
||||
command-line tool that sends commands to a GUI application. |
||||
|
||||
\sa QtSingleApplication |
||||
*/ |
||||
|
||||
/*!
|
||||
Creates a QtSingleCoreApplication object. The application identifier |
||||
will be QCoreApplication::applicationFilePath(). \a argc and \a |
||||
argv are passed on to the QCoreAppliation constructor. |
||||
*/ |
||||
|
||||
QtSingleCoreApplication::QtSingleCoreApplication(int &argc, char **argv) |
||||
: QCoreApplication(argc, argv) |
||||
{ |
||||
peer = new QtLocalPeer(this); |
||||
connect(peer, SIGNAL(messageReceived(const QString&)), SIGNAL(messageReceived(const QString&))); |
||||
} |
||||
|
||||
|
||||
/*!
|
||||
Creates a QtSingleCoreApplication object with the application |
||||
identifier \a appId. \a argc and \a argv are passed on to the |
||||
QCoreAppliation constructor. |
||||
*/ |
||||
QtSingleCoreApplication::QtSingleCoreApplication(const QString &appId, int &argc, char **argv) |
||||
: QCoreApplication(argc, argv) |
||||
{ |
||||
peer = new QtLocalPeer(this, appId); |
||||
connect(peer, SIGNAL(messageReceived(const QString&)), SIGNAL(messageReceived(const QString&))); |
||||
} |
||||
|
||||
|
||||
/*!
|
||||
Returns true if another instance of this application is running; |
||||
otherwise false. |
||||
|
||||
This function does not find instances of this application that are |
||||
being run by a different user (on Windows: that are running in |
||||
another session). |
||||
|
||||
\sa sendMessage() |
||||
*/ |
||||
|
||||
bool QtSingleCoreApplication::isRunning() |
||||
{ |
||||
return peer->isClient(); |
||||
} |
||||
|
||||
|
||||
/*!
|
||||
Tries to send the text \a message to the currently running |
||||
instance. The QtSingleCoreApplication object in the running instance |
||||
will emit the messageReceived() signal when it receives the |
||||
message. |
||||
|
||||
This function returns true if the message has been sent to, and |
||||
processed by, the current instance. If there is no instance |
||||
currently running, or if the running instance fails to process the |
||||
message within \a timeout milliseconds, this function return false. |
||||
|
||||
\sa isRunning(), messageReceived() |
||||
*/ |
||||
|
||||
bool QtSingleCoreApplication::sendMessage(const QString &message, int timeout) |
||||
{ |
||||
return peer->sendMessage(message, timeout); |
||||
} |
||||
|
||||
|
||||
/*!
|
||||
Returns the application identifier. Two processes with the same |
||||
identifier will be regarded as instances of the same application. |
||||
*/ |
||||
|
||||
QString QtSingleCoreApplication::id() const |
||||
{ |
||||
return peer->applicationId(); |
||||
} |
||||
|
||||
|
||||
/*!
|
||||
\fn void QtSingleCoreApplication::messageReceived(const QString& message) |
||||
|
||||
This signal is emitted when the current instance receives a \a |
||||
message from another instance of this application. |
||||
|
||||
\sa sendMessage() |
||||
*/ |
||||
@ -1,71 +0,0 @@ |
||||
/****************************************************************************
|
||||
** |
||||
** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies). |
||||
** Contact: http://www.qt-project.org/legal
|
||||
** |
||||
** This file is part of the Qt Solutions component. |
||||
** |
||||
** $QT_BEGIN_LICENSE:BSD$ |
||||
** You may use this file under the terms of the BSD license as follows: |
||||
** |
||||
** "Redistribution and use in source and binary forms, with or without |
||||
** modification, are permitted provided that the following conditions are |
||||
** met: |
||||
** * Redistributions of source code must retain the above copyright |
||||
** notice, this list of conditions and the following disclaimer. |
||||
** * Redistributions in binary form must reproduce the above copyright |
||||
** notice, this list of conditions and the following disclaimer in |
||||
** the documentation and/or other materials provided with the |
||||
** distribution. |
||||
** * Neither the name of Digia Plc and its Subsidiary(-ies) nor the names |
||||
** of its contributors may be used to endorse or promote products derived |
||||
** from this software without specific prior written permission. |
||||
** |
||||
** |
||||
** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
||||
** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
||||
** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
||||
** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
||||
** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
||||
** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
||||
** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
||||
** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
||||
** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
||||
** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
||||
** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE." |
||||
** |
||||
** $QT_END_LICENSE$ |
||||
** |
||||
****************************************************************************/ |
||||
|
||||
#ifndef QTSINGLECOREAPPLICATION_H |
||||
#define QTSINGLECOREAPPLICATION_H |
||||
|
||||
#include <QCoreApplication> |
||||
|
||||
class QtLocalPeer; |
||||
|
||||
class QtSingleCoreApplication : public QCoreApplication |
||||
{ |
||||
Q_OBJECT |
||||
|
||||
public: |
||||
QtSingleCoreApplication(int &argc, char **argv); |
||||
QtSingleCoreApplication(const QString &id, int &argc, char **argv); |
||||
|
||||
bool isRunning(); |
||||
QString id() const; |
||||
|
||||
public Q_SLOTS: |
||||
bool sendMessage(const QString &message, int timeout = 5000); |
||||
|
||||
|
||||
Q_SIGNALS: |
||||
void messageReceived(const QString &message); |
||||
|
||||
|
||||
private: |
||||
QtLocalPeer* peer; |
||||
}; |
||||
|
||||
#endif // QTSINGLECOREAPPLICATION_H
|
||||
@ -1,10 +0,0 @@ |
||||
INCLUDEPATH += $$PWD |
||||
DEPENDPATH += $$PWD |
||||
HEADERS += $$PWD/qtsinglecoreapplication.h $$PWD/qtlocalpeer.h |
||||
SOURCES += $$PWD/qtsinglecoreapplication.cpp $$PWD/qtlocalpeer.cpp |
||||
|
||||
QT *= network |
||||
|
||||
win32:contains(TEMPLATE, lib):contains(CONFIG, shared) { |
||||
DEFINES += QT_QTSINGLECOREAPPLICATION_EXPORT=__declspec(dllexport) |
||||
} |
||||
@ -0,0 +1,306 @@ |
||||
Changelog |
||||
========= |
||||
|
||||
If by accident I have forgotten to credit someone in the CHANGELOG, email me and I will fix it. |
||||
|
||||
|
||||
__3.3.1__ |
||||
--------- |
||||
|
||||
* Added support for _AppImage_ dynamic executable paths. - _Michael Klein_ |
||||
|
||||
__3.3.0__ |
||||
--------- |
||||
|
||||
* Fixed message fragmentation issue causing crashes and incorrectly / inconsistently received messages. - _Nils Jeisecke_ |
||||
|
||||
__3.2.0__ |
||||
--------- |
||||
|
||||
* Added support for Qt 6 - _Jonas Kvinge_ |
||||
* Fixed warning in `Qt 5.9` with `min`/`max` functions on Windows - _Nick Korotysh_ |
||||
* Fix return value of connectToPrimary() when connect is successful - _Jonas Kvinge_ |
||||
* Fix build issue with MinGW GCC pedantic mode - _Iakov Kirilenko_ |
||||
* Fixed conversion from `int` to `quint32` and Clang Tidy warnings - _Hennadii Chernyshchyk_ |
||||
|
||||
__3.1.5__ |
||||
--------- |
||||
|
||||
* Improved library stability in edge cases and very rapid process initialisation |
||||
* Fixed Bug where the shared memory block may have been modified without a lock |
||||
* Fixed Bug causing `instanceStarted()` to not get emitted when a second instance |
||||
has been started before the primary has initiated it's `QLocalServer`. |
||||
|
||||
__3.1.4__ |
||||
--------- |
||||
* Officially supporting and build-testing against Qt 5.15 |
||||
* Fixed an MSVC C4996 warning that suggests using `strncpy_s`. |
||||
|
||||
_Hennadii Chernyshchyk_ |
||||
|
||||
__3.1.3.1__ |
||||
--------- |
||||
* CMake build system improvements |
||||
* Fixed Clang Tidy warnings |
||||
|
||||
_Hennadii Chernyshchyk_ |
||||
|
||||
__3.1.3__ |
||||
--------- |
||||
* Improved `CMakeLists.txt` |
||||
|
||||
_Hennadii Chernyshchyk_ |
||||
|
||||
__3.1.2__ |
||||
--------- |
||||
|
||||
* Fix a crash when exiting an application on Android and iOS |
||||
|
||||
_Emeric Grange_ |
||||
|
||||
__3.1.1a__ |
||||
---------- |
||||
|
||||
* Added currentUser() method that returns the user the current instance is running as. |
||||
|
||||
_Leander Schulten_ |
||||
|
||||
__3.1.0a__ |
||||
---------- |
||||
|
||||
* Added primaryUser() method that returns the user the primary instance is running as. |
||||
|
||||
__3.0.19__ |
||||
---------- |
||||
|
||||
* Fixed code warning for depricated functions in Qt 5.10 related to `QTime` and `qrand()`. |
||||
|
||||
_Hennadii Chernyshchyk_ |
||||
_Anton Filimonov_ |
||||
_Jonas Kvinge_ |
||||
|
||||
__3.0.18__ |
||||
---------- |
||||
|
||||
* Fallback to standard QApplication class on iOS and Android systems where |
||||
the library is not supported. |
||||
|
||||
* Added Build CI tests to verify the library builds successfully on Linux, Windows and MacOS across multiple Qt versions. |
||||
|
||||
_Anton Filimonov_ |
||||
|
||||
__3.0.17__ |
||||
---------- |
||||
|
||||
* Fixed compilation warning/error caused by `geteuid()` on unix based systems. |
||||
|
||||
_Iakov Kirilenko_ |
||||
|
||||
* Added CMake support |
||||
|
||||
_Hennadii Chernyshchyk_ |
||||
|
||||
__3.0.16__ |
||||
---------- |
||||
|
||||
* Use geteuid and getpwuid to get username on Unix, fallback to environment variable. |
||||
|
||||
_Jonas Kvinge_ |
||||
|
||||
__3.0.15__ |
||||
---------- |
||||
|
||||
* Bug Fix: sendMessage() might return false even though data was actually written. |
||||
|
||||
_Jonas Kvinge_ |
||||
|
||||
__3.0.14__ |
||||
---------- |
||||
|
||||
* Fixed uninitialised variables in the `SingleApplicationPrivate` constructor. |
||||
|
||||
__3.0.13a__ |
||||
---------- |
||||
|
||||
* Process socket events asynchronously |
||||
* Fix undefined variable error on Windows |
||||
|
||||
_Francis Giraldeau_ |
||||
|
||||
__3.0.12a__ |
||||
---------- |
||||
|
||||
* Removed signal handling. |
||||
|
||||
__3.0.11a__ |
||||
---------- |
||||
|
||||
* Fixed bug where the message sent by the second process was not received |
||||
correctly when the message is sent immediately following a connection. |
||||
|
||||
_Francis Giraldeau_ |
||||
|
||||
* Refactored code and implemented shared memory block consistency checks |
||||
via `qChecksum()` (CRC-16). |
||||
* Explicit `qWarning` and `qCritical` when the library is unable to initialise |
||||
correctly. |
||||
|
||||
__3.0.10__ |
||||
---------- |
||||
|
||||
* Removed C style casts and eliminated all clang warnings. Fixed `instanceId` |
||||
reading from only one byte in the message deserialization. Cleaned up |
||||
serialization code using `QDataStream`. Changed connection type to use |
||||
`quint8 enum` rather than `char`. |
||||
* Renamed `SingleAppConnectionType` to `ConnectionType`. Added initialization |
||||
values to all `ConnectionType` enum cases. |
||||
|
||||
_Jedidiah Buck McCready_ |
||||
|
||||
__3.0.9__ |
||||
--------- |
||||
|
||||
* Added SingleApplicationPrivate::primaryPid() as a solution to allow |
||||
bringing the primary window of an application to the foreground on |
||||
Windows. |
||||
|
||||
_Eelco van Dam from Peacs BV_ |
||||
|
||||
__3.0.8__ |
||||
--------- |
||||
|
||||
* Bug fix - changed QApplication::instance() to QCoreApplication::instance() |
||||
|
||||
_Evgeniy Bazhenov_ |
||||
|
||||
__3.0.7a__ |
||||
---------- |
||||
|
||||
* Fixed compilation error with Mingw32 in MXE thanks to Vitaly Tonkacheyev. |
||||
* Removed QMutex used for thread safe behaviour. The implementation now uses |
||||
QCoreApplication::instance() to get an instance to SingleApplication for |
||||
memory deallocation. |
||||
|
||||
__3.0.6a__ |
||||
---------- |
||||
|
||||
* Reverted GetUserName API usage on Windows. Fixed bug with missing library. |
||||
* Fixed bug in the Calculator example, preventing it's window to be raised |
||||
on Windows. |
||||
|
||||
Special thanks to Charles Gunawan. |
||||
|
||||
__3.0.5a__ |
||||
---------- |
||||
|
||||
* Fixed a memory leak in the SingleApplicationPrivate destructor. |
||||
|
||||
_Sergei Moiseev_ |
||||
|
||||
__3.0.4a__ |
||||
---------- |
||||
|
||||
* Fixed shadow and uninitialised variable warnings. |
||||
|
||||
_Paul Walmsley_ |
||||
|
||||
__3.0.3a__ |
||||
---------- |
||||
|
||||
* Removed Microsoft Windows specific code for getting username due to |
||||
multiple problems and compiler differences on Windows platforms. On |
||||
Windows the shared memory block in User mode now includes the user's |
||||
home path (which contains the user's username). |
||||
|
||||
* Explicitly getting absolute path of the user's home directory as on Unix |
||||
a relative path (`~`) may be returned. |
||||
|
||||
__3.0.2a__ |
||||
---------- |
||||
|
||||
* Fixed bug on Windows when username containing wide characters causes the |
||||
library to crash. |
||||
|
||||
_Le Liu_ |
||||
|
||||
__3.0.1a__ |
||||
---------- |
||||
|
||||
* Allows the application path and version to be excluded from the server name |
||||
hash. The following flags were added for this purpose: |
||||
* `SingleApplication::Mode::ExcludeAppVersion` |
||||
* `SingleApplication::Mode::ExcludeAppPath` |
||||
* Allow a non elevated process to connect to a local server created by an |
||||
elevated process run by the same user on Windows |
||||
* Fixes a problem with upper case letters in paths on Windows |
||||
|
||||
_Le Liu_ |
||||
|
||||
__v3.0a__ |
||||
--------- |
||||
|
||||
* Deprecated secondary instances count. |
||||
* Added a sendMessage() method to send a message to the primary instance. |
||||
* Added a receivedMessage() signal, emitted when a message is received from a |
||||
secondary instance. |
||||
* The SingleApplication constructor's third parameter is now a bool |
||||
specifying if the current instance should be allowed to run as a secondary |
||||
instance if there is already a primary instance. |
||||
* The SingleApplication constructor accept a fourth parameter specifying if |
||||
the SingleApplication block should be User-wide or System-wide. |
||||
* SingleApplication no longer relies on `applicationName` and |
||||
`organizationName` to be set. It instead concatenates all of the following |
||||
data and computes a `SHA256` hash which is used as the key of the |
||||
`QSharedMemory` block and the `QLocalServer`. Since at least |
||||
`applicationFilePath` is always present there is no need to explicitly set |
||||
any of the following prior to initialising `SingleApplication`. |
||||
* `QCoreApplication::applicationName` |
||||
* `QCoreApplication::applicationVersion` |
||||
* `QCoreApplication::applicationFilePath` |
||||
* `QCoreApplication::organizationName` |
||||
* `QCoreApplication::organizationDomain` |
||||
* User name or home directory path if in User mode |
||||
* The primary instance is no longer notified when a secondary instance had |
||||
been started by default. A `Mode` flag for this feature exists. |
||||
* Added `instanceNumber()` which represents a unique identifier for each |
||||
secondary instance started. When called from the primary instance will |
||||
return `0`. |
||||
|
||||
__v2.4__ |
||||
-------- |
||||
|
||||
* Stability improvements |
||||
* Support for secondary instances. |
||||
* The library now recovers safely after the primary process has crashed |
||||
and the shared memory had not been deleted. |
||||
|
||||
__v2.3__ |
||||
-------- |
||||
|
||||
* Improved pimpl design and inheritance safety. |
||||
|
||||
_Vladislav Pyatnichenko_ |
||||
|
||||
__v2.2__ |
||||
-------- |
||||
|
||||
* The `QAPPLICATION_CLASS` macro can now be defined in the file including the |
||||
Single Application header or with a `DEFINES+=` statement in the project file. |
||||
|
||||
__v2.1__ |
||||
-------- |
||||
|
||||
* A race condition can no longer occur when starting two processes nearly |
||||
simultaneously. |
||||
|
||||
Fix issue [#3](https://github.com/itay-grudev/SingleApplication/issues/3) |
||||
|
||||
__v2.0__ |
||||
-------- |
||||
|
||||
* SingleApplication is now being passed a reference to `argc` instead of a |
||||
copy. |
||||
|
||||
Fix issue [#1](https://github.com/itay-grudev/SingleApplication/issues/1) |
||||
|
||||
* Improved documentation. |
||||
@ -0,0 +1,40 @@ |
||||
cmake_minimum_required(VERSION 3.7.0) |
||||
|
||||
project(SingleApplication LANGUAGES CXX) |
||||
|
||||
set(CMAKE_AUTOMOC ON) |
||||
|
||||
add_library(${PROJECT_NAME} STATIC |
||||
singleapplication.cpp |
||||
singleapplication_p.cpp |
||||
) |
||||
add_library(${PROJECT_NAME}::${PROJECT_NAME} ALIAS ${PROJECT_NAME}) |
||||
|
||||
if(NOT QT_DEFAULT_MAJOR_VERSION) |
||||
set(QT_DEFAULT_MAJOR_VERSION 5 CACHE STRING "Qt version to use (5 or 6), defaults to 5") |
||||
endif() |
||||
|
||||
# Find dependencies |
||||
set(QT_COMPONENTS Core Network) |
||||
set(QT_LIBRARIES Qt${QT_DEFAULT_MAJOR_VERSION}::Core Qt${QT_DEFAULT_MAJOR_VERSION}::Network) |
||||
|
||||
if(QAPPLICATION_CLASS STREQUAL QApplication) |
||||
list(APPEND QT_COMPONENTS Widgets) |
||||
list(APPEND QT_LIBRARIES Qt${QT_DEFAULT_MAJOR_VERSION}::Widgets) |
||||
elseif(QAPPLICATION_CLASS STREQUAL QGuiApplication) |
||||
list(APPEND QT_COMPONENTS Gui) |
||||
list(APPEND QT_LIBRARIES Qt${QT_DEFAULT_MAJOR_VERSION}::Gui) |
||||
else() |
||||
set(QAPPLICATION_CLASS QCoreApplication) |
||||
endif() |
||||
|
||||
find_package(Qt${QT_DEFAULT_MAJOR_VERSION} COMPONENTS ${QT_COMPONENTS} REQUIRED) |
||||
|
||||
target_link_libraries(${PROJECT_NAME} PUBLIC ${QT_LIBRARIES}) |
||||
|
||||
if(WIN32) |
||||
target_link_libraries(${PROJECT_NAME} PRIVATE advapi32) |
||||
endif() |
||||
|
||||
target_compile_definitions(${PROJECT_NAME} PUBLIC QAPPLICATION_CLASS=${QAPPLICATION_CLASS}) |
||||
target_include_directories(${PROJECT_NAME} PUBLIC ${CMAKE_CURRENT_SOURCE_DIR}) |
||||
@ -0,0 +1,24 @@ |
||||
The MIT License (MIT) |
||||
|
||||
Copyright (c) Itay Grudev 2015 - 2020 |
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a copy |
||||
of this software and associated documentation files (the "Software"), to deal |
||||
in the Software without restriction, including without limitation the rights |
||||
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell |
||||
copies of the Software, and to permit persons to whom the Software is |
||||
furnished to do so, subject to the following conditions: |
||||
|
||||
The above copyright notice and this permission notice shall be included in |
||||
all copies or substantial portions of the Software. |
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE |
||||
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, |
||||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN |
||||
THE SOFTWARE. |
||||
|
||||
Note: Some of the examples include code not distributed under the terms of the |
||||
MIT License. |
||||
@ -0,0 +1,305 @@ |
||||
SingleApplication |
||||
================= |
||||
[](https://github.com/itay-grudev/SingleApplication/actions) |
||||
|
||||
This is a replacement of the QtSingleApplication for `Qt5` and `Qt6`. |
||||
|
||||
Keeps the Primary Instance of your Application and kills each subsequent |
||||
instances. It can (if enabled) spawn secondary (non-related to the primary) |
||||
instances and can send data to the primary instance from secondary instances. |
||||
|
||||
Usage |
||||
----- |
||||
|
||||
The `SingleApplication` class inherits from whatever `Q[Core|Gui]Application` |
||||
class you specify via the `QAPPLICATION_CLASS` macro (`QCoreApplication` is the |
||||
default). Further usage is similar to the use of the `Q[Core|Gui]Application` |
||||
classes. |
||||
|
||||
You can use the library as if you use any other `QCoreApplication` derived |
||||
class: |
||||
|
||||
```cpp |
||||
#include <QApplication> |
||||
#include <SingleApplication.h> |
||||
|
||||
int main( int argc, char* argv[] ) |
||||
{ |
||||
SingleApplication app( argc, argv ); |
||||
|
||||
return app.exec(); |
||||
} |
||||
``` |
||||
|
||||
To include the library files I would recommend that you add it as a git |
||||
submodule to your project. Here is how: |
||||
|
||||
```bash |
||||
git submodule add git@github.com:itay-grudev/SingleApplication.git singleapplication |
||||
``` |
||||
|
||||
**Qmake:** |
||||
|
||||
Then include the `singleapplication.pri` file in your `.pro` project file. |
||||
|
||||
```qmake |
||||
include(singleapplication/singleapplication.pri) |
||||
DEFINES += QAPPLICATION_CLASS=QApplication |
||||
``` |
||||
|
||||
**CMake:** |
||||
|
||||
Then include the subdirectory in your `CMakeLists.txt` project file. |
||||
|
||||
```cmake |
||||
set(QAPPLICATION_CLASS QApplication CACHE STRING "Inheritance class for SingleApplication") |
||||
add_subdirectory(src/third-party/singleapplication) |
||||
target_link_libraries(${PROJECT_NAME} SingleApplication::SingleApplication) |
||||
``` |
||||
|
||||
|
||||
The library sets up a `QLocalServer` and a `QSharedMemory` block. The first |
||||
instance of your Application is your Primary Instance. It would check if the |
||||
shared memory block exists and if not it will start a `QLocalServer` and listen |
||||
for connections. Each subsequent instance of your application would check if the |
||||
shared memory block exists and if it does, it will connect to the QLocalServer |
||||
to notify the primary instance that a new instance had been started, after which |
||||
it would terminate with status code `0`. In the Primary Instance |
||||
`SingleApplication` would emit the `instanceStarted()` signal upon detecting |
||||
that a new instance had been started. |
||||
|
||||
The library uses `stdlib` to terminate the program with the `exit()` function. |
||||
|
||||
Also don't forget to specify which `QCoreApplication` class your app is using if it |
||||
is not `QCoreApplication` as in examples above. |
||||
|
||||
The `Instance Started` signal |
||||
----------------------------- |
||||
|
||||
The SingleApplication class implements a `instanceStarted()` signal. You can |
||||
bind to that signal to raise your application's window when a new instance had |
||||
been started, for example. |
||||
|
||||
```cpp |
||||
// window is a QWindow instance |
||||
QObject::connect( |
||||
&app, |
||||
&SingleApplication::instanceStarted, |
||||
&window, |
||||
&QWindow::raise |
||||
); |
||||
``` |
||||
|
||||
Using `SingleApplication::instance()` is a neat way to get the |
||||
`SingleApplication` instance for binding to it's signals anywhere in your |
||||
program. |
||||
|
||||
__Note:__ On Windows the ability to bring the application windows to the |
||||
foreground is restricted. See [Windows specific implementations](Windows.md) |
||||
for a workaround and an example implementation. |
||||
|
||||
|
||||
Secondary Instances |
||||
------------------- |
||||
|
||||
If you want to be able to launch additional Secondary Instances (not related to |
||||
your Primary Instance) you have to enable that with the third parameter of the |
||||
`SingleApplication` constructor. The default is `false` meaning no Secondary |
||||
Instances. Here is an example of how you would start a Secondary Instance send |
||||
a message with the command line arguments to the primary instance and then shut |
||||
down. |
||||
|
||||
```cpp |
||||
int main(int argc, char *argv[]) |
||||
{ |
||||
SingleApplication app( argc, argv, true ); |
||||
|
||||
if( app.isSecondary() ) { |
||||
app.sendMessage( app.arguments().join(' ')).toUtf8() ); |
||||
app.exit( 0 ); |
||||
} |
||||
|
||||
return app.exec(); |
||||
} |
||||
``` |
||||
|
||||
*__Note:__ A secondary instance won't cause the emission of the |
||||
`instanceStarted()` signal by default. See `SingleApplication::Mode` for more |
||||
details.* |
||||
|
||||
You can check whether your instance is a primary or secondary with the following |
||||
methods: |
||||
|
||||
```cpp |
||||
app.isPrimary(); |
||||
// or |
||||
app.isSecondary(); |
||||
``` |
||||
|
||||
*__Note:__ If your Primary Instance is terminated a newly launched instance |
||||
will replace the Primary one even if the Secondary flag has been set.* |
||||
|
||||
Examples |
||||
-------- |
||||
|
||||
There are three examples provided in this repository: |
||||
|
||||
* Basic example that prevents a secondary instance from starting [`examples/basic`](https://github.com/itay-grudev/SingleApplication/tree/master/examples/basic) |
||||
* An example of a graphical application raising it's parent window [`examples/calculator`](https://github.com/itay-grudev/SingleApplication/tree/master/examples/calculator) |
||||
* A console application sending the primary instance it's command line parameters [`examples/sending_arguments`](https://github.com/itay-grudev/SingleApplication/tree/master/examples/sending_arguments) |
||||
|
||||
API |
||||
--- |
||||
|
||||
### Members |
||||
|
||||
```cpp |
||||
SingleApplication::SingleApplication( int &argc, char *argv[], bool allowSecondary = false, Options options = Mode::User, int timeout = 100, QString userData = QString() ) |
||||
``` |
||||
|
||||
Depending on whether `allowSecondary` is set, this constructor may terminate |
||||
your app if there is already a primary instance running. Additional `Options` |
||||
can be specified to set whether the SingleApplication block should work |
||||
user-wide or system-wide. Additionally the `Mode::SecondaryNotification` may be |
||||
used to notify the primary instance whenever a secondary instance had been |
||||
started (disabled by default). `timeout` specifies the maximum time in |
||||
milliseconds to wait for blocking operations. Setting `userData` provides additional data that will isolate this instance from other instances that do not have the same (or any) user data set. |
||||
|
||||
*__Note:__ `argc` and `argv` may be changed as Qt removes arguments that it |
||||
recognizes.* |
||||
|
||||
*__Note:__ `Mode::SecondaryNotification` only works if set on both the primary |
||||
and the secondary instance.* |
||||
|
||||
*__Note:__ Operating system can restrict the shared memory blocks to the same |
||||
user, in which case the User/System modes will have no effect and the block will |
||||
be user wide.* |
||||
|
||||
--- |
||||
|
||||
```cpp |
||||
bool SingleApplication::sendMessage( QByteArray message, int timeout = 100 ) |
||||
``` |
||||
|
||||
Sends `message` to the Primary Instance. Uses `timeout` as a the maximum timeout |
||||
in milliseconds for blocking functions. Returns `true` if the message has been sent |
||||
successfully. If the message can't be sent or the function timeouts - returns `false`. |
||||
|
||||
--- |
||||
|
||||
```cpp |
||||
bool SingleApplication::isPrimary() |
||||
``` |
||||
|
||||
Returns if the instance is the primary instance. |
||||
|
||||
--- |
||||
|
||||
```cpp |
||||
bool SingleApplication::isSecondary() |
||||
``` |
||||
Returns if the instance is a secondary instance. |
||||
|
||||
--- |
||||
|
||||
```cpp |
||||
quint32 SingleApplication::instanceId() |
||||
``` |
||||
|
||||
Returns a unique identifier for the current instance. |
||||
|
||||
--- |
||||
|
||||
```cpp |
||||
qint64 SingleApplication::primaryPid() |
||||
``` |
||||
|
||||
Returns the process ID (PID) of the primary instance. |
||||
|
||||
--- |
||||
|
||||
```cpp |
||||
QString SingleApplication::primaryUser() |
||||
``` |
||||
|
||||
Returns the username the primary instance is running as. |
||||
|
||||
--- |
||||
|
||||
```cpp |
||||
QString SingleApplication::currentUser() |
||||
``` |
||||
|
||||
Returns the username the current instance is running as. |
||||
|
||||
### Signals |
||||
|
||||
```cpp |
||||
void SingleApplication::instanceStarted() |
||||
``` |
||||
|
||||
Triggered whenever a new instance had been started, except for secondary |
||||
instances if the `Mode::SecondaryNotification` flag is not specified. |
||||
|
||||
--- |
||||
|
||||
```cpp |
||||
void SingleApplication::receivedMessage( quint32 instanceId, QByteArray message ) |
||||
``` |
||||
|
||||
Triggered whenever there is a message received from a secondary instance. |
||||
|
||||
--- |
||||
|
||||
### Flags |
||||
|
||||
```cpp |
||||
enum SingleApplication::Mode |
||||
``` |
||||
|
||||
* `Mode::User` - The SingleApplication block should apply user wide. This adds |
||||
user specific data to the key used for the shared memory and server name. |
||||
This is the default functionality. |
||||
* `Mode::System` – The SingleApplication block applies system-wide. |
||||
* `Mode::SecondaryNotification` – Whether to trigger `instanceStarted()` even |
||||
whenever secondary instances are started. |
||||
* `Mode::ExcludeAppPath` – Excludes the application path from the server name |
||||
(and memory block) hash. |
||||
* `Mode::ExcludeAppVersion` – Excludes the application version from the server |
||||
name (and memory block) hash. |
||||
|
||||
*__Note:__ `Mode::SecondaryNotification` only works if set on both the primary |
||||
and the secondary instance.* |
||||
|
||||
*__Note:__ Operating system can restrict the shared memory blocks to the same |
||||
user, in which case the User/System modes will have no effect and the block will |
||||
be user wide.* |
||||
|
||||
--- |
||||
|
||||
Versioning |
||||
---------- |
||||
|
||||
Each major version introduces either very significant changes or is not |
||||
backwards compatible with the previous version. Minor versions only add |
||||
additional features, bug fixes or performance improvements and are backwards |
||||
compatible with the previous release. See [`CHANGELOG.md`](CHANGELOG.md) for |
||||
more details. |
||||
|
||||
Implementation |
||||
-------------- |
||||
|
||||
The library is implemented with a QSharedMemory block which is thread safe and |
||||
guarantees a race condition will not occur. It also uses a QLocalSocket to |
||||
notify the main process that a new instance had been spawned and thus invoke the |
||||
`instanceStarted()` signal and for messaging the primary instance. |
||||
|
||||
Additionally the library can recover from being forcefully killed on *nix |
||||
systems and will reset the memory block given that there are no other |
||||
instances running. |
||||
|
||||
License |
||||
------- |
||||
This library and it's supporting documentation are released under |
||||
`The MIT License (MIT)` with the exception of the Qt calculator examples which |
||||
is distributed under the BSD license. |
||||
@ -0,0 +1 @@ |
||||
#include "singleapplication.h" |
||||
@ -0,0 +1,46 @@ |
||||
Windows Specific Implementations |
||||
================================ |
||||
|
||||
Setting the foreground window |
||||
----------------------------- |
||||
|
||||
In the `instanceStarted()` example in the `README` we demonstrated how an |
||||
application can bring it's primary instance window whenever a second copy |
||||
of the application is started. |
||||
|
||||
On Windows the ability to bring the application windows to the foreground is |
||||
restricted, see [`AllowSetForegroundWindow()`][AllowSetForegroundWindow] for more |
||||
details. |
||||
|
||||
The background process (the primary instance) can bring its windows to the |
||||
foreground if it is allowed by the current foreground process (the secondary |
||||
instance). To bypass this `SingleApplication` must be initialized with the |
||||
`allowSecondary` parameter set to `true` and the `options` parameter must |
||||
include `Mode::SecondaryNotification`, See `SingleApplication::Mode` for more |
||||
details. |
||||
|
||||
Here is an example: |
||||
|
||||
```cpp |
||||
if( app.isSecondary() ) { |
||||
// This API requires LIBS += User32.lib to be added to the project |
||||
AllowSetForegroundWindow( DWORD( app.primaryPid() ) ); |
||||
} |
||||
|
||||
if( app.isPrimary() ) { |
||||
QObject::connect( |
||||
&app, |
||||
&SingleApplication::instanceStarted, |
||||
this, |
||||
&App::instanceStarted |
||||
); |
||||
} |
||||
``` |
||||
|
||||
```cpp |
||||
void App::instanceStarted() { |
||||
QApplication::setActiveWindow( [window/widget to set to the foreground] ); |
||||
} |
||||
``` |
||||
|
||||
[AllowSetForegroundWindow]: https://msdn.microsoft.com/en-us/library/windows/desktop/ms632668.aspx |
||||
@ -0,0 +1,271 @@ |
||||
// The MIT License (MIT)
|
||||
//
|
||||
// Copyright (c) Itay Grudev 2015 - 2020
|
||||
//
|
||||
// Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||
// of this software and associated documentation files (the "Software"), to deal
|
||||
// in the Software without restriction, including without limitation the rights
|
||||
// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||
// copies of the Software, and to permit persons to whom the Software is
|
||||
// furnished to do so, subject to the following conditions:
|
||||
//
|
||||
// The above copyright notice and this permission notice shall be included in
|
||||
// all copies or substantial portions of the Software.
|
||||
//
|
||||
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||
// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||
// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||
// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||
// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
||||
// THE SOFTWARE.
|
||||
|
||||
#include <QtCore/QElapsedTimer> |
||||
#include <QtCore/QByteArray> |
||||
#include <QtCore/QSharedMemory> |
||||
|
||||
#include "singleapplication.h" |
||||
#include "singleapplication_p.h" |
||||
|
||||
/**
|
||||
* @brief Constructor. Checks and fires up LocalServer or closes the program |
||||
* if another instance already exists |
||||
* @param argc |
||||
* @param argv |
||||
* @param allowSecondary Whether to enable secondary instance support |
||||
* @param options Optional flags to toggle specific behaviour |
||||
* @param timeout Maximum time blocking functions are allowed during app load |
||||
*/ |
||||
SingleApplication::SingleApplication( int &argc, char *argv[], bool allowSecondary, Options options, int timeout, const QString &userData ) |
||||
: app_t( argc, argv ), d_ptr( new SingleApplicationPrivate( this ) ) |
||||
{ |
||||
Q_D( SingleApplication ); |
||||
|
||||
#if defined(Q_OS_ANDROID) || defined(Q_OS_IOS) |
||||
// On Android and iOS since the library is not supported fallback to
|
||||
// standard QApplication behaviour by simply returning at this point.
|
||||
qWarning() << "SingleApplication is not supported on Android and iOS systems."; |
||||
return; |
||||
#endif |
||||
|
||||
// Store the current mode of the program
|
||||
d->options = options; |
||||
|
||||
// Add any unique user data
|
||||
if ( ! userData.isEmpty() ) |
||||
d->addAppData( userData ); |
||||
|
||||
// Generating an application ID used for identifying the shared memory
|
||||
// block and QLocalServer
|
||||
d->genBlockServerName(); |
||||
|
||||
// To mitigate QSharedMemory issues with large amount of processes
|
||||
// attempting to attach at the same time
|
||||
SingleApplicationPrivate::randomSleep(); |
||||
|
||||
#ifdef Q_OS_UNIX |
||||
// By explicitly attaching it and then deleting it we make sure that the
|
||||
// memory is deleted even after the process has crashed on Unix.
|
||||
d->memory = new QSharedMemory( d->blockServerName ); |
||||
d->memory->attach(); |
||||
delete d->memory; |
||||
#endif |
||||
// Guarantee thread safe behaviour with a shared memory block.
|
||||
d->memory = new QSharedMemory( d->blockServerName ); |
||||
|
||||
// Create a shared memory block
|
||||
if( d->memory->create( sizeof( InstancesInfo ) )){ |
||||
// Initialize the shared memory block
|
||||
if( ! d->memory->lock() ){ |
||||
qCritical() << "SingleApplication: Unable to lock memory block after create."; |
||||
abortSafely(); |
||||
} |
||||
d->initializeMemoryBlock(); |
||||
} else { |
||||
if( d->memory->error() == QSharedMemory::AlreadyExists ){ |
||||
// Attempt to attach to the memory segment
|
||||
if( ! d->memory->attach() ){ |
||||
qCritical() << "SingleApplication: Unable to attach to shared memory block."; |
||||
abortSafely(); |
||||
} |
||||
if( ! d->memory->lock() ){ |
||||
qCritical() << "SingleApplication: Unable to lock memory block after attach."; |
||||
abortSafely(); |
||||
} |
||||
} else { |
||||
qCritical() << "SingleApplication: Unable to create block."; |
||||
abortSafely(); |
||||
} |
||||
} |
||||
|
||||
auto *inst = static_cast<InstancesInfo*>( d->memory->data() ); |
||||
QElapsedTimer time; |
||||
time.start(); |
||||
|
||||
// Make sure the shared memory block is initialised and in consistent state
|
||||
while( true ){ |
||||
// If the shared memory block's checksum is valid continue
|
||||
if( d->blockChecksum() == inst->checksum ) break; |
||||
|
||||
// If more than 5s have elapsed, assume the primary instance crashed and
|
||||
// assume it's position
|
||||
if( time.elapsed() > 5000 ){ |
||||
qWarning() << "SingleApplication: Shared memory block has been in an inconsistent state from more than 5s. Assuming primary instance failure."; |
||||
d->initializeMemoryBlock(); |
||||
} |
||||
|
||||
// Otherwise wait for a random period and try again. The random sleep here
|
||||
// limits the probability of a collision between two racing apps and
|
||||
// allows the app to initialise faster
|
||||
if( ! d->memory->unlock() ){ |
||||
qDebug() << "SingleApplication: Unable to unlock memory for random wait."; |
||||
qDebug() << d->memory->errorString(); |
||||
} |
||||
SingleApplicationPrivate::randomSleep(); |
||||
if( ! d->memory->lock() ){ |
||||
qCritical() << "SingleApplication: Unable to lock memory after random wait."; |
||||
abortSafely(); |
||||
} |
||||
} |
||||
|
||||
if( inst->primary == false ){ |
||||
d->startPrimary(); |
||||
if( ! d->memory->unlock() ){ |
||||
qDebug() << "SingleApplication: Unable to unlock memory after primary start."; |
||||
qDebug() << d->memory->errorString(); |
||||
} |
||||
return; |
||||
} |
||||
|
||||
// Check if another instance can be started
|
||||
if( allowSecondary ){ |
||||
d->startSecondary(); |
||||
if( d->options & Mode::SecondaryNotification ){ |
||||
d->connectToPrimary( timeout, SingleApplicationPrivate::SecondaryInstance ); |
||||
} |
||||
if( ! d->memory->unlock() ){ |
||||
qDebug() << "SingleApplication: Unable to unlock memory after secondary start."; |
||||
qDebug() << d->memory->errorString(); |
||||
} |
||||
return; |
||||
} |
||||
|
||||
if( ! d->memory->unlock() ){ |
||||
qDebug() << "SingleApplication: Unable to unlock memory at end of execution."; |
||||
qDebug() << d->memory->errorString(); |
||||
} |
||||
|
||||
d->connectToPrimary( timeout, SingleApplicationPrivate::NewInstance ); |
||||
|
||||
delete d; |
||||
|
||||
::exit( EXIT_SUCCESS ); |
||||
} |
||||
|
||||
SingleApplication::~SingleApplication() |
||||
{ |
||||
Q_D( SingleApplication ); |
||||
delete d; |
||||
} |
||||
|
||||
/**
|
||||
* Checks if the current application instance is primary. |
||||
* @return Returns true if the instance is primary, false otherwise. |
||||
*/ |
||||
bool SingleApplication::isPrimary() const |
||||
{ |
||||
Q_D( const SingleApplication ); |
||||
return d->server != nullptr; |
||||
} |
||||
|
||||
/**
|
||||
* Checks if the current application instance is secondary. |
||||
* @return Returns true if the instance is secondary, false otherwise. |
||||
*/ |
||||
bool SingleApplication::isSecondary() const |
||||
{ |
||||
Q_D( const SingleApplication ); |
||||
return d->server == nullptr; |
||||
} |
||||
|
||||
/**
|
||||
* Allows you to identify an instance by returning unique consecutive instance |
||||
* ids. It is reset when the first (primary) instance of your app starts and |
||||
* only incremented afterwards. |
||||
* @return Returns a unique instance id. |
||||
*/ |
||||
quint32 SingleApplication::instanceId() const |
||||
{ |
||||
Q_D( const SingleApplication ); |
||||
return d->instanceNumber; |
||||
} |
||||
|
||||
/**
|
||||
* Returns the OS PID (Process Identifier) of the process running the primary |
||||
* instance. Especially useful when SingleApplication is coupled with OS. |
||||
* specific APIs. |
||||
* @return Returns the primary instance PID. |
||||
*/ |
||||
qint64 SingleApplication::primaryPid() const |
||||
{ |
||||
Q_D( const SingleApplication ); |
||||
return d->primaryPid(); |
||||
} |
||||
|
||||
/**
|
||||
* Returns the username the primary instance is running as. |
||||
* @return Returns the username the primary instance is running as. |
||||
*/ |
||||
QString SingleApplication::primaryUser() const |
||||
{ |
||||
Q_D( const SingleApplication ); |
||||
return d->primaryUser(); |
||||
} |
||||
|
||||
/**
|
||||
* Returns the username the current instance is running as. |
||||
* @return Returns the username the current instance is running as. |
||||
*/ |
||||
QString SingleApplication::currentUser() const |
||||
{ |
||||
return SingleApplicationPrivate::getUsername(); |
||||
} |
||||
|
||||
/**
|
||||
* Sends message to the Primary Instance. |
||||
* @param message The message to send. |
||||
* @param timeout the maximum timeout in milliseconds for blocking functions. |
||||
* @return true if the message was sent successfuly, false otherwise. |
||||
*/ |
||||
bool SingleApplication::sendMessage( const QByteArray &message, int timeout ) |
||||
{ |
||||
Q_D( SingleApplication ); |
||||
|
||||
// Nobody to connect to
|
||||
if( isPrimary() ) return false; |
||||
|
||||
// Make sure the socket is connected
|
||||
if( ! d->connectToPrimary( timeout, SingleApplicationPrivate::Reconnect ) ) |
||||
return false; |
||||
|
||||
return d->writeConfirmedMessage( timeout, message ); |
||||
} |
||||
|
||||
/**
|
||||
* Cleans up the shared memory block and exits with a failure. |
||||
* This function halts program execution. |
||||
*/ |
||||
void SingleApplication::abortSafely() |
||||
{ |
||||
Q_D( SingleApplication ); |
||||
|
||||
qCritical() << "SingleApplication: " << d->memory->error() << d->memory->errorString(); |
||||
delete d; |
||||
::exit( EXIT_FAILURE ); |
||||
} |
||||
|
||||
QStringList SingleApplication::userData() const |
||||
{ |
||||
Q_D( const SingleApplication ); |
||||
return d->appData(); |
||||
} |
||||
@ -0,0 +1,154 @@ |
||||
// The MIT License (MIT)
|
||||
//
|
||||
// Copyright (c) Itay Grudev 2015 - 2018
|
||||
//
|
||||
// Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||
// of this software and associated documentation files (the "Software"), to deal
|
||||
// in the Software without restriction, including without limitation the rights
|
||||
// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||
// copies of the Software, and to permit persons to whom the Software is
|
||||
// furnished to do so, subject to the following conditions:
|
||||
//
|
||||
// The above copyright notice and this permission notice shall be included in
|
||||
// all copies or substantial portions of the Software.
|
||||
//
|
||||
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||
// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||
// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||
// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||
// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
||||
// THE SOFTWARE.
|
||||
|
||||
#ifndef SINGLE_APPLICATION_H |
||||
#define SINGLE_APPLICATION_H |
||||
|
||||
#include <QtCore/QtGlobal> |
||||
#include <QtNetwork/QLocalSocket> |
||||
|
||||
#ifndef QAPPLICATION_CLASS |
||||
#define QAPPLICATION_CLASS QCoreApplication |
||||
#endif |
||||
|
||||
#include QT_STRINGIFY(QAPPLICATION_CLASS) |
||||
|
||||
class SingleApplicationPrivate; |
||||
|
||||
/**
|
||||
* @brief The SingleApplication class handles multiple instances of the same |
||||
* Application |
||||
* @see QCoreApplication |
||||
*/ |
||||
class SingleApplication : public QAPPLICATION_CLASS |
||||
{ |
||||
Q_OBJECT |
||||
|
||||
using app_t = QAPPLICATION_CLASS; |
||||
|
||||
public: |
||||
/**
|
||||
* @brief Mode of operation of SingleApplication. |
||||
* Whether the block should be user-wide or system-wide and whether the |
||||
* primary instance should be notified when a secondary instance had been |
||||
* started. |
||||
* @note Operating system can restrict the shared memory blocks to the same |
||||
* user, in which case the User/System modes will have no effect and the |
||||
* block will be user wide. |
||||
* @enum |
||||
*/ |
||||
enum Mode { |
||||
User = 1 << 0, |
||||
System = 1 << 1, |
||||
SecondaryNotification = 1 << 2, |
||||
ExcludeAppVersion = 1 << 3, |
||||
ExcludeAppPath = 1 << 4 |
||||
}; |
||||
Q_DECLARE_FLAGS(Options, Mode) |
||||
|
||||
/**
|
||||
* @brief Intitializes a SingleApplication instance with argc command line |
||||
* arguments in argv |
||||
* @arg {int &} argc - Number of arguments in argv |
||||
* @arg {const char *[]} argv - Supplied command line arguments |
||||
* @arg {bool} allowSecondary - Whether to start the instance as secondary |
||||
* if there is already a primary instance. |
||||
* @arg {Mode} mode - Whether for the SingleApplication block to be applied |
||||
* User wide or System wide. |
||||
* @arg {int} timeout - Timeout to wait in milliseconds. |
||||
* @note argc and argv may be changed as Qt removes arguments that it |
||||
* recognizes |
||||
* @note Mode::SecondaryNotification only works if set on both the primary |
||||
* instance and the secondary instance. |
||||
* @note The timeout is just a hint for the maximum time of blocking |
||||
* operations. It does not guarantee that the SingleApplication |
||||
* initialisation will be completed in given time, though is a good hint. |
||||
* Usually 4*timeout would be the worst case (fail) scenario. |
||||
* @see See the corresponding QAPPLICATION_CLASS constructor for reference |
||||
*/ |
||||
explicit SingleApplication( int &argc, char *argv[], bool allowSecondary = false, Options options = Mode::User, int timeout = 1000, const QString &userData = {} ); |
||||
~SingleApplication() override; |
||||
|
||||
/**
|
||||
* @brief Returns if the instance is the primary instance |
||||
* @returns {bool} |
||||
*/ |
||||
bool isPrimary() const; |
||||
|
||||
/**
|
||||
* @brief Returns if the instance is a secondary instance |
||||
* @returns {bool} |
||||
*/ |
||||
bool isSecondary() const; |
||||
|
||||
/**
|
||||
* @brief Returns a unique identifier for the current instance |
||||
* @returns {qint32} |
||||
*/ |
||||
quint32 instanceId() const; |
||||
|
||||
/**
|
||||
* @brief Returns the process ID (PID) of the primary instance |
||||
* @returns {qint64} |
||||
*/ |
||||
qint64 primaryPid() const; |
||||
|
||||
/**
|
||||
* @brief Returns the username of the user running the primary instance |
||||
* @returns {QString} |
||||
*/ |
||||
QString primaryUser() const; |
||||
|
||||
/**
|
||||
* @brief Returns the username of the current user |
||||
* @returns {QString} |
||||
*/ |
||||
QString currentUser() const; |
||||
|
||||
/**
|
||||
* @brief Sends a message to the primary instance. Returns true on success. |
||||
* @param {int} timeout - Timeout for connecting |
||||
* @returns {bool} |
||||
* @note sendMessage() will return false if invoked from the primary |
||||
* instance. |
||||
*/ |
||||
bool sendMessage( const QByteArray &message, int timeout = 100 ); |
||||
|
||||
/**
|
||||
* @brief Get the set user data. |
||||
* @returns {QStringList} |
||||
*/ |
||||
QStringList userData() const; |
||||
|
||||
Q_SIGNALS: |
||||
void instanceStarted(); |
||||
void receivedMessage( quint32 instanceId, QByteArray message ); |
||||
|
||||
private: |
||||
SingleApplicationPrivate *d_ptr; |
||||
Q_DECLARE_PRIVATE(SingleApplication) |
||||
void abortSafely(); |
||||
}; |
||||
|
||||
Q_DECLARE_OPERATORS_FOR_FLAGS(SingleApplication::Options) |
||||
|
||||
#endif // SINGLE_APPLICATION_H
|
||||
@ -0,0 +1,20 @@ |
||||
QT += core network |
||||
CONFIG += c++11 |
||||
|
||||
HEADERS += $$PWD/SingleApplication \ |
||||
$$PWD/singleapplication.h \ |
||||
$$PWD/singleapplication_p.h |
||||
SOURCES += $$PWD/singleapplication.cpp \ |
||||
$$PWD/singleapplication_p.cpp |
||||
|
||||
INCLUDEPATH += $$PWD |
||||
|
||||
win32 { |
||||
msvc:LIBS += Advapi32.lib |
||||
gcc:LIBS += -ladvapi32 |
||||
} |
||||
|
||||
DISTFILES += \ |
||||
$$PWD/README.md \ |
||||
$$PWD/CHANGELOG.md \ |
||||
$$PWD/Windows.md |
||||
@ -0,0 +1,538 @@ |
||||
// The MIT License (MIT)
|
||||
//
|
||||
// Copyright (c) Itay Grudev 2015 - 2020
|
||||
//
|
||||
// Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||
// of this software and associated documentation files (the "Software"), to deal
|
||||
// in the Software without restriction, including without limitation the rights
|
||||
// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||
// copies of the Software, and to permit persons to whom the Software is
|
||||
// furnished to do so, subject to the following conditions:
|
||||
//
|
||||
// The above copyright notice and this permission notice shall be included in
|
||||
// all copies or substantial portions of the Software.
|
||||
//
|
||||
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||
// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||
// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||
// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||
// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
||||
// THE SOFTWARE.
|
||||
|
||||
//
|
||||
// W A R N I N G !!!
|
||||
// -----------------
|
||||
//
|
||||
// This file is not part of the SingleApplication API. It is used purely as an
|
||||
// implementation detail. This header file may change from version to
|
||||
// version without notice, or may even be removed.
|
||||
//
|
||||
|
||||
#include <cstdlib> |
||||
#include <cstddef> |
||||
|
||||
#include <QtCore/QDir> |
||||
#include <QtCore/QThread> |
||||
#include <QtCore/QByteArray> |
||||
#include <QtCore/QDataStream> |
||||
#include <QtCore/QElapsedTimer> |
||||
#include <QtCore/QCryptographicHash> |
||||
#include <QtNetwork/QLocalServer> |
||||
#include <QtNetwork/QLocalSocket> |
||||
|
||||
#if QT_VERSION >= QT_VERSION_CHECK(5, 10, 0) |
||||
#include <QtCore/QRandomGenerator> |
||||
#else |
||||
#include <QtCore/QDateTime> |
||||
#endif |
||||
|
||||
#include "singleapplication.h" |
||||
#include "singleapplication_p.h" |
||||
|
||||
#ifdef Q_OS_UNIX |
||||
#include <unistd.h> |
||||
#include <sys/types.h> |
||||
#include <pwd.h> |
||||
#endif |
||||
|
||||
#ifdef Q_OS_WIN |
||||
#ifndef NOMINMAX |
||||
#define NOMINMAX 1 |
||||
#endif |
||||
#include <windows.h> |
||||
#include <lmcons.h> |
||||
#endif |
||||
|
||||
SingleApplicationPrivate::SingleApplicationPrivate( SingleApplication *q_ptr ) |
||||
: q_ptr( q_ptr ) |
||||
{ |
||||
server = nullptr; |
||||
socket = nullptr; |
||||
memory = nullptr; |
||||
instanceNumber = 0; |
||||
} |
||||
|
||||
SingleApplicationPrivate::~SingleApplicationPrivate() |
||||
{ |
||||
if( socket != nullptr ){ |
||||
socket->close(); |
||||
delete socket; |
||||
} |
||||
|
||||
if( memory != nullptr ){ |
||||
memory->lock(); |
||||
auto *inst = static_cast<InstancesInfo*>(memory->data()); |
||||
if( server != nullptr ){ |
||||
server->close(); |
||||
delete server; |
||||
inst->primary = false; |
||||
inst->primaryPid = -1; |
||||
inst->primaryUser[0] = '\0'; |
||||
inst->checksum = blockChecksum(); |
||||
} |
||||
memory->unlock(); |
||||
|
||||
delete memory; |
||||
} |
||||
} |
||||
|
||||
QString SingleApplicationPrivate::getUsername() |
||||
{ |
||||
#ifdef Q_OS_WIN |
||||
wchar_t username[UNLEN + 1]; |
||||
// Specifies size of the buffer on input
|
||||
DWORD usernameLength = UNLEN + 1; |
||||
if( GetUserNameW( username, &usernameLength ) ) |
||||
return QString::fromWCharArray( username ); |
||||
#if QT_VERSION < QT_VERSION_CHECK(5, 10, 0) |
||||
return QString::fromLocal8Bit( qgetenv( "USERNAME" ) ); |
||||
#else |
||||
return qEnvironmentVariable( "USERNAME" ); |
||||
#endif |
||||
#endif |
||||
#ifdef Q_OS_UNIX |
||||
QString username; |
||||
uid_t uid = geteuid(); |
||||
struct passwd *pw = getpwuid( uid ); |
||||
if( pw ) |
||||
username = QString::fromLocal8Bit( pw->pw_name ); |
||||
if ( username.isEmpty() ){ |
||||
#if QT_VERSION < QT_VERSION_CHECK(5, 10, 0) |
||||
username = QString::fromLocal8Bit( qgetenv( "USER" ) ); |
||||
#else |
||||
username = qEnvironmentVariable( "USER" ); |
||||
#endif |
||||
} |
||||
return username; |
||||
#endif |
||||
} |
||||
|
||||
void SingleApplicationPrivate::genBlockServerName() |
||||
{ |
||||
QCryptographicHash appData( QCryptographicHash::Sha256 ); |
||||
appData.addData( "SingleApplication", 17 ); |
||||
appData.addData( SingleApplication::app_t::applicationName().toUtf8() ); |
||||
appData.addData( SingleApplication::app_t::organizationName().toUtf8() ); |
||||
appData.addData( SingleApplication::app_t::organizationDomain().toUtf8() ); |
||||
|
||||
if ( ! appDataList.isEmpty() ) |
||||
appData.addData( appDataList.join( "" ).toUtf8() ); |
||||
|
||||
if( ! (options & SingleApplication::Mode::ExcludeAppVersion) ){ |
||||
appData.addData( SingleApplication::app_t::applicationVersion().toUtf8() ); |
||||
} |
||||
|
||||
if( ! (options & SingleApplication::Mode::ExcludeAppPath) ){ |
||||
#if defined(Q_OS_WIN) |
||||
appData.addData( SingleApplication::app_t::applicationFilePath().toLower().toUtf8() ); |
||||
#elif defined(Q_OS_LINUX) |
||||
// If the application is running as an AppImage then the APPIMAGE env var should be used
|
||||
// instead of applicationPath() as each instance is launched with its own executable path
|
||||
const QByteArray appImagePath = qgetenv( "APPIMAGE" ); |
||||
if( appImagePath.isEmpty() ){ // Not running as AppImage: use path to executable file
|
||||
appData.addData( SingleApplication::app_t::applicationFilePath().toUtf8() ); |
||||
} else { // Running as AppImage: Use absolute path to AppImage file
|
||||
appData.addData( appImagePath ); |
||||
}; |
||||
#else |
||||
appData.addData( SingleApplication::app_t::applicationFilePath().toUtf8() ); |
||||
#endif |
||||
} |
||||
|
||||
// User level block requires a user specific data in the hash
|
||||
if( options & SingleApplication::Mode::User ){ |
||||
appData.addData( getUsername().toUtf8() ); |
||||
} |
||||
|
||||
// Replace the backslash in RFC 2045 Base64 [a-zA-Z0-9+/=] to comply with
|
||||
// server naming requirements.
|
||||
blockServerName = appData.result().toBase64().replace("/", "_"); |
||||
} |
||||
|
||||
void SingleApplicationPrivate::initializeMemoryBlock() const |
||||
{ |
||||
auto *inst = static_cast<InstancesInfo*>( memory->data() ); |
||||
inst->primary = false; |
||||
inst->secondary = 0; |
||||
inst->primaryPid = -1; |
||||
inst->primaryUser[0] = '\0'; |
||||
inst->checksum = blockChecksum(); |
||||
} |
||||
|
||||
void SingleApplicationPrivate::startPrimary() |
||||
{ |
||||
// Reset the number of connections
|
||||
auto *inst = static_cast <InstancesInfo*>( memory->data() ); |
||||
|
||||
inst->primary = true; |
||||
inst->primaryPid = QCoreApplication::applicationPid(); |
||||
qstrncpy( inst->primaryUser, getUsername().toUtf8().data(), sizeof(inst->primaryUser) ); |
||||
inst->checksum = blockChecksum(); |
||||
instanceNumber = 0; |
||||
// Successful creation means that no main process exists
|
||||
// So we start a QLocalServer to listen for connections
|
||||
QLocalServer::removeServer( blockServerName ); |
||||
server = new QLocalServer(); |
||||
|
||||
// Restrict access to the socket according to the
|
||||
// SingleApplication::Mode::User flag on User level or no restrictions
|
||||
if( options & SingleApplication::Mode::User ){ |
||||
server->setSocketOptions( QLocalServer::UserAccessOption ); |
||||
} else { |
||||
server->setSocketOptions( QLocalServer::WorldAccessOption ); |
||||
} |
||||
|
||||
server->listen( blockServerName ); |
||||
QObject::connect( |
||||
server, |
||||
&QLocalServer::newConnection, |
||||
this, |
||||
&SingleApplicationPrivate::slotConnectionEstablished |
||||
); |
||||
} |
||||
|
||||
void SingleApplicationPrivate::startSecondary() |
||||
{ |
||||
auto *inst = static_cast <InstancesInfo*>( memory->data() ); |
||||
|
||||
inst->secondary += 1; |
||||
inst->checksum = blockChecksum(); |
||||
instanceNumber = inst->secondary; |
||||
} |
||||
|
||||
bool SingleApplicationPrivate::connectToPrimary( int msecs, ConnectionType connectionType ) |
||||
{ |
||||
QElapsedTimer time; |
||||
time.start(); |
||||
|
||||
// Connect to the Local Server of the Primary Instance if not already
|
||||
// connected.
|
||||
if( socket == nullptr ){ |
||||
socket = new QLocalSocket(); |
||||
} |
||||
|
||||
if( socket->state() == QLocalSocket::ConnectedState ) return true; |
||||
|
||||
if( socket->state() != QLocalSocket::ConnectedState ){ |
||||
|
||||
while( true ){ |
||||
randomSleep(); |
||||
|
||||
if( socket->state() != QLocalSocket::ConnectingState ) |
||||
socket->connectToServer( blockServerName ); |
||||
|
||||
if( socket->state() == QLocalSocket::ConnectingState ){ |
||||
socket->waitForConnected( static_cast<int>(msecs - time.elapsed()) ); |
||||
} |
||||
|
||||
// If connected break out of the loop
|
||||
if( socket->state() == QLocalSocket::ConnectedState ) break; |
||||
|
||||
// If elapsed time since start is longer than the method timeout return
|
||||
if( time.elapsed() >= msecs ) return false; |
||||
} |
||||
} |
||||
|
||||
// Initialisation message according to the SingleApplication protocol
|
||||
QByteArray initMsg; |
||||
QDataStream writeStream(&initMsg, QIODevice::WriteOnly); |
||||
|
||||
#if (QT_VERSION >= QT_VERSION_CHECK(5, 6, 0)) |
||||
writeStream.setVersion(QDataStream::Qt_5_6); |
||||
#endif |
||||
|
||||
writeStream << blockServerName.toLatin1(); |
||||
writeStream << static_cast<quint8>(connectionType); |
||||
writeStream << instanceNumber; |
||||
#if QT_VERSION >= QT_VERSION_CHECK(6, 0, 0) |
||||
quint16 checksum = qChecksum(QByteArray(initMsg, static_cast<quint32>(initMsg.length()))); |
||||
#else |
||||
quint16 checksum = qChecksum(initMsg.constData(), static_cast<quint32>(initMsg.length())); |
||||
#endif |
||||
writeStream << checksum; |
||||
|
||||
return writeConfirmedMessage( static_cast<int>(msecs - time.elapsed()), initMsg ); |
||||
} |
||||
|
||||
void SingleApplicationPrivate::writeAck( QLocalSocket *sock ) { |
||||
sock->putChar('\n'); |
||||
} |
||||
|
||||
bool SingleApplicationPrivate::writeConfirmedMessage (int msecs, const QByteArray &msg) |
||||
{ |
||||
QElapsedTimer time; |
||||
time.start(); |
||||
|
||||
// Frame 1: The header indicates the message length that follows
|
||||
QByteArray header; |
||||
QDataStream headerStream(&header, QIODevice::WriteOnly); |
||||
|
||||
#if (QT_VERSION >= QT_VERSION_CHECK(5, 6, 0)) |
||||
headerStream.setVersion(QDataStream::Qt_5_6); |
||||
#endif |
||||
headerStream << static_cast <quint64>( msg.length() ); |
||||
|
||||
if( ! writeConfirmedFrame( static_cast<int>(msecs - time.elapsed()), header )) |
||||
return false; |
||||
|
||||
// Frame 2: The message
|
||||
return writeConfirmedFrame( static_cast<int>(msecs - time.elapsed()), msg ); |
||||
} |
||||
|
||||
bool SingleApplicationPrivate::writeConfirmedFrame( int msecs, const QByteArray &msg ) |
||||
{ |
||||
socket->write( msg ); |
||||
socket->flush(); |
||||
|
||||
bool result = socket->waitForReadyRead( msecs ); // await ack byte
|
||||
if (result) { |
||||
socket->read( 1 ); |
||||
return true; |
||||
} |
||||
|
||||
return false; |
||||
} |
||||
|
||||
quint16 SingleApplicationPrivate::blockChecksum() const |
||||
{ |
||||
#if QT_VERSION >= QT_VERSION_CHECK(6, 0, 0) |
||||
quint16 checksum = qChecksum(QByteArray(static_cast<const char*>(memory->constData()), offsetof(InstancesInfo, checksum))); |
||||
#else |
||||
quint16 checksum = qChecksum(static_cast<const char*>(memory->constData()), offsetof(InstancesInfo, checksum)); |
||||
#endif |
||||
return checksum; |
||||
} |
||||
|
||||
qint64 SingleApplicationPrivate::primaryPid() const |
||||
{ |
||||
qint64 pid; |
||||
|
||||
memory->lock(); |
||||
auto *inst = static_cast<InstancesInfo*>( memory->data() ); |
||||
pid = inst->primaryPid; |
||||
memory->unlock(); |
||||
|
||||
return pid; |
||||
} |
||||
|
||||
QString SingleApplicationPrivate::primaryUser() const |
||||
{ |
||||
QByteArray username; |
||||
|
||||
memory->lock(); |
||||
auto *inst = static_cast<InstancesInfo*>( memory->data() ); |
||||
username = inst->primaryUser; |
||||
memory->unlock(); |
||||
|
||||
return QString::fromUtf8( username ); |
||||
} |
||||
|
||||
/**
|
||||
* @brief Executed when a connection has been made to the LocalServer |
||||
*/ |
||||
void SingleApplicationPrivate::slotConnectionEstablished() |
||||
{ |
||||
QLocalSocket *nextConnSocket = server->nextPendingConnection(); |
||||
connectionMap.insert(nextConnSocket, ConnectionInfo()); |
||||
|
||||
QObject::connect(nextConnSocket, &QLocalSocket::aboutToClose, this, |
||||
[nextConnSocket, this](){ |
||||
auto &info = connectionMap[nextConnSocket]; |
||||
this->slotClientConnectionClosed( nextConnSocket, info.instanceId ); |
||||
} |
||||
); |
||||
|
||||
QObject::connect(nextConnSocket, &QLocalSocket::disconnected, nextConnSocket, &QLocalSocket::deleteLater); |
||||
|
||||
QObject::connect(nextConnSocket, &QLocalSocket::destroyed, this, |
||||
[nextConnSocket, this](){ |
||||
connectionMap.remove(nextConnSocket); |
||||
} |
||||
); |
||||
|
||||
QObject::connect(nextConnSocket, &QLocalSocket::readyRead, this, |
||||
[nextConnSocket, this](){ |
||||
auto &info = connectionMap[nextConnSocket]; |
||||
switch(info.stage){ |
||||
case StageInitHeader: |
||||
readMessageHeader( nextConnSocket, StageInitBody ); |
||||
break; |
||||
case StageInitBody: |
||||
readInitMessageBody(nextConnSocket); |
||||
break; |
||||
case StageConnectedHeader: |
||||
readMessageHeader( nextConnSocket, StageConnectedBody ); |
||||
break; |
||||
case StageConnectedBody: |
||||
this->slotDataAvailable( nextConnSocket, info.instanceId ); |
||||
break; |
||||
default: |
||||
break; |
||||
}; |
||||
} |
||||
); |
||||
} |
||||
|
||||
void SingleApplicationPrivate::readMessageHeader( QLocalSocket *sock, SingleApplicationPrivate::ConnectionStage nextStage ) |
||||
{ |
||||
if (!connectionMap.contains( sock )){ |
||||
return; |
||||
} |
||||
|
||||
if( sock->bytesAvailable() < ( qint64 )sizeof( quint64 ) ){ |
||||
return; |
||||
} |
||||
|
||||
QDataStream headerStream( sock ); |
||||
|
||||
#if (QT_VERSION >= QT_VERSION_CHECK(5, 6, 0)) |
||||
headerStream.setVersion( QDataStream::Qt_5_6 ); |
||||
#endif |
||||
|
||||
// Read the header to know the message length
|
||||
quint64 msgLen = 0; |
||||
headerStream >> msgLen; |
||||
ConnectionInfo &info = connectionMap[sock]; |
||||
info.stage = nextStage; |
||||
info.msgLen = msgLen; |
||||
|
||||
writeAck( sock ); |
||||
} |
||||
|
||||
bool SingleApplicationPrivate::isFrameComplete( QLocalSocket *sock ) |
||||
{ |
||||
if (!connectionMap.contains( sock )){ |
||||
return false; |
||||
} |
||||
|
||||
ConnectionInfo &info = connectionMap[sock]; |
||||
if( sock->bytesAvailable() < ( qint64 )info.msgLen ){ |
||||
return false; |
||||
} |
||||
|
||||
return true; |
||||
} |
||||
|
||||
void SingleApplicationPrivate::readInitMessageBody( QLocalSocket *sock ) |
||||
{ |
||||
Q_Q(SingleApplication); |
||||
|
||||
if( !isFrameComplete( sock ) ) |
||||
return; |
||||
|
||||
// Read the message body
|
||||
QByteArray msgBytes = sock->readAll(); |
||||
QDataStream readStream(msgBytes); |
||||
|
||||
#if (QT_VERSION >= QT_VERSION_CHECK(5, 6, 0)) |
||||
readStream.setVersion( QDataStream::Qt_5_6 ); |
||||
#endif |
||||
|
||||
// server name
|
||||
QByteArray latin1Name; |
||||
readStream >> latin1Name; |
||||
|
||||
// connection type
|
||||
ConnectionType connectionType = InvalidConnection; |
||||
quint8 connTypeVal = InvalidConnection; |
||||
readStream >> connTypeVal; |
||||
connectionType = static_cast <ConnectionType>( connTypeVal ); |
||||
|
||||
// instance id
|
||||
quint32 instanceId = 0; |
||||
readStream >> instanceId; |
||||
|
||||
// checksum
|
||||
quint16 msgChecksum = 0; |
||||
readStream >> msgChecksum; |
||||
|
||||
#if QT_VERSION >= QT_VERSION_CHECK(6, 0, 0) |
||||
const quint16 actualChecksum = qChecksum(QByteArray(msgBytes, static_cast<quint32>(msgBytes.length() - sizeof(quint16)))); |
||||
#else |
||||
const quint16 actualChecksum = qChecksum(msgBytes.constData(), static_cast<quint32>(msgBytes.length() - sizeof(quint16))); |
||||
#endif |
||||
|
||||
bool isValid = readStream.status() == QDataStream::Ok && |
||||
QLatin1String(latin1Name) == blockServerName && |
||||
msgChecksum == actualChecksum; |
||||
|
||||
if( !isValid ){ |
||||
sock->close(); |
||||
return; |
||||
} |
||||
|
||||
ConnectionInfo &info = connectionMap[sock]; |
||||
info.instanceId = instanceId; |
||||
info.stage = StageConnectedHeader; |
||||
|
||||
if( connectionType == NewInstance || |
||||
( connectionType == SecondaryInstance && |
||||
options & SingleApplication::Mode::SecondaryNotification ) ) |
||||
{ |
||||
Q_EMIT q->instanceStarted(); |
||||
} |
||||
|
||||
writeAck( sock ); |
||||
} |
||||
|
||||
void SingleApplicationPrivate::slotDataAvailable( QLocalSocket *dataSocket, quint32 instanceId ) |
||||
{ |
||||
Q_Q(SingleApplication); |
||||
|
||||
if ( !isFrameComplete( dataSocket ) ) |
||||
return; |
||||
|
||||
Q_EMIT q->receivedMessage( instanceId, dataSocket->readAll() ); |
||||
|
||||
writeAck( dataSocket ); |
||||
|
||||
ConnectionInfo &info = connectionMap[dataSocket]; |
||||
info.stage = StageConnectedHeader; |
||||
} |
||||
|
||||
void SingleApplicationPrivate::slotClientConnectionClosed( QLocalSocket *closedSocket, quint32 instanceId ) |
||||
{ |
||||
if( closedSocket->bytesAvailable() > 0 ) |
||||
slotDataAvailable( closedSocket, instanceId ); |
||||
} |
||||
|
||||
void SingleApplicationPrivate::randomSleep() |
||||
{ |
||||
#if QT_VERSION >= QT_VERSION_CHECK( 5, 10, 0 ) |
||||
QThread::msleep( QRandomGenerator::global()->bounded( 8u, 18u )); |
||||
#else |
||||
qsrand( QDateTime::currentMSecsSinceEpoch() % std::numeric_limits<uint>::max() ); |
||||
QThread::msleep( qrand() % 11 + 8); |
||||
#endif |
||||
} |
||||
|
||||
void SingleApplicationPrivate::addAppData(const QString &data) |
||||
{ |
||||
appDataList.push_back(data); |
||||
} |
||||
|
||||
QStringList SingleApplicationPrivate::appData() const |
||||
{ |
||||
return appDataList; |
||||
} |
||||
@ -0,0 +1,109 @@ |
||||
// The MIT License (MIT)
|
||||
//
|
||||
// Copyright (c) Itay Grudev 2015 - 2020
|
||||
//
|
||||
// Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||
// of this software and associated documentation files (the "Software"), to deal
|
||||
// in the Software without restriction, including without limitation the rights
|
||||
// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||
// copies of the Software, and to permit persons to whom the Software is
|
||||
// furnished to do so, subject to the following conditions:
|
||||
//
|
||||
// The above copyright notice and this permission notice shall be included in
|
||||
// all copies or substantial portions of the Software.
|
||||
//
|
||||
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||
// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||
// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||
// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||
// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
||||
// THE SOFTWARE.
|
||||
|
||||
//
|
||||
// W A R N I N G !!!
|
||||
// -----------------
|
||||
//
|
||||
// This file is not part of the SingleApplication API. It is used purely as an
|
||||
// implementation detail. This header file may change from version to
|
||||
// version without notice, or may even be removed.
|
||||
//
|
||||
|
||||
#ifndef SINGLEAPPLICATION_P_H |
||||
#define SINGLEAPPLICATION_P_H |
||||
|
||||
#include <QtCore/QSharedMemory> |
||||
#include <QtNetwork/QLocalServer> |
||||
#include <QtNetwork/QLocalSocket> |
||||
#include "singleapplication.h" |
||||
|
||||
struct InstancesInfo { |
||||
bool primary; |
||||
quint32 secondary; |
||||
qint64 primaryPid; |
||||
char primaryUser[128]; |
||||
quint16 checksum; // Must be the last field
|
||||
}; |
||||
|
||||
struct ConnectionInfo { |
||||
qint64 msgLen = 0; |
||||
quint32 instanceId = 0; |
||||
quint8 stage = 0; |
||||
}; |
||||
|
||||
class SingleApplicationPrivate : public QObject { |
||||
Q_OBJECT |
||||
public: |
||||
enum ConnectionType : quint8 { |
||||
InvalidConnection = 0, |
||||
NewInstance = 1, |
||||
SecondaryInstance = 2, |
||||
Reconnect = 3 |
||||
}; |
||||
enum ConnectionStage : quint8 { |
||||
StageInitHeader = 0, |
||||
StageInitBody = 1, |
||||
StageConnectedHeader = 2, |
||||
StageConnectedBody = 3, |
||||
}; |
||||
Q_DECLARE_PUBLIC(SingleApplication) |
||||
|
||||
SingleApplicationPrivate( SingleApplication *q_ptr ); |
||||
~SingleApplicationPrivate() override; |
||||
|
||||
static QString getUsername(); |
||||
void genBlockServerName(); |
||||
void initializeMemoryBlock() const; |
||||
void startPrimary(); |
||||
void startSecondary(); |
||||
bool connectToPrimary( int msecs, ConnectionType connectionType ); |
||||
quint16 blockChecksum() const; |
||||
qint64 primaryPid() const; |
||||
QString primaryUser() const; |
||||
bool isFrameComplete(QLocalSocket *sock); |
||||
void readMessageHeader(QLocalSocket *socket, ConnectionStage nextStage); |
||||
void readInitMessageBody(QLocalSocket *socket); |
||||
void writeAck(QLocalSocket *sock); |
||||
bool writeConfirmedFrame(int msecs, const QByteArray &msg); |
||||
bool writeConfirmedMessage(int msecs, const QByteArray &msg); |
||||
static void randomSleep(); |
||||
void addAppData(const QString &data); |
||||
QStringList appData() const; |
||||
|
||||
SingleApplication *q_ptr; |
||||
QSharedMemory *memory; |
||||
QLocalSocket *socket; |
||||
QLocalServer *server; |
||||
quint32 instanceNumber; |
||||
QString blockServerName; |
||||
SingleApplication::Options options; |
||||
QMap<QLocalSocket*, ConnectionInfo> connectionMap; |
||||
QStringList appDataList; |
||||
|
||||
public Q_SLOTS: |
||||
void slotConnectionEstablished(); |
||||
void slotDataAvailable( QLocalSocket*, quint32 ); |
||||
void slotClientConnectionClosed( QLocalSocket*, quint32 ); |
||||
}; |
||||
|
||||
#endif // SINGLEAPPLICATION_P_H
|
||||
Loading…
Reference in new issue