src/uisupport/networkmodelactionprovider.h

   1 /***************************************************************************
   2  *   Copyright (C) 2005-08 by the Quassel Project                          *
   3  *   devel@quassel-irc.org                                                 *
   4  *                                                                         *
   5  *   This program is free software; you can redistribute it and/or modify  *
   6  *   it under the terms of the GNU General Public License as published by  *
   7  *   the Free Software Foundation; either version 2 of the License, or     *
   8  *   (at your option) version 3.                                           *
   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                         *
  17  *   Free Software Foundation, Inc.,                                       *
  18  *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
  19  ***************************************************************************/
  20
  21 #ifndef NETWORKMODELACTIONPROVIDER_H
  22 #define NETWORKMODELACTIONPROVIDER_H
  23
  24 #include "action.h"
  25 #include "actioncollection.h"
  26 #include "messagefilter.h"
  27 #include "quasselui.h"
  28
  29 class NetworkModelActionProvider : public AbstractActionProvider {
  30   Q_OBJECT
  31
  32 public:
  33   NetworkModelActionProvider(QObject *parent = 0);
  34   ~NetworkModelActionProvider();
  35
  36   // don't change enums without doublechecking masks etc. in code
  37   enum ActionType {
  38     // Network actions
  39     NetworkMask = 0x0f,
  40     NetworkConnect = 0x01,
  41     NetworkDisconnect = 0x02,
  42
  43     // Buffer actions
  44     BufferMask = 0xf0,
  45     BufferJoin = 0x10,
  46     BufferPart = 0x20,
  47     BufferSwitchTo = 0x30,
  48     BufferRemove = 0x40,
  49
  50     // Hide actions
  51     HideMask = 0x0f00,
  52     HideJoin = 0x0100,
  53     HidePart = 0x0200,
  54     HideQuit = 0x0300,
  55     HideNick = 0x0400,
  56     HideMode = 0x0500,
  57     HideDayChange = 0x0600,
  58     HideApplyToAll = 0xf00,
  59
  60     // General actions
  61     GeneralMask = 0xf000,
  62     JoinChannel = 0x1000,
  63     ShowChannelList = 0x2000,
  64     ShowIgnoreList = 0x3000,
  65
  66     // Nick actions
  67     NickMask = 0xff0000,
  68     NickWhois = 0x010000,
  69     NickQuery = 0x020000,
  70     NickSwitchTo = 0x030000,
  71     NickCtcpVersion = 0x040000,
  72     NickCtcpPing = 0x050000,
  73     NickCtcpTime = 0x060000,
  74     NickCtcpFinger = 0x070000,
  75     NickOp = 0x080000,
  76     NickDeop = 0x090000,
  77     NickVoice = 0x0a0000,
  78     NickDevoice = 0x0b0000,
  79     NickKick = 0x0c0000,
  80     NickBan = 0x0d0000,
  81     NickKickBan = 0x0e0000,
  82
  83     // Actions that are handled externally
  84     // These emit a signal to the action requester, rather than being handled here
  85     ExternalMask = 0xff000000,
  86     HideBufferTemporarily = 0x01000000,
  87     HideBufferPermanently = 0x02000000
  88   };
  89
  90   inline Action *action(ActionType type) const;
  91
  92   //! Provide a list of actions applying to the given item
  93   /**
  94    * Note that this list ist not persistent, hence it should only be used immediately after
  95    * calling this function (e.g. in a context menu). Optionally one can provide a QObject and a slot
  96    * (that should take a QAction * as parameter) that is invoked for actions that require external
  97    * handling.
  98    * @param index The item index in the NetworkModel
  99    * @param receiver The optional object that is notified for actions that need to be handled externally.
 100    *                 The action type will be stored in the QAction's data().
 101    * @param slot     The receiving slot name; should be "mySlot" rather than SLOT(mySlot(QAction *))
 102    * @return A list of actions applying to the given item
 103    */
 104   void addActions(QMenu *, const QModelIndex &index, QObject *receiver = 0, const char *slot = 0, bool allowBufferHide = false);
 105   void addActions(QMenu *, const QList<QModelIndex> &indexList, QObject *receiver = 0, const char *slot = 0, bool allowBufferHide = false);
 106   void addActions(QMenu *, BufferId id, QObject *receiver = 0, const char *slot = 0);
 107   void addActions(QMenu *, MessageFilter *filter, BufferId msgBuffer, QObject *receiver = 0, const char *slot = 0);
 108   void addActions(QMenu *, MessageFilter *filter, BufferId msgBuffer, const QString &chanOrNick, QObject *receiver = 0, const char *slot = 0);
 109
 110 signals:
 111   void showChannelList(NetworkId);
 112   void showIgnoreList(NetworkId);
 113
 114 protected:
 115   inline ActionCollection *actionCollection() const;
 116
 117 protected slots:
 118   void actionTriggered(QAction *);
 119
 120 private:
 121   enum ItemActiveState {
 122     InactiveState = 0x01,
 123     ActiveState = 0x02
 124   };
 125
 126 public:
 127   Q_DECLARE_FLAGS(ItemActiveStates, ItemActiveState)
 128
 129 private:
 130   void registerAction(ActionType type, const QString &text, bool checkable = false);
 131   void registerAction(ActionType type, const QPixmap &icon, const QString &text, bool checkable = false);
 132
 133   void handleNetworkAction(ActionType, QAction *);
 134   void handleBufferAction(ActionType, QAction *);
 135   void handleHideAction(ActionType, QAction *);
 136   void handleNickAction(ActionType, QAction *);
 137   void handleGeneralAction(ActionType, QAction *);
 138   void handleExternalAction(ActionType, QAction *);
 139
 140   bool checkRequirements(const QModelIndex &index, ItemActiveStates requiredActiveState = QFlags<ItemActiveState>(ActiveState | InactiveState));
 141   Action * addAction(ActionType, QMenu *, bool condition = true);
 142   Action * addAction(Action * , QMenu *, bool condition = true);
 143   Action * addAction(ActionType, QMenu *, const QModelIndex &index, ItemActiveStates requiredActiveState = QFlags<ItemActiveState>(ActiveState | InactiveState));
 144   Action * addAction(Action * , QMenu *, const QModelIndex &index, ItemActiveStates requiredActiveState = QFlags<ItemActiveState>(ActiveState | InactiveState));
 145
 146   void addHideEventsMenu(QMenu *, BufferId bufferId);
 147   void addHideEventsMenu(QMenu *, MessageFilter *msgFilter);
 148   void addHideEventsMenu(QMenu *, int filter);
 149
 150   void addNetworkItemActions(QMenu *, const QModelIndex &);
 151   void addBufferItemActions(QMenu *, const QModelIndex &, bool isCustomBufferView = false);
 152   void addIrcUserActions(QMenu *, const QModelIndex &);
 153
 154   QString nickName(const QModelIndex &index) const;
 155   BufferId findQueryBuffer(const QModelIndex &index, const QString &predefinedNick = QString()) const;
 156   BufferId findQueryBuffer(NetworkId, const QString &nickName) const;
 157
 158   NetworkModel *_model;
 159
 160   ActionCollection *_actionCollection;
 161   QHash<ActionType, Action *> _actionByType;
 162
 163   Action *_hideEventsMenuAction;
 164   Action *_nickCtcpMenuAction;
 165   Action *_nickModeMenuAction;
 166
 167   QList<QModelIndex> _indexList;
 168   MessageFilter *_messageFilter;
 169   QString _contextItem;   ///< Channel name or nick to provide context menu for
 170   QObject *_receiver;
 171   const char *_method;
 172 };
 173
 174 // inlines
 175 ActionCollection *NetworkModelActionProvider::actionCollection() const { return _actionCollection; }
 176 Action *NetworkModelActionProvider::action(ActionType type) const { return _actionByType.value(type, 0); }
 177 #endif