src/gui/notifications/dbusnotificationsinterface.h

   1 /*
   2  * Bittorrent Client using Qt and libtorrent.
   3  * Copyright (C) 2022  Vladimir Golovnev <glassez@yandex.ru>
   4  *
   5  * This program is free software; you can redistribute it and/or
   6  * modify it under the terms of the GNU General Public License
   7  * as published by the Free Software Foundation; either version 2
   8  * of the License, or (at your option) any later version.
   9  *
  10  * This program is distributed in the hope that it will be useful,
  11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13  * GNU General Public License for more details.
  14  *
  15  * You should have received a copy of the GNU General Public License
  16  * along with this program; if not, write to the Free Software
  17  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  18  *
  19  * In addition, as a special exception, the copyright holders give permission to
  20  * link this program with the OpenSSL project's "OpenSSL" library (or with
  21  * modified versions of it that use the same license as the "OpenSSL" library),
  22  * and distribute the linked executables. You must obey the GNU General Public
  23  * License in all respects for all of the code used other than "OpenSSL".  If you
  24  * modify file(s), you may extend this exception to your version of the file(s),
  25  * but you are not obligated to do so. If you do not wish to do so, delete this
  26  * exception statement from your version.
  27  */
  28
  29 #pragma once
  30
  31 #include <QDBusAbstractInterface>
  32 #include <QDBusPendingReply>
  33 #include <QDBusReply>
  34 #include <QStringList>
  35
  36 class QDBusConnection;
  37 class QString;
  38 class QVariant;
  39
  40 class DBusNotificationsInterface final : public QDBusAbstractInterface
  41 {
  42     Q_OBJECT
  43     Q_DISABLE_COPY_MOVE(DBusNotificationsInterface)
  44
  45 public:
  46     inline static const char DBUS_INTERFACE_NAME[] = "org.freedesktop.Notifications";
  47
  48     DBusNotificationsInterface(const QString &service, const QString &path
  49             , const QDBusConnection &connection, QObject *parent = nullptr);
  50
  51 public slots:
  52     QDBusPendingReply<QStringList> getCapabilities();
  53     QDBusPendingReply<QString, QString, QString, QString> getServerInformation();
  54     QDBusReply<QString> getServerInformation(QString &vendor, QString &version, QString &specVersion);
  55     QDBusPendingReply<uint> notify(const QString &appName
  56             , uint id, const QString &icon, const QString &summary, const QString &body
  57             , const QStringList &actions, const QVariantMap &hints, int timeout);
  58     QDBusPendingReply<> closeNotification(uint id);
  59
  60 signals:
  61     // Signal names must exactly match the ones from corresponding D-Bus interface
  62     void ActionInvoked(uint id, const QString &action);
  63     void NotificationClosed(uint id, uint reason);
  64 };