summaryrefslogtreecommitdiffstats
path: root/gui/polkitqt1-gui-actionbuttons.h
diff options
context:
space:
mode:
authorMichele Calgaro <michele.calgaro@yahoo.it>2021-10-30 12:06:43 +0900
committerMichele Calgaro <michele.calgaro@yahoo.it>2021-10-30 12:06:43 +0900
commit28de2ff84f59ac0b173670aa9c5331bc77c1e63f (patch)
tree43dcf0f461ee5552100b648e38979982c971597d /gui/polkitqt1-gui-actionbuttons.h
downloadpolkit-tqt-28de2ff84f59ac0b173670aa9c5331bc77c1e63f.tar.gz
polkit-tqt-28de2ff84f59ac0b173670aa9c5331bc77c1e63f.zip
Initial import from polkit-qt-1 debian snapshot archive.
https://snapshot.debian.org/package/polkit-qt-1/0.103.0-1/ Signed-off-by: Michele Calgaro <michele.calgaro@yahoo.it>
Diffstat (limited to 'gui/polkitqt1-gui-actionbuttons.h')
-rw-r--r--gui/polkitqt1-gui-actionbuttons.h114
1 files changed, 114 insertions, 0 deletions
diff --git a/gui/polkitqt1-gui-actionbuttons.h b/gui/polkitqt1-gui-actionbuttons.h
new file mode 100644
index 000000000..b02ddb902
--- /dev/null
+++ b/gui/polkitqt1-gui-actionbuttons.h
@@ -0,0 +1,114 @@
+/*
+ * This file is part of the Polkit-qt project
+ * Copyright (C) 2009 Dario Freddi <drf@kde.org>
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Library General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Library General Public License for more details.
+ *
+ * You should have received a copy of the GNU Library General Public License
+ * along with this library; see the file COPYING.LIB. If not, write to
+ * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
+ * Boston, MA 02110-1301, USA.
+ */
+
+#ifndef POLKITQT1_GUI_ACTIONBUTTONS_H
+#define POLKITQT1_GUI_ACTIONBUTTONS_H
+
+#include "polkitqt1-gui-actionbutton.h"
+
+namespace PolkitQt1
+{
+
+namespace Gui
+{
+
+class ActionButtonsPrivate;
+/**
+ * \class ActionButtons polkitqt1-gui-actionbuttons.h ActionButtons
+ * \author Dario Freddi <drf@kde.org>
+ *
+ * \brief Class used to hold and update a list of QAbstractButtons
+ *
+ * This class is a convenience wrapper around ActionButton that lets
+ * you associate an undefined number of QAbstractButtons with a single
+ * action. Every button will be updated accordingly upon action's properties
+ * changes.
+ *
+ * \see ActionButton
+ */
+class ActionButtons : public ActionButton
+{
+ Q_OBJECT
+ Q_DECLARE_PRIVATE(ActionButtons)
+ Q_DISABLE_COPY(ActionButtons)
+
+public:
+ /**
+ * Constructs a new ActionButton. You need to pass this
+ * constructor an existing list of QAbstractButtons, whose properties
+ * will be modified according to the underlying Action
+ * object. As ActionButtons inherits from Action, you can
+ * define your buttons' behavior right through this wrapper.
+ *
+ * \see Action
+ *
+ * \param buttons the QAbstractButton to associate to this ActionButton
+ * \param actionId the action Id to create the underlying Action
+ * \param parent the parent object
+ */
+ explicit ActionButtons(const QList<QAbstractButton *> &buttons, const QString &actionId = QString(), QObject *parent = 0);
+ virtual ~ActionButtons();
+
+ /**
+ * Sets a list of buttons associated to the underlying action.
+ *
+ * \note If you are calling this function, you're probably
+ * changing the buttons list the action is referring to. If this
+ * is the case, please note that Polkit-Qt does not handle
+ * the previous buttons' memory, so you should take care of
+ * deleting them yourself (if needed). You can retrieve it by
+ * using buttons()
+ *
+ * \see buttons
+ *
+ * \param buttons the new buttons associated with the underlying action
+ */
+ void setButtons(const QList<QAbstractButton *> &buttons);
+
+ /**
+ * Returns the current buttons list
+ *
+ * \return the buttons currently associated with the underlying action
+ */
+ QList<QAbstractButton *> buttons() const;
+
+ /**
+ * Adds a button to the current button list. The button's properties
+ * will be updated according to the action upon adding.
+ *
+ * \param button the button to add
+ */
+ void addButton(QAbstractButton *button);
+
+ /**
+ * Removes a button from the current list. Please note that Polkit-Qt
+ * does not handle the removed button's memory, so you should take care of
+ * deleting it yourself (if needed).
+ *
+ * \param button the button to remove
+ */
+ void removeButton(QAbstractButton *button);
+};
+
+}
+
+}
+
+#endif