src/uisupport/actioncollection.h

   1 /***************************************************************************
   2  *   Copyright (C) 2005-09 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) 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                         *
  17  *   Free Software Foundation, Inc.,                                       *
  18  *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
  19  ***************************************************************************
  20  * This is a subset of the API of KDE's KActionCollection.                 *
  21  ***************************************************************************/
  22
  23 #ifndef ACTIONCOLLECTION_H_
  24 #define ACTIONCOLLECTION_H_
  25
  26 #ifndef HAVE_KDE
  27
  28 #include <QDebug>
  29 #include <QList>
  30 #include <QMap>
  31 #include <QObject>
  32 #include <QString>
  33
  34 class QWidget;
  35
  36 class Action;
  37 class QAction;
  38
  39 class ActionCollection : public QObject {
  40   Q_OBJECT
  41
  42   public:
  43     explicit ActionCollection(QObject *parent);
  44     virtual ~ActionCollection();
  45
  46     /// Clears the entire action collection, deleting all actions.
  47     void clear();
  48
  49     /// Associate all action in this collection to the given \a widget.
  50     /** Not that this only adds all current actions in the collection to that widget;
  51      *  subsequently added actions won't be added automatically.
  52      */
  53     void associateWidget(QWidget *widget) const;
  54
  55     /// Associate all actions in this collection to the given \a widget.
  56     /** Subsequently added actions will be automagically associated with this widget as well.
  57      */
  58     void addAssociatedWidget(QWidget *widget);
  59
  60     void removeAssociatedWidget(QWidget *widget);
  61     QList<QWidget *> associatedWidgets() const;
  62     void clearAssociatedWidgets();
  63
  64     void readSettings();
  65     void writeSettings() const;
  66
  67     inline int count() const;
  68     inline bool isEmpty() const;
  69
  70     QAction *action(int index) const;
  71     QAction *action(const QString &name) const;
  72     QList<QAction *> actions() const;
  73
  74     QAction *addAction(const QString &name, QAction *action);
  75     Action *addAction(const QString &name, Action *action);
  76     Action *addAction(const QString &name, const QObject *receiver = 0, const char *member = 0);
  77     void removeAction(QAction *action);
  78     QAction *takeAction(QAction *action);
  79
  80     /// Create new action under the given name, add it to the collection and connect its triggered(bool) signal to the specified receiver.
  81     template<class ActionType>
  82     ActionType *add(const QString &name, const QObject *receiver = 0, const char *member = 0) {
  83       ActionType *a = new ActionType(this);
  84       if(receiver && member)
  85         connect(a, SIGNAL(triggered(bool)), receiver, member);
  86       addAction(name, a);
  87       return a;
  88     }
  89
  90   signals:
  91     void inserted(QAction *action);
  92     void actionHovered(QAction *action);
  93     void actionTriggered(QAction *action);
  94
  95   protected slots:
  96     virtual void connectNotify(const char *signal);
  97     virtual void slotActionTriggered();
  98
  99   private slots:
 100     void slotActionHovered();
 101     void actionDestroyed(QObject *);
 102     void associatedWidgetDestroyed(QObject *);
 103
 104   private:
 105     bool unlistAction(QAction *);
 106
 107     QMap<QString, QAction *> _actionByName;
 108     QList<QAction *> _actions;
 109     QList<QWidget *> _associatedWidgets;
 110
 111     bool _connectHovered;
 112     bool _connectTriggered;
 113 };
 114
 115 int ActionCollection::count() const { return actions().count(); }
 116 bool ActionCollection::isEmpty() const { return actions().count(); }
 117
 118 #else /* HAVE_KDE */
 119
 120 #include <KActionCollection>
 121
 122 class ActionCollection : public KActionCollection {
 123   Q_OBJECT
 124
 125   public:
 126     explicit ActionCollection(QObject *parent) : KActionCollection(parent) {};
 127
 128 };
 129 #endif
 130
 131 #endif