| /**************************************************************************** |
| ** |
| ** Copyright (C) 2016 The Qt Company Ltd. |
| ** Contact: https://www.qt.io/licensing/ |
| ** |
| ** This file is part of the QtWidgets module of the Qt Toolkit. |
| ** |
| ** $QT_BEGIN_LICENSE:LGPL$ |
| ** Commercial License Usage |
| ** Licensees holding valid commercial Qt licenses may use this file in |
| ** accordance with the commercial license agreement provided with the |
| ** Software or, alternatively, in accordance with the terms contained in |
| ** a written agreement between you and The Qt Company. For licensing terms |
| ** and conditions see https://www.qt.io/terms-conditions. For further |
| ** information use the contact form at https://www.qt.io/contact-us. |
| ** |
| ** GNU Lesser General Public License Usage |
| ** Alternatively, this file may be used under the terms of the GNU Lesser |
| ** General Public License version 3 as published by the Free Software |
| ** Foundation and appearing in the file LICENSE.LGPL3 included in the |
| ** packaging of this file. Please review the following information to |
| ** ensure the GNU Lesser General Public License version 3 requirements |
| ** will be met: https://www.gnu.org/licenses/lgpl-3.0.html. |
| ** |
| ** GNU General Public License Usage |
| ** Alternatively, this file may be used under the terms of the GNU |
| ** General Public License version 2.0 or (at your option) the GNU General |
| ** Public license version 3 or any later version approved by the KDE Free |
| ** Qt Foundation. The licenses are as published by the Free Software |
| ** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3 |
| ** included in the packaging of this file. Please review the following |
| ** information to ensure the GNU General Public License requirements will |
| ** be met: https://www.gnu.org/licenses/gpl-2.0.html and |
| ** https://www.gnu.org/licenses/gpl-3.0.html. |
| ** |
| ** $QT_END_LICENSE$ |
| ** |
| ****************************************************************************/ |
| |
| #ifndef QACTION_H |
| #define QACTION_H |
| |
| #include <QtWidgets/qtwidgetsglobal.h> |
| #include <QtGui/qkeysequence.h> |
| #include <QtCore/qstring.h> |
| #include <QtWidgets/qwidget.h> |
| #include <QtCore/qvariant.h> |
| #include <QtGui/qicon.h> |
| |
| QT_BEGIN_NAMESPACE |
| |
| |
| #ifndef QT_NO_ACTION |
| |
| class QMenu; |
| class QActionGroup; |
| class QActionPrivate; |
| class QGraphicsWidget; |
| |
| class Q_WIDGETS_EXPORT QAction : public QObject |
| { |
| Q_OBJECT |
| Q_DECLARE_PRIVATE(QAction) |
| |
| Q_PROPERTY(bool checkable READ isCheckable WRITE setCheckable NOTIFY changed) |
| Q_PROPERTY(bool checked READ isChecked WRITE setChecked DESIGNABLE isCheckable NOTIFY toggled) |
| Q_PROPERTY(bool enabled READ isEnabled WRITE setEnabled NOTIFY changed) |
| Q_PROPERTY(QIcon icon READ icon WRITE setIcon NOTIFY changed) |
| Q_PROPERTY(QString text READ text WRITE setText NOTIFY changed) |
| Q_PROPERTY(QString iconText READ iconText WRITE setIconText NOTIFY changed) |
| Q_PROPERTY(QString toolTip READ toolTip WRITE setToolTip NOTIFY changed) |
| Q_PROPERTY(QString statusTip READ statusTip WRITE setStatusTip NOTIFY changed) |
| Q_PROPERTY(QString whatsThis READ whatsThis WRITE setWhatsThis NOTIFY changed) |
| Q_PROPERTY(QFont font READ font WRITE setFont NOTIFY changed) |
| #if QT_CONFIG(shortcut) |
| Q_PROPERTY(QKeySequence shortcut READ shortcut WRITE setShortcut NOTIFY changed) |
| Q_PROPERTY(Qt::ShortcutContext shortcutContext READ shortcutContext WRITE setShortcutContext NOTIFY changed) |
| Q_PROPERTY(bool autoRepeat READ autoRepeat WRITE setAutoRepeat NOTIFY changed) |
| #endif |
| Q_PROPERTY(bool visible READ isVisible WRITE setVisible NOTIFY changed) |
| Q_PROPERTY(MenuRole menuRole READ menuRole WRITE setMenuRole NOTIFY changed) |
| Q_PROPERTY(bool iconVisibleInMenu READ isIconVisibleInMenu WRITE setIconVisibleInMenu NOTIFY changed) |
| Q_PROPERTY(bool shortcutVisibleInContextMenu READ isShortcutVisibleInContextMenu WRITE setShortcutVisibleInContextMenu NOTIFY changed) |
| Q_PROPERTY(Priority priority READ priority WRITE setPriority) |
| |
| public: |
| // note this is copied into qplatformmenu.h, which must stay in sync |
| enum MenuRole { NoRole = 0, TextHeuristicRole, ApplicationSpecificRole, AboutQtRole, |
| AboutRole, PreferencesRole, QuitRole }; |
| Q_ENUM(MenuRole) |
| enum Priority { LowPriority = 0, |
| NormalPriority = 128, |
| HighPriority = 256}; |
| Q_ENUM(Priority) |
| explicit QAction(QObject *parent = nullptr); |
| explicit QAction(const QString &text, QObject *parent = nullptr); |
| explicit QAction(const QIcon &icon, const QString &text, QObject *parent = nullptr); |
| |
| ~QAction(); |
| |
| void setActionGroup(QActionGroup *group); |
| QActionGroup *actionGroup() const; |
| void setIcon(const QIcon &icon); |
| QIcon icon() const; |
| |
| void setText(const QString &text); |
| QString text() const; |
| |
| void setIconText(const QString &text); |
| QString iconText() const; |
| |
| void setToolTip(const QString &tip); |
| QString toolTip() const; |
| |
| void setStatusTip(const QString &statusTip); |
| QString statusTip() const; |
| |
| void setWhatsThis(const QString &what); |
| QString whatsThis() const; |
| |
| void setPriority(Priority priority); |
| Priority priority() const; |
| |
| #if QT_CONFIG(menu) |
| QMenu *menu() const; |
| void setMenu(QMenu *menu); |
| #endif |
| |
| void setSeparator(bool b); |
| bool isSeparator() const; |
| |
| #if QT_CONFIG(shortcut) |
| void setShortcut(const QKeySequence &shortcut); |
| QKeySequence shortcut() const; |
| |
| void setShortcuts(const QList<QKeySequence> &shortcuts); |
| void setShortcuts(QKeySequence::StandardKey); |
| QList<QKeySequence> shortcuts() const; |
| |
| void setShortcutContext(Qt::ShortcutContext context); |
| Qt::ShortcutContext shortcutContext() const; |
| |
| void setAutoRepeat(bool); |
| bool autoRepeat() const; |
| #endif |
| |
| void setFont(const QFont &font); |
| QFont font() const; |
| |
| void setCheckable(bool); |
| bool isCheckable() const; |
| |
| QVariant data() const; |
| void setData(const QVariant &var); |
| |
| bool isChecked() const; |
| |
| bool isEnabled() const; |
| |
| bool isVisible() const; |
| |
| enum ActionEvent { Trigger, Hover }; |
| void activate(ActionEvent event); |
| bool showStatusText(QWidget *widget = nullptr); |
| |
| void setMenuRole(MenuRole menuRole); |
| MenuRole menuRole() const; |
| |
| void setIconVisibleInMenu(bool visible); |
| bool isIconVisibleInMenu() const; |
| |
| void setShortcutVisibleInContextMenu(bool show); |
| bool isShortcutVisibleInContextMenu() const; |
| |
| QWidget *parentWidget() const; |
| |
| QList<QWidget *> associatedWidgets() const; |
| #if QT_CONFIG(graphicsview) |
| QList<QGraphicsWidget *> associatedGraphicsWidgets() const; // ### suboptimal |
| #endif |
| |
| protected: |
| bool event(QEvent *) override; |
| QAction(QActionPrivate &dd, QObject *parent); |
| |
| public Q_SLOTS: |
| void trigger() { activate(Trigger); } |
| void hover() { activate(Hover); } |
| void setChecked(bool); |
| void toggle(); |
| void setEnabled(bool); |
| inline void setDisabled(bool b) { setEnabled(!b); } |
| void setVisible(bool); |
| |
| Q_SIGNALS: |
| void changed(); |
| void triggered(bool checked = false); |
| void hovered(); |
| void toggled(bool); |
| |
| private: |
| Q_DISABLE_COPY(QAction) |
| |
| friend class QGraphicsWidget; |
| friend class QWidget; |
| friend class QActionGroup; |
| friend class QMenu; |
| friend class QMenuPrivate; |
| friend class QMenuBar; |
| friend class QToolButton; |
| #ifdef Q_OS_MAC |
| friend void qt_mac_clear_status_text(QAction *action); |
| #endif |
| }; |
| |
| #ifndef QT_NO_DEBUG_STREAM |
| Q_WIDGETS_EXPORT QDebug operator<<(QDebug, const QAction *); |
| #endif |
| |
| QT_BEGIN_INCLUDE_NAMESPACE |
| #include <QtWidgets/qactiongroup.h> |
| QT_END_INCLUDE_NAMESPACE |
| |
| #endif // QT_NO_ACTION |
| |
| QT_END_NAMESPACE |
| |
| #endif // QACTION_H |