1 // Copyright (c) 2011-2013 The Bitcoin developers
2 // Distributed under the MIT/X11 software license, see the accompanying
3 // file COPYING or http://www.opensource.org/licenses/mit-license.php.
5 #ifndef BITCOIN_QT_NOTIFICATOR_H
6 #define BITCOIN_QT_NOTIFICATOR_H
8 #if defined(HAVE_CONFIG_H)
9 #include "config/bitcoin-config.h"
16 class QSystemTrayIcon;
23 /** Cross-platform desktop notification client. */
24 class Notificator: public QObject
29 /** Create a new notificator.
30 @note Ownership of trayIcon is not transferred to this object.
32 Notificator(const QString &programName, QSystemTrayIcon *trayIcon, QWidget *parent);
38 Information, /**< Informational message */
39 Warning, /**< Notify user of potential problem */
40 Critical /**< An error occurred */
44 /** Show notification message.
45 @param[in] cls general message class
46 @param[in] title title shown with message
47 @param[in] text message content
48 @param[in] icon optional icon to show with message
49 @param[in] millisTimeout notification timeout in milliseconds (defaults to 10 seconds)
50 @note Platform implementations are free to ignore any of the provided fields except for \a text.
52 void notify(Class cls, const QString &title, const QString &text,
53 const QIcon &icon = QIcon(), int millisTimeout = 10000);
58 None, /**< Ignore informational notifications, and show a modal pop-up dialog for Critical notifications. */
59 Freedesktop, /**< Use DBus org.freedesktop.Notifications */
60 QSystemTray, /**< Use QSystemTray::showMessage */
61 Growl12, /**< Use the Growl 1.2 notification system (Mac only) */
62 Growl13, /**< Use the Growl 1.3 notification system (Mac only) */
63 UserNotificationCenter /**< Use the 10.8+ User Notification Center (Mac only) */
67 QSystemTrayIcon *trayIcon;
69 QDBusInterface *interface;
71 void notifyDBus(Class cls, const QString &title, const QString &text, const QIcon &icon, int millisTimeout);
73 void notifySystray(Class cls, const QString &title, const QString &text, const QIcon &icon, int millisTimeout);
75 void notifyGrowl(Class cls, const QString &title, const QString &text, const QIcon &icon);
76 void notifyMacUserNotificationCenter(Class cls, const QString &title, const QString &text, const QIcon &icon);
80 #endif // BITCOIN_QT_NOTIFICATOR_H