summaryrefslogtreecommitdiffstats
path: root/kio/kio/kdcopservicestarter.h
diff options
context:
space:
mode:
Diffstat (limited to 'kio/kio/kdcopservicestarter.h')
-rw-r--r--kio/kio/kdcopservicestarter.h103
1 files changed, 0 insertions, 103 deletions
diff --git a/kio/kio/kdcopservicestarter.h b/kio/kio/kdcopservicestarter.h
deleted file mode 100644
index f70f0173e..000000000
--- a/kio/kio/kdcopservicestarter.h
+++ /dev/null
@@ -1,103 +0,0 @@
-/* This file is part of the KDE libraries
- Copyright (C) 2003 David Faure <faure@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 version 2 as published by the Free Software Foundation.
-
- 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 KDCOPSERVICESTARTER_H
-#define KDCOPSERVICESTARTER_H
-
-#include <tqstring.h>
-#include <kstaticdeleter.h>
-
-class KDCOPServiceStarter;
-class TQCString;
-
-/**
- * A generic DCOP service starter, using KTrader.
- * The default implementation starts new processes, but this interface can
- * also be reimplemented by specific applications to provide dlopened in-process DCOP objects.
- * @author David Faure <faure@kde.org>
- */
-class TDEIO_EXPORT KDCOPServiceStarter {
- friend class KStaticDeleter<KDCOPServiceStarter>;
-public:
-
- static KDCOPServiceStarter* self();
-
- /**
- * Check if a given DCOP interface is available - from the serviceType it's supposed to implement.
- *
- * The trader is queried to find the preferred application for this serviceType,
- * with the constraint that its X-DCOP-ServiceName property must be defined.
- * Then the DCOP server is checked. If the service is not available,
- * this method will call startServiceFor to start it.
- *
- * @param serviceType the type of service we're looking for
- * @param constraint see KTrader
- * @param preferences see KTrader
- * @param error On failure, @p error contains a description of the error
- * that occurred. If the pointer is 0, the argument will be
- * ignored
- * @param dcopService On success, @p dcopService contains the DCOP name
- * under which this service is available. If the pointer is 0 the argument
- * will be ignored
- * @param flags for future extensions (currently unused)
- *
- * @return an error code indicating success (== 0) or failure (> 0).
- */
- int findServiceFor( const TQString& serviceType,
- const TQString& constraint = TQString::null,
- const TQString& preferences = TQString::null,
- TQString *error=0, TQCString* dcopService=0,
- int flags=0 );
-
- /**
- * Find an implementation of the given @p serviceType,
- * and start it, to use its DCOP interface.
- * The default implementation uses KTrader to find the preferred Application,
- * and then starts it using kapp->startService...
- *
- * However applications (like kontact) can reimplement this method, to provide
- * an in-process way of loading the implementation for this service type.
- *
- * @param serviceType the type of service we're looking for
- * @param constraint see KTrader
- * @param preferences see KTrader
- * @param error On failure, @p error contains a description of the error
- * that occurred. If the pointer is 0, the argument will be
- * ignored
- * @param dcopService On success, @p dcopService contains the DCOP name
- * under which this service is available. If the pointer is 0 the argument
- * will be ignored
- * @param flags for future extensions (currently unused)
- *
- * @return an error code indicating success (== 0) or failure (> 0).
- */
- virtual int startServiceFor( const TQString& serviceType,
- const TQString& constraint = TQString::null,
- const TQString& preferences = TQString::null,
- TQString *error=0, TQCString* dcopService=0,
- int flags=0 );
-protected:
- KDCOPServiceStarter();
- virtual ~KDCOPServiceStarter();
-
-private:
- static KDCOPServiceStarter* s_self;
-};
-
-#endif
-