1 /***************************************************************************
2 * Copyright (C) 2005-2015 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 ***************************************************************************/
38 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)
84 ActionType *a = new ActionType(this);
85 if (receiver && member)
86 connect(a, SIGNAL(triggered(bool)), receiver, member);
93 void inserted(QAction *action);
94 void actionHovered(QAction *action);
95 void actionTriggered(QAction *action);
98 #if QT_VERSION >= 0x050000
99 virtual void connectNotify(const QMetaMethod &signal);
101 virtual void connectNotify(const char *signal);
103 virtual void slotActionTriggered();
106 void slotActionHovered();
107 void actionDestroyed(QObject *);
108 void associatedWidgetDestroyed(QObject *);
111 bool unlistAction(QAction *);
113 QMap<QString, QAction *> _actionByName;
114 QList<QAction *> _actions;
115 QList<QWidget *> _associatedWidgets;
117 bool _connectHovered;
118 bool _connectTriggered;
122 int ActionCollection::count() const { return actions().count(); }
123 bool ActionCollection::isEmpty() const { return actions().count(); }
127 # include <KActionCollection>
129 # include <KXmlGui/KActionCollection>
132 class ActionCollection : public KActionCollection
137 explicit ActionCollection(QObject *parent) : KActionCollection(parent) {};
140 #endif /* HAVE_KDE */