1 /***************************************************************************
2 * Copyright (C) 2005-09 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 * 59 Temple Place - Suite 330, Boston, MA 02111-1307, 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 {
43 explicit ActionCollection(QObject *parent);
44 virtual ~ActionCollection();
46 /// Clears the entire action collection, deleting all actions.
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.
53 void associateWidget(QWidget *widget) const;
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.
58 void addAssociatedWidget(QWidget *widget);
60 void removeAssociatedWidget(QWidget *widget);
61 QList<QWidget *> associatedWidgets() const;
62 void clearAssociatedWidgets();
65 void writeSettings() const;
67 inline int count() const;
68 inline bool isEmpty() const;
70 QAction *action(int index) const;
71 QAction *action(const QString &name) const;
72 QList<QAction *> actions() const;
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);
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);
91 void inserted(QAction *action);
92 void actionHovered(QAction *action);
93 void actionTriggered(QAction *action);
96 virtual void connectNotify(const char *signal);
97 virtual void slotActionTriggered();
100 void slotActionHovered();
101 void actionDestroyed(QObject *);
102 void associatedWidgetDestroyed(QObject *);
105 bool unlistAction(QAction *);
107 QMap<QString, QAction *> _actionByName;
108 QList<QAction *> _actions;
109 QList<QWidget *> _associatedWidgets;
111 bool _connectHovered;
112 bool _connectTriggered;
115 int ActionCollection::count() const { return actions().count(); }
116 bool ActionCollection::isEmpty() const { return actions().count(); }
120 #include <KActionCollection>
122 class ActionCollection : public KActionCollection {
126 explicit ActionCollection(QObject *parent) : KActionCollection(parent) {};