runtime/knotify/notifybypopup.h

   1 /*
   2    Copyright (C) 2005-2006 by Olivier Goffart <ogoffart at kde.org>
   3    Copyright (C) 2008 by Dmitry Suzdalev <dimsuz@gmail.com>
   4
   5
   6    This program is free software; you can redistribute it and/or modify
   7    it under the terms of the GNU General Public License as published by
   8    the Free Software Foundation; either version 2, or (at your option)
   9    any later version.
  10
  11    This program is distributed in the hope that it will be useful,
  12    but WITHOUT ANY WARRANTY; without even the implied warranty of
  13    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14    GNU General Public License for more details.
  15
  16    You should have received a copy of the GNU General Public License
  17    along with this program; if not, write to the Free Software
  18    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  19
  20  */
  21
  22 #ifndef NOTIFYBYPOPUP_H
  23 #define NOTIFYBYPOPUP_H
  24
  25 #include "knotifyplugin.h"
  26 #include <QMap>
  27 #include <QHash>
  28
  29 class KPassivePopup;
  30
  31 class NotifyByPopup : public KNotifyPlugin
  32 { Q_OBJECT
  33         public:
  34                 NotifyByPopup(QObject *parent=0l);
  35                 virtual ~NotifyByPopup();
  36
  37                 virtual QString optionName() { return "Popup"; }
  38                 virtual void notify(int id , KNotifyConfig *config);
  39                 virtual void close( int id );
  40                 virtual void update(int id, KNotifyConfig *config);
  41         private:
  42                 QMap<int, KPassivePopup * > m_popups;
  43                 // the y coordinate of the next position popup should appears
  44                 int m_nextPosition;
  45                 int m_animationTimer;
  46                 void fillPopup(KPassivePopup *,int id,KNotifyConfig *config);
  47                 /**
  48                  * Sends notification to DBus "/Notifications" interface.
  49                  * @param id knotify-sid identifier of notification
  50                  * @param replacesId knotify-side notification identifier. If not 0, will
  51                  * request DBus service to replace existing notification with data in config
  52                  * @param config notification data
  53                  */
  54                 void sendNotificationDBus(int id, int replacesId, KNotifyConfig* config);
  55                 /**
  56                  * Sends request to close Notification with id to DBus "/Notification" interface
  57                  *  @param id knotify-side notification ID to close
  58                  */
  59                 void closeNotificationDBus(int id);
  60                 /**
  61                  * Specifies if DBus Notifications interface exists on session bus
  62                  */
  63                 bool m_dbusServiceExists;
  64                 /**
  65                  * Find the caption and the icon name of the application
  66                  */
  67                 void getAppCaptionAndIconName(KNotifyConfig *config, QString *appCaption, QString *iconName);
  68
  69         protected:
  70                 void timerEvent(QTimerEvent *event);
  71
  72         private Q_SLOTS:
  73                 void slotPopupDestroyed();
  74                 void slotLinkClicked(const QString & );
  75                 // slot to catch appearance or dissapearance of Notifications DBus service
  76                 void slotServiceOwnerChanged(const QString &, const QString &, const QString &);
  77                 // slot which gets called when DBus signals that some notification action was invoked
  78                 void slotDBusNotificationActionInvoked(uint, const QString&);
  79                 // slot which gets called when DBus signals that some notification was closed
  80                 void slotDBusNotificationClosed(uint, uint);
  81
  82         private:
  83                 /**
  84                  * Maps knotify notification IDs to DBus notifications IDs
  85                  */
  86                 QHash<int,uint> m_idMap;
  87 };
  88
  89 #endif