/**************************************************************************** | |
** | |
** Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies). | |
** All rights reserved. | |
** Contact: Nokia Corporation (qt-info@nokia.com) | |
** | |
** This file is part of the QtDBus module of the Qt Toolkit. | |
** | |
** $QT_BEGIN_LICENSE:LGPL$ | |
** GNU Lesser General Public License Usage | |
** This file may be used under the terms of the GNU Lesser General Public | |
** License version 2.1 as published by the Free Software Foundation and | |
** appearing in the file LICENSE.LGPL included in the packaging of this | |
** file. Please review the following information to ensure the GNU Lesser | |
** General Public License version 2.1 requirements will be met: | |
** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. | |
** | |
** In addition, as a special exception, Nokia gives you certain additional | |
** rights. These rights are described in the Nokia Qt LGPL Exception | |
** version 1.1, included in the file LGPL_EXCEPTION.txt in this package. | |
** | |
** GNU General Public License Usage | |
** Alternatively, this file may be used under the terms of the GNU General | |
** Public License version 3.0 as published by the Free Software Foundation | |
** and appearing in the file LICENSE.GPL included in the packaging of this | |
** file. Please review the following information to ensure the GNU General | |
** Public License version 3.0 requirements will be met: | |
** http://www.gnu.org/copyleft/gpl.html. | |
** | |
** Other Usage | |
** Alternatively, this file may be used in accordance with the terms and | |
** conditions contained in a signed written agreement between you and Nokia. | |
** | |
** | |
** | |
** | |
** | |
** $QT_END_LICENSE$ | |
** | |
****************************************************************************/ | |
#ifndef QDBUSCONNECTION_H | |
#define QDBUSCONNECTION_H | |
#include <QtDBus/qdbusmacros.h> | |
#include <QtCore/qstring.h> | |
#ifndef QT_NO_DBUS | |
QT_BEGIN_HEADER | |
QT_BEGIN_NAMESPACE | |
QT_MODULE(DBus) | |
namespace QDBus | |
{ | |
enum CallMode { | |
NoBlock, | |
Block, | |
BlockWithGui, | |
AutoDetect | |
}; | |
} | |
class QDBusAbstractInterfacePrivate; | |
class QDBusInterface; | |
class QDBusError; | |
class QDBusMessage; | |
class QDBusPendingCall; | |
class QDBusConnectionInterface; | |
class QObject; | |
class QDBusConnectionPrivate; | |
class Q_DBUS_EXPORT QDBusConnection | |
{ | |
Q_GADGET | |
Q_ENUMS(BusType UnregisterMode) | |
Q_FLAGS(RegisterOptions) | |
public: | |
enum BusType { SessionBus, SystemBus, ActivationBus }; | |
enum RegisterOption { | |
ExportAdaptors = 0x01, | |
ExportScriptableSlots = 0x10, | |
ExportScriptableSignals = 0x20, | |
ExportScriptableProperties = 0x40, | |
ExportScriptableInvokables = 0x80, | |
ExportScriptableContents = 0xf0, | |
ExportNonScriptableSlots = 0x100, | |
ExportNonScriptableSignals = 0x200, | |
ExportNonScriptableProperties = 0x400, | |
ExportNonScriptableInvokables = 0x800, | |
ExportNonScriptableContents = 0xf00, | |
ExportAllSlots = ExportScriptableSlots|ExportNonScriptableSlots, | |
ExportAllSignals = ExportScriptableSignals|ExportNonScriptableSignals, | |
ExportAllProperties = ExportScriptableProperties|ExportNonScriptableProperties, | |
ExportAllInvokables = ExportScriptableInvokables|ExportNonScriptableInvokables, | |
ExportAllContents = ExportScriptableContents|ExportNonScriptableContents, | |
#ifndef Q_QDOC | |
// Qt 4.2 had a misspelling here | |
ExportAllSignal = ExportAllSignals, | |
#endif | |
ExportChildObjects = 0x1000 | |
}; | |
enum UnregisterMode { | |
UnregisterNode, | |
UnregisterTree | |
}; | |
Q_DECLARE_FLAGS(RegisterOptions, RegisterOption) | |
QDBusConnection(const QString &name); | |
QDBusConnection(const QDBusConnection &other); | |
~QDBusConnection(); | |
QDBusConnection &operator=(const QDBusConnection &other); | |
bool isConnected() const; | |
QString baseService() const; | |
QDBusError lastError() const; | |
QString name() const; | |
bool send(const QDBusMessage &message) const; | |
bool callWithCallback(const QDBusMessage &message, QObject *receiver, | |
const char *returnMethod, const char *errorMethod, | |
int timeout = -1) const; | |
bool callWithCallback(const QDBusMessage &message, QObject *receiver, | |
const char *slot, int timeout = -1) const; | |
QDBusMessage call(const QDBusMessage &message, QDBus::CallMode mode = QDBus::Block, | |
int timeout = -1) const; | |
QDBusPendingCall asyncCall(const QDBusMessage &message, int timeout = -1) const; | |
bool connect(const QString &service, const QString &path, const QString &interface, | |
const QString &name, QObject *receiver, const char *slot); | |
bool connect(const QString &service, const QString &path, const QString &interface, | |
const QString &name, const QString& signature, | |
QObject *receiver, const char *slot); | |
bool connect(const QString &service, const QString &path, const QString &interface, | |
const QString &name, const QStringList &argumentMatch, const QString& signature, | |
QObject *receiver, const char *slot); | |
bool disconnect(const QString &service, const QString &path, const QString &interface, | |
const QString &name, QObject *receiver, const char *slot); | |
bool disconnect(const QString &service, const QString &path, const QString &interface, | |
const QString &name, const QString& signature, | |
QObject *receiver, const char *slot); | |
bool disconnect(const QString &service, const QString &path, const QString &interface, | |
const QString &name, const QStringList &argumentMatch, const QString& signature, | |
QObject *receiver, const char *slot); | |
bool registerObject(const QString &path, QObject *object, | |
RegisterOptions options = ExportAdaptors); | |
void unregisterObject(const QString &path, UnregisterMode mode = UnregisterNode); | |
QObject *objectRegisteredAt(const QString &path) const; | |
bool registerService(const QString &serviceName); | |
bool unregisterService(const QString &serviceName); | |
QDBusConnectionInterface *interface() const; | |
static QDBusConnection connectToBus(BusType type, const QString &name); | |
static QDBusConnection connectToBus(const QString &address, const QString &name); | |
static void disconnectFromBus(const QString &name); | |
static QDBusConnection sessionBus(); | |
static QDBusConnection systemBus(); | |
static QDBusConnection sender(); | |
protected: | |
explicit QDBusConnection(QDBusConnectionPrivate *dd); | |
private: | |
friend class QDBusConnectionPrivate; | |
QDBusConnectionPrivate *d; | |
}; | |
Q_DECLARE_OPERATORS_FOR_FLAGS(QDBusConnection::RegisterOptions) | |
QT_END_NAMESPACE | |
QT_END_HEADER | |
#endif // QT_NO_DBUS | |
#endif |