/***************************************************************************
- * Copyright (C) 2005-08 by the Quassel Project *
+ * Copyright (C) 2005-2020 by the Quassel Project *
* devel@quassel-irc.org *
* *
* This program is free software; you can redistribute it and/or modify *
* You should have received a copy of the GNU General Public License *
* along with this program; if not, write to the *
* Free Software Foundation, Inc., *
- * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. *
+ * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. *
+ ***************************************************************************
+ * This is a subset of the API of KDE's KActionCollection. *
***************************************************************************/
+#pragma once
+
+#include "uisupport-export.h"
+
+#include <utility>
+#include <vector>
+
+#ifdef HAVE_KDE
+# include <KXmlGui/KActionCollection>
+#endif
+
+#include <QDebug>
+#include <QList>
+#include <QMap>
+#include <QObject>
+#include <QString>
+
+class QWidget;
+
+class Action;
+class QAction;
+
+#ifdef HAVE_KDE
+using ActionCollectionParent = KActionCollection;
+#else
+using ActionCollectionParent = QObject;
+#endif
+
+class UISUPPORT_EXPORT ActionCollection : public ActionCollectionParent
+{
+ Q_OBJECT
+
+public:
+ using ActionCollectionParent::ActionCollectionParent;
+
+ // Convenience function that takes a list of Actions
+ void addActions(const std::vector<std::pair<QString, Action*>>& actions);
+
+// Everything else is defined in KActionCollection
+#ifndef HAVE_KDE
+ /// Clears the entire action collection, deleting all actions.
+ void clear();
+
+ /// Associate all action in this collection to the given \a widget.
+ /** Not that this only adds all current actions in the collection to that widget;
+ * subsequently added actions won't be added automatically.
+ */
+ void associateWidget(QWidget* widget) const;
+
+ /// Associate all actions in this collection to the given \a widget.
+ /** Subsequently added actions will be automagically associated with this widget as well.
+ */
+ void addAssociatedWidget(QWidget* widget);
+
+ void removeAssociatedWidget(QWidget* widget);
+ QList<QWidget*> associatedWidgets() const;
+ void clearAssociatedWidgets();
+
+ void readSettings();
+ void writeSettings() const;
+
+ int count() const;
+ bool isEmpty() const;
+
+ QAction* action(int index) const;
+ QAction* action(const QString& name) const;
+ QList<QAction*> actions() const;
+
+ QAction* addAction(const QString& name, QAction* action);
+ void removeAction(QAction* action);
+ QAction* takeAction(QAction* action);
+
+signals:
+ void inserted(QAction* action);
+ void actionHovered(QAction* action);
+ void actionTriggered(QAction* action);
+
+protected slots:
+ void connectNotify(const QMetaMethod& signal) override;
+ virtual void slotActionTriggered();
+
+private slots:
+ void slotActionHovered();
+ void actionDestroyed(QObject*);
+ void associatedWidgetDestroyed(QObject*);
+
+private:
+ bool unlistAction(QAction*);
+
+ QMap<QString, QAction*> _actionByName;
+ QList<QAction*> _actions;
+ QList<QWidget*> _associatedWidgets;
+
+ bool _connectHovered{false};
+ bool _connectTriggered{false};
+
+#endif /* HAVE_KDE */
+};