1 /***************************************************************************
2 * Copyright (C) 2005-2014 by the Quassel Project *
3 * devel@quassel-irc.org *
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. *
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. *
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 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. *
19 ***************************************************************************
20 * This is a subset of the API of KDE's KActionCollection. *
21 ***************************************************************************/
23 #ifndef ACTIONCOLLECTION_H_
24 #define ACTIONCOLLECTION_H_
39 class ActionCollection : public QObject
44 explicit ActionCollection(QObject *parent);
45 virtual ~ActionCollection();
47 /// Clears the entire action collection, deleting all actions.
50 /// Associate all action in this collection to the given \a widget.
51 /** Not that this only adds all current actions in the collection to that widget;
52 * subsequently added actions won't be added automatically.
54 void associateWidget(QWidget *widget) const;
56 /// Associate all actions in this collection to the given \a widget.
57 /** Subsequently added actions will be automagically associated with this widget as well.
59 void addAssociatedWidget(QWidget *widget);
61 void removeAssociatedWidget(QWidget *widget);
62 QList<QWidget *> associatedWidgets() const;
63 void clearAssociatedWidgets();
66 void writeSettings() const;
68 inline int count() const;
69 inline bool isEmpty() const;
71 QAction *action(int index) const;
72 QAction *action(const QString &name) const;
73 QList<QAction *> actions() const;
75 QAction *addAction(const QString &name, QAction *action);
76 Action *addAction(const QString &name, Action *action);
77 Action *addAction(const QString &name, const QObject *receiver = 0, const char *member = 0);
78 void removeAction(QAction *action);
79 QAction *takeAction(QAction *action);
81 /// Create new action under the given name, add it to the collection and connect its triggered(bool) signal to the specified receiver.
82 template<class ActionType>
83 ActionType *add(const QString &name, const QObject *receiver = 0, const char *member = 0)
85 ActionType *a = new ActionType(this);
86 if (receiver && member)
87 connect(a, SIGNAL(triggered(bool)), receiver, member);
94 void inserted(QAction *action);
95 void actionHovered(QAction *action);
96 void actionTriggered(QAction *action);
99 #if QT_VERSION >= 0x050000
100 virtual void connectNotify(const QMetaMethod &method);
102 virtual void connectNotify(const char *signal);
104 virtual void slotActionTriggered();
107 void slotActionHovered();
108 void actionDestroyed(QObject *);
109 void associatedWidgetDestroyed(QObject *);
112 bool unlistAction(QAction *);
114 QMap<QString, QAction *> _actionByName;
115 QList<QAction *> _actions;
116 QList<QWidget *> _associatedWidgets;
118 bool _connectHovered;
119 bool _connectTriggered;
123 int ActionCollection::count() const { return actions().count(); }
124 bool ActionCollection::isEmpty() const { return actions().count(); }
128 #include <KActionCollection>
130 class ActionCollection : public KActionCollection
135 explicit ActionCollection(QObject *parent) : KActionCollection(parent) {};