text: /****************************************************************************
  **
  ** Copyright (C) 2016 The Qt Company Ltd.
  ** Contact: https://www.qt.io/licensing/
  **
  ** This file is part of the QtDBus module of the Qt Toolkit.
  **
  ** $QT_BEGIN_LICENSE:LGPL$
  ** Commercial License Usage
  ** Licensees holding valid commercial Qt licenses may use this file in
  ** accordance with the commercial license agreement provided with the
  ** Software or, alternatively, in accordance with the terms contained in
  ** a written agreement between you and The Qt Company. For licensing terms
  ** and conditions see https://www.qt.io/terms-conditions. For further
  ** information use the contact form at https://www.qt.io/contact-us.
  **
  ** GNU Lesser General Public License Usage
  ** Alternatively, this file may be used under the terms of the GNU Lesser
  ** General Public License version 3 as published by the Free Software
  ** Foundation and appearing in the file LICENSE.LGPL3 included in the
  ** packaging of this file. Please review the following information to
  ** ensure the GNU Lesser General Public License version 3 requirements
  ** will be met: https://www.gnu.org/licenses/lgpl-3.0.html.
  **
  ** GNU General Public License Usage
  ** Alternatively, this file may be used under the terms of the GNU
  ** General Public License version 2.0 or (at your option) the GNU General
  ** Public license version 3 or any later version approved by the KDE Free
  ** Qt Foundation. The licenses are as published by the Free Software
  ** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3
  ** included in the packaging of this file. Please review the following
  ** information to ensure the GNU General Public License requirements will
  ** be met: https://www.gnu.org/licenses/gpl-2.0.html and
  ** https://www.gnu.org/licenses/gpl-3.0.html.
  **
  ** $QT_END_LICENSE$
  **
  ****************************************************************************/
  
  #ifndef QDBUSCONNECTIONINTERFACE_H
  #define QDBUSCONNECTIONINTERFACE_H
  
  #include <QtDBus/qtdbusglobal.h>
  #include <QtCore/qstringlist.h>
  
  #include <QtDBus/qdbusabstractinterface.h>
  #include <QtDBus/qdbusreply.h>
  
  #ifndef QT_NO_DBUS
  
  QT_BEGIN_NAMESPACE
  
  
  class QDBusConnection;
  class QString;
  class QByteArray;
  
  /*
   * Proxy class for interface org.freedesktop.DBus
   */
  class Q_DBUS_EXPORT QDBusConnectionInterface: public QDBusAbstractInterface
  {
      Q_OBJECT
      friend class QDBusConnectionPrivate;
      static inline const char *staticInterfaceName();
  
      explicit QDBusConnectionInterface(const QDBusConnection &connection, QObject *parent);
      ~QDBusConnectionInterface();
  
      Q_PROPERTY(QDBusReply<QStringList> registeredServiceNames READ registeredServiceNames)
      Q_PROPERTY(QDBusReply<QStringList> activatableServiceNames READ activatableServiceNames)
  
  public:
      enum ServiceQueueOptions {
          DontQueueService,
          QueueService,
          ReplaceExistingService
      };
      Q_ENUM(ServiceQueueOptions)
      enum ServiceReplacementOptions {
          DontAllowReplacement,
          AllowReplacement
      };
      Q_ENUM(ServiceReplacementOptions)
      enum RegisterServiceReply {
          ServiceNotRegistered = 0,
          ServiceRegistered,
          ServiceQueued
      };
      Q_ENUM(RegisterServiceReply)
  
  public Q_SLOTS:
      QDBusReply<QStringList> registeredServiceNames() const;
      QDBusReply<QStringList> activatableServiceNames() const;
      QDBusReply<bool> isServiceRegistered(const QString &serviceName) const;
      QDBusReply<QString> serviceOwner(const QString &name) const;
      QDBusReply<bool> unregisterService(const QString &serviceName);
      QDBusReply<QDBusConnectionInterface::RegisterServiceReply> registerService(const QString &serviceName,
                                                       ServiceQueueOptions qoption = DontQueueService,
                                                       ServiceReplacementOptions roption = DontAllowReplacement);
  
      QDBusReply<uint> servicePid(const QString &serviceName) const;
      QDBusReply<uint> serviceUid(const QString &serviceName) const;
  
      QDBusReply<void> startService(const QString &name);
  
  Q_SIGNALS:
      void serviceRegistered(const QString &service);
      void serviceUnregistered(const QString &service);
      void serviceOwnerChanged(const QString &name, const QString &oldOwner, const QString &newOwner);
      void callWithCallbackFailed(const QDBusError &error, const QDBusMessage &call);
  
  #ifndef Q_QDOC
      // internal signals
      // do not use
      void NameAcquired(const QString &);
      void NameLost(const QString &);
      void NameOwnerChanged(const QString &, const QString &, const QString &);
  protected:
      void connectNotify(const QMetaMethod &) override;
      void disconnectNotify(const QMetaMethod &) override;
  #endif
  };
  
  QT_END_NAMESPACE
  
  Q_DECLARE_BUILTIN_METATYPE(UInt, QMetaType::UInt, QDBusConnectionInterface::RegisterServiceReply)
  
  #endif // QT_NO_DBUS
  #endif
  