qaction.h
上传用户:detong
上传日期:2022-06-22
资源大小:20675k
文件大小:8k
源码类别:

系统编程

开发平台:

Unix_Linux

  1. /****************************************************************************
  2. **
  3. ** Copyright (C) 2008 Nokia Corporation and/or its subsidiary(-ies).
  4. ** Contact: Qt Software Information (qt-info@nokia.com)
  5. **
  6. ** This file is part of the QtGui module of the Qt Toolkit.
  7. **
  8. ** Commercial Usage
  9. ** Licensees holding valid Qt Commercial licenses may use this file in
  10. ** accordance with the Qt Commercial License Agreement provided with the
  11. ** Software or, alternatively, in accordance with the terms contained in
  12. ** a written agreement between you and Nokia.
  13. **
  14. **
  15. ** GNU General Public License Usage
  16. ** Alternatively, this file may be used under the terms of the GNU
  17. ** General Public License versions 2.0 or 3.0 as published by the Free
  18. ** Software Foundation and appearing in the file LICENSE.GPL included in
  19. ** the packaging of this file.  Please review the following information
  20. ** to ensure GNU General Public Licensing requirements will be met:
  21. ** http://www.fsf.org/licensing/licenses/info/GPLv2.html and
  22. ** http://www.gnu.org/copyleft/gpl.html.  In addition, as a special
  23. ** exception, Nokia gives you certain additional rights. These rights
  24. ** are described in the Nokia Qt GPL Exception version 1.3, included in
  25. ** the file GPL_EXCEPTION.txt in this package.
  26. **
  27. ** Qt for Windows(R) Licensees
  28. ** As a special exception, Nokia, as the sole copyright holder for Qt
  29. ** Designer, grants users of the Qt/Eclipse Integration plug-in the
  30. ** right for the Qt/Eclipse Integration to link to functionality
  31. ** provided by Qt Designer and its related libraries.
  32. **
  33. ** If you are unsure which license is appropriate for your use, please
  34. ** contact the sales department at qt-sales@nokia.com.
  35. **
  36. ****************************************************************************/
  37. #ifndef QACTION_H
  38. #define QACTION_H
  39. #include <QtGui/qkeysequence.h>
  40. #include <QtCore/qstring.h>
  41. #include <QtGui/qwidget.h>
  42. #include <QtCore/qvariant.h>
  43. #include <QtGui/qicon.h>
  44. QT_BEGIN_HEADER
  45. QT_BEGIN_NAMESPACE
  46. QT_MODULE(Gui)
  47. #ifndef QT_NO_ACTION
  48. class QMenu;
  49. class QActionGroup;
  50. class QActionPrivate;
  51. class Q_GUI_EXPORT QAction : public QObject
  52. {
  53.     Q_OBJECT
  54.     Q_DECLARE_PRIVATE(QAction)
  55.     Q_ENUMS(MenuRole)
  56.     Q_PROPERTY(bool checkable READ isCheckable WRITE setCheckable)
  57.     Q_PROPERTY(bool checked READ isChecked WRITE setChecked DESIGNABLE isCheckable NOTIFY toggled)
  58.     Q_PROPERTY(bool enabled READ isEnabled WRITE setEnabled)
  59.     Q_PROPERTY(QIcon icon READ icon WRITE setIcon)
  60.     Q_PROPERTY(QString text READ text WRITE setText)
  61.     Q_PROPERTY(QString iconText READ iconText WRITE setIconText)
  62.     Q_PROPERTY(QString toolTip READ toolTip WRITE setToolTip)
  63.     Q_PROPERTY(QString statusTip READ statusTip WRITE setStatusTip)
  64.     Q_PROPERTY(QString whatsThis READ whatsThis WRITE setWhatsThis)
  65.     Q_PROPERTY(QFont font READ font WRITE setFont)
  66. #ifndef QT_NO_SHORTCUT
  67.     Q_PROPERTY(QKeySequence shortcut READ shortcut WRITE setShortcut)
  68.     Q_PROPERTY(Qt::ShortcutContext shortcutContext READ shortcutContext WRITE setShortcutContext)
  69.     Q_PROPERTY(bool autoRepeat READ autoRepeat WRITE setAutoRepeat)
  70. #endif
  71.     Q_PROPERTY(bool visible READ isVisible WRITE setVisible)
  72.     Q_PROPERTY(MenuRole menuRole READ menuRole WRITE setMenuRole)
  73.     Q_PROPERTY(bool iconVisibleInMenu READ isIconVisibleInMenu WRITE setIconVisibleInMenu)
  74. public:
  75.     enum MenuRole { NoRole, TextHeuristicRole, ApplicationSpecificRole, AboutQtRole,
  76.                     AboutRole, PreferencesRole, QuitRole };
  77.     explicit QAction(QObject* parent);
  78.     QAction(const QString &text, QObject* parent);
  79.     QAction(const QIcon &icon, const QString &text, QObject* parent);
  80. #ifdef QT3_SUPPORT
  81.     QT3_SUPPORT_CONSTRUCTOR QAction(QObject* parent, const char* name);
  82.     QT3_SUPPORT_CONSTRUCTOR QAction(const QString &text, const QKeySequence &shortcut,
  83.                                     QObject* parent, const char* name);
  84.     QT3_SUPPORT_CONSTRUCTOR QAction(const QIcon &icon, const QString &text,
  85.                                     const QKeySequence &shortcut,
  86.                                     QObject* parent, const char* name);
  87. #endif
  88.     ~QAction();
  89.     void setActionGroup(QActionGroup *group);
  90.     QActionGroup *actionGroup() const;
  91.     void setIcon(const QIcon &icon);
  92.     QIcon icon() const;
  93.     void setText(const QString &text);
  94.     QString text() const;
  95.     void setIconText(const QString &text);
  96.     QString iconText() const;
  97.     void setToolTip(const QString &tip);
  98.     QString toolTip() const;
  99.     void setStatusTip(const QString &statusTip);
  100.     QString statusTip() const;
  101.     void setWhatsThis(const QString &what);
  102.     QString whatsThis() const;
  103. #ifndef QT_NO_MENU
  104.     QMenu *menu() const;
  105.     void setMenu(QMenu *menu);
  106. #endif
  107.     void setSeparator(bool b);
  108.     bool isSeparator() const;
  109. #ifndef QT_NO_SHORTCUT
  110.     void setShortcut(const QKeySequence &shortcut);
  111.     QKeySequence shortcut() const;
  112.     void setShortcuts(const QList<QKeySequence> &shortcuts);
  113.     void setShortcuts(QKeySequence::StandardKey);
  114.     QList<QKeySequence> shortcuts() const;
  115.     void setShortcutContext(Qt::ShortcutContext context);
  116.     Qt::ShortcutContext shortcutContext() const;
  117.     void setAutoRepeat(bool);
  118.     bool autoRepeat() const;
  119. #endif
  120.     void setFont(const QFont &font);
  121.     QFont font() const;
  122.     void setCheckable(bool);
  123.     bool isCheckable() const;
  124.     QVariant data() const;
  125.     void setData(const QVariant &var);
  126.     bool isChecked() const;
  127.     bool isEnabled() const;
  128.     bool isVisible() const;
  129.     enum ActionEvent { Trigger, Hover };
  130.     void activate(ActionEvent event);
  131.     bool showStatusText(QWidget *widget=0);
  132.     void setMenuRole(MenuRole menuRole);
  133.     MenuRole menuRole() const;
  134.     void setIconVisibleInMenu(bool visible);
  135.     bool isIconVisibleInMenu() const;
  136. #ifdef QT3_SUPPORT
  137.     inline QT3_SUPPORT void setMenuText(const QString &text) { setText(text); }
  138.     inline QT3_SUPPORT QString menuText() const { return text(); }
  139.     inline QT3_SUPPORT bool isOn() const { return isChecked(); }
  140.     inline QT3_SUPPORT bool isToggleAction() const { return isCheckable(); }
  141.     inline QT3_SUPPORT void setToggleAction(bool b) { setCheckable(b); }
  142.     inline QT3_SUPPORT void setIconSet(const QIcon &i) { setIcon(i); }
  143.     inline QT3_SUPPORT QIcon iconSet() const { return icon(); }
  144.     inline QT3_SUPPORT bool addTo(QWidget *w) { w->addAction(this); return true; }
  145.     inline QT3_SUPPORT bool removeFrom(QWidget *w) { w->removeAction(this); return true; }
  146.     inline QT3_SUPPORT void setAccel(const QKeySequence &shortcut) { setShortcut(shortcut); }
  147.     inline QT3_SUPPORT QKeySequence accel() const { return shortcut(); }
  148. #endif
  149.     QWidget *parentWidget() const;
  150.     QList<QWidget *> associatedWidgets() const;
  151. protected:
  152.     bool event(QEvent *);
  153.     QAction(QActionPrivate &dd, QObject *parent);
  154. public Q_SLOTS:
  155. #ifdef QT3_SUPPORT
  156.     inline QT_MOC_COMPAT void setOn(bool b) { setChecked(b); }
  157. #endif
  158.     void trigger() { activate(Trigger); }
  159.     void hover() { activate(Hover); }
  160.     void setChecked(bool);
  161.     void toggle();
  162.     void setEnabled(bool);
  163.     inline void setDisabled(bool b) { setEnabled(!b); }
  164.     void setVisible(bool);
  165. Q_SIGNALS:
  166.     void changed();
  167.     void triggered(bool checked = false);
  168.     void hovered();
  169.     void toggled(bool);
  170. #ifdef QT3_SUPPORT
  171.     QT_MOC_COMPAT void activated(int = 0);
  172. #endif
  173. private:
  174.     Q_DISABLE_COPY(QAction)
  175. #ifdef QT3_SUPPORT
  176.     friend class QMenuItem;
  177. #endif
  178.     friend class QWidget;
  179.     friend class QActionGroup;
  180.     friend class QMenu;
  181.     friend class QMenuPrivate;
  182.     friend class QMenuBar;
  183.     friend class QShortcutMap;
  184.     friend class QToolButton;
  185. };
  186. QT_BEGIN_INCLUDE_NAMESPACE
  187. #include <QtGui/qactiongroup.h>
  188. QT_END_INCLUDE_NAMESPACE
  189. #endif // QT_NO_ACTION
  190. QT_END_NAMESPACE
  191. QT_END_HEADER
  192. #endif // QACTION_H