diff options
author | Michele Calgaro <michele.calgaro@yahoo.it> | 2024-11-05 12:24:20 +0900 |
---|---|---|
committer | Michele Calgaro <michele.calgaro@yahoo.it> | 2024-11-19 22:26:14 +0900 |
commit | 1711870a073597c2282f32ad39a9b8ad5e1cf6bb (patch) | |
tree | 1fb9f1d9ad4ec650960add05c3dd287cd42c7d61 /tdecore/kuniqueapplication.h | |
parent | 87ad1e6c4d56fb52faa0d1af4afe5c33f05e6dca (diff) | |
download | tdelibs-1711870a073597c2282f32ad39a9b8ad5e1cf6bb.tar.gz tdelibs-1711870a073597c2282f32ad39a9b8ad5e1cf6bb.zip |
Rename KUniqueApplication to TDEUniqueApplication and remove obsolete kapp.h and kuniqueapp.h headers
Signed-off-by: Michele Calgaro <michele.calgaro@yahoo.it>
Diffstat (limited to 'tdecore/kuniqueapplication.h')
-rw-r--r-- | tdecore/kuniqueapplication.h | 221 |
1 files changed, 0 insertions, 221 deletions
diff --git a/tdecore/kuniqueapplication.h b/tdecore/kuniqueapplication.h deleted file mode 100644 index 6368b53ac..000000000 --- a/tdecore/kuniqueapplication.h +++ /dev/null @@ -1,221 +0,0 @@ -/* This file is part of the KDE libraries - Copyright (c) 1999 Preston Brown <pbrown@kde.org> - Copyright (c) 2000-2001 Waldo Bastian <bastian@kde.org> - - This library is free software; you can redistribute it and/or - modify it under the terms of the GNU Library General Public - License as published by the Free Software Foundation; either - version 2 of the License, or (at your option) any later version. - - This library is distributed in the hope that it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU - Library General Public License for more details. - - You should have received a copy of the GNU Library General Public License - along with this library; see the file COPYING.LIB. If not, write to - the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, - Boston, MA 02110-1301, USA. -*/ - -#ifndef _KUNIQUEAPP_H -#define _KUNIQUEAPP_H - -#include <tdeapplication.h> -#include <dcopobject.h> - -class KUniqueApplicationPrivate; - -/** - * Maintains only a single - * instance of a running application at a time. - * - * If another instance - * is started, it will determine (via DCOP) whether it is the first instance - * or a second instance. If it is a second instance, it will forward on - * the information to the first instance and then quit. - * - * The .desktop file for the application should state X-DCOP-ServiceType=Unique, - * see tdeapplication.h - * - * If your application is used to open files, it should also support the --tempfile - * option (see TDECmdLineArgs::addTempFileOption()), to delete tempfiles after use. - * Add X-TDE-HasTempFileOption=true to the .desktop file to indicate this. - * - * @see TDEApplication DCOPObject - * @author Preston Brown <pbrown@kde.org> - */ -class TDECORE_EXPORT KUniqueApplication : public TDEApplication, public DCOPObject -{ - TQ_OBJECT -public: - /** - * Constructor. Takes command line arguments from TDECmdLineArgs - * - * @param allowStyles Set to false to disable the loading on plugin based - * styles. This is only useful to applications that do not display a GUI - * normally. If you do create an application with @p allowStyles set to false - * it normally runs in the background but under special circumstances - * displays widgets. Call TDEApplication::enableStyles() before - * displaying any widgets. - * @param GUIenabled Set to false to disable all GUI stuff. This implies - * no styles either. - * @param configUnique If true, the uniqueness of the application will - * depend on the value of the "MultipleInstances" - * key in the "KDE" group of the application config file. - */ - KUniqueApplication( bool allowStyles=true, - bool GUIenabled=true, - bool configUnique=false); - -#ifdef TQ_WS_X11 - /** - * Constructor. Takes command line arguments from TDECmdLineArgs - * - * @param display Will be passed to Qt as the X display. The display - * must be valid and already opened. - * @param visual Pointer to the X11 visual that should be used by the - * application. If NULL, the default visual will be used instead. - * @param colormap The colormap that should be used by the application. - * If 0, the default colormap will be used instead. - * @param allowStyles Set to false to disable the loading on plugin based - * styles. This is only useful to applications that do not display a GUI - * normally. If you do create an application with @p allowStyles set to false - * it normally runs in the background but under special circumstances - * displays widgets. Call TDEApplication::enableStyles() before - * displaying any widgets. - * @param configUnique If true, the uniqueness of the application will - * depend on the value of the "MultipleInstances" - * key in the "KDE" group of the application config file. - * @since KDE 3.3 - */ - KUniqueApplication( Display *display, - TQt::HANDLE visual=0, - TQt::HANDLE colormap=0, - bool allowStyles=true, - bool configUnique=false); -#endif - - /** - * Adds command line options specific for KUniqueApplication. - * - * Should be called before calling KUniqueApplication constructor - * and / or start(). - */ - static void addCmdLineOptions(); - - /** - * Forks and registers with dcop. - * - * The command line arguments are being sent via DCOP to newInstance() - * and will be received once the application enters the event loop. - * - * Typically this is used like: - * \code - * int main(int argc, char **argv) { - * TDEAboutData about("myappname", "myAppName", .....); - * TDECmdLineArgs::init(argc, argv, &about); - * TDECmdLineArgs::addCmdLineOptions( myCmdOptions ); - * KUniqueApplication::addCmdLineOptions(); - * - * if (!KUniqueApplication::start()) { - * fprintf(stderr, "myAppName is already running!\n"); - * exit(0); - * } - * KUniqueApplication a; - * a.exec(); - * } - * \endcode - * Note that it's not necessary to call start() explicitly. It will be - * called automatically before creating KUniqueApplication if it hasn't - * been called yet, without any performance impact. - * - * @return true if registration is successful. - * false if another process was already running. - */ - static bool start(); - - /** - * Destructor - */ - virtual ~KUniqueApplication(); - - /** - * Dispatches any incoming DCOP message for a new instance. - * - * If it is not a request for a new instance, return false. - * Overloaded from DCOPObject to make sure that the application - * stays unique. - * @param fun DCOP function signature - * @param data the data for the arguments - * @param replyType the type of the reply value - * @param replyData the reply - * @see DCOPObject - */ - bool process(const TQCString &fun, const TQByteArray &data, - TQCString &replyType, TQByteArray &replyData); - - /** - * Creates a new "instance" of the application. - * - * Usually this will involve making some calls into the GUI portion of your - * application asking for a new window to be created, possibly with - * some data already loaded based on the arguments received. - * - * Command line arguments have been passed to TDECmdLineArgs before this - * function is called and can be checked in the usual way. - * - * The default implementation ensures the mainwindow of the already - * running instance is shown and activated if necessary. You should - * prefer using it from your overridden method instead of doing - * it directly. - * - * Note that newInstance() is called also in the first started - * application process. - * - * @return An exit value. The calling process will exit with this value. - */ - virtual int newInstance(); - - /** - * Returns whether newInstance() is being called while session - * restoration is in progress. - * - * @since KDE 3.3 - */ - bool restoringSession(); - - /** - * @internal - */ - static void setHandleAutoStarted(); - -private: - /** - * Delays the processing of a DCOP request. - */ - void delayRequest(const TQCString &fun, const TQByteArray &data); - -private slots: - /** - * Delayed processing of DCOP requests. - */ - void processDelayed(); - - void newInstanceNoFork(); - - static TDEInstance* initHack( bool configUnique ); - -private: - static bool s_nofork; - static bool s_multipleInstances; - static bool s_uniqueTestDone; - static bool s_handleAutoStarted; - -protected: - virtual void virtual_hook( int id, void* data ); -private: - KUniqueApplicationPrivate *d; -}; - -#endif |