QAction

QAction 

头文件

#include <QAction>

 

函数

QAction(QObject *parent = nullptr)
QAction(const QString &text, QObject *parent = nullptr)
QAction(const QIcon &icon, const QString &text, QObject *parent = nullptr)
virtual    ~QAction()
QActionGroup *    actionGroup() const
void    activate(QAction::ActionEvent event)
QList<QGraphicsWidget *>    associatedGraphicsWidgets() const
QList<QWidget *>    associatedWidgets() const
bool    autoRepeat() const
QVariant    data() const
QFont    font() const
QIcon    icon() const
QString    iconText() const
bool    isCheckable() const
bool    isChecked() const
bool    isEnabled() const
bool    isIconVisibleInMenu() const
bool    isSeparator() const
bool    isShortcutVisibleInContextMenu() const
bool    isVisible() const
QMenu *    menu() const
QAction::MenuRole    menuRole() const
QWidget *    parentWidget() const
QAction::Priority    priority() const
void    setActionGroup(QActionGroup *group)
void    setAutoRepeat(bool)
void    setCheckable(bool)
void    setData(const QVariant &userData)
void    setFont(const QFont &font)
void    setIcon(const QIcon &icon)
void    setIconText(const QString &text)
void    setIconVisibleInMenu(bool visible)
void    setMenu(QMenu *menu)
void    setMenuRole(QAction::MenuRole menuRole)
void    setPriority(QAction::Priority priority)
void    setSeparator(bool b)
void    setShortcut(const QKeySequence &shortcut)
void    setShortcutContext(Qt::ShortcutContext context)
void    setShortcutVisibleInContextMenu(bool show)
void    setShortcuts(const QList<QKeySequence> &shortcuts)
void    setShortcuts(QKeySequence::StandardKey key)
void    setStatusTip(const QString &statusTip)
void    setText(const QString &text)
void    setToolTip(const QString &tip)
void    setWhatsThis(const QString &what)
QKeySequence    shortcut() const
Qt::ShortcutContext    shortcutContext() const
QList<QKeySequence>    shortcuts() const
bool    showStatusText(QWidget *widget = nullptr)
QString    statusTip() const
QString    text() const
QString    toolTip() const
QString    whatsThis() const

 

Slots

void    hover()
void    setChecked(bool)
void    setDisabled(bool b)
void    setEnabled(bool)
void    setVisible(bool)
void    toggle()
void    trigger()

 

Signals

void    changed()
void    hovered()
void    toggled(bool checked)
void    triggered(bool checked = false)

 

描述：

QAction类提供了一个抽象的用户界面操作，可以插入到小部件中。

在应用程序中，可以通过菜单、工具栏按钮和键盘快捷键调用许多常用命令。由于用户希望每个命令都以相同的方式执行，因此无论使用何种用户界面，将每个命令表示为一个操作都很有用。

操作可以添加到菜单和工具栏，并将自动保持同步。例如，在文字处理器中，如果用户按下粗体工具栏按钮，粗体菜单项将自动被选中。

动作可以作为独立对象创建，但也可以在构建菜单时创建；QMenu类包含方便的函数，用于创建适合用作菜单项的操作。

QAction可能包含图标、菜单文本、快捷方式、状态文本、“这是什么？”文本和工具提示。其中大部分可以在构造函数中设置。也可以使用setIcon（）、setText（）、setIconText（）、setShortcut（）、setStatusTip（）、setWhatsThis（）和setToolTip（）单独设置它们。对于菜单项，可以使用setFont（）设置单个字体。

使用QWidget:：addAction（）或QGraphicsWidget:：addAction（）将操作添加到小部件。请注意，在使用小部件之前，必须将操作添加到小部件中；当快捷方式应该是全局的（即Qt:：ApplicationShortcut作为Qt:：ShortcutContext）时也是如此。

创建QAction后，应将其添加到相关菜单和工具栏，然后连接到将执行该操作的插槽。例如：

 

 

################################