QAction Class

成员函数文档

[explicit] QAction::QAction(QObject *parent = nullptr)

使用parent 构建一个操作。如果parent 是一个操作组，则该操作将自动插入到该组中。

[explicit] QAction::QAction(const QString &text, QObject *parent = nullptr)

根据text 和parent 构建一个操作。如果parent 是一个操作组，则该操作将自动插入到该组中。

text 的精简版本（例如，“&Menu Option...”将变为“Menu Option”）将用于工具提示和图标文本，除非您分别通过setToolTip() 或setIconText() 指定了不同的文本。

另请参阅 text 。

[explicit] QAction::QAction(const QIcon &icon, const QString &text, QObject *parent = nullptr)

使用icon 以及text 和parent 构建一个操作。如果parent 是一个操作组，该操作将自动插入到该组中。

text 的简化版本（例如，“&菜单选项...”将变为“菜单选项”）将用于工具提示和图标文本，除非您分别使用setToolTip()或setIconText()指定了不同的文本。

另请参阅 text 和icon 。

[virtual noexcept] QAction::~QAction()

销毁该对象并释放已分配的资源。

QActionGroup *QAction::actionGroup() const

返回此操作所属的操作组。如果没有操作组管理此操作，则返回nullptr 。

另请参阅 QActionGroup 和setActionGroup()。

void QAction::activate(QAction::ActionEvent event)

向ActionEvent 发送相关信号event 。

基于操作的小部件使用此 API 使QAction 发出信号，同时也会发出自己的信号。

[since 6.0] QList<QObject *> QAction::associatedObjects() const

返回一个包含已添加此操作的对象列表。

该函数在 Qt 6.0 中引入。

另请参阅 QWidget::addAction() 和QGraphicsWidget::addAction()。

[signal] void QAction::changed()

当某个操作发生变化时，会触发此信号。如果您仅关注特定控件中的操作，可以监听随QEvent::ActionChanged 发送的QWidget::actionEvent()信号。

另请参阅 QWidget::actionEvent()。

QVariant QAction::data() const

返回在QAction::setData 中设置的用户数据。

另请参阅 setData()。

[override virtual protected] bool QAction::event(QEvent *e)

重写了：QObject::event(QEvent *e)。

[slot] void QAction::hover()

这是一个调用 activate(Hover) 方法的便捷插槽。

[signal] void QAction::hovered()

当用户选中某个操作时，会发出此信号；例如，当用户将光标悬停在菜单选项或工具栏按钮上，或者按下该操作的快捷键组合时。

另请参阅 activate()。

bool QAction::isSeparator() const

如果此操作是分隔符操作，则返回true ；否则返回false 。

另请参阅 setSeparator()。

QMenu *QAction::menu() const

返回此操作所包含的菜单。

在控件应用程序中，包含菜单的操作可用于创建带有子菜单的菜单项，或插入到工具栏中以创建带有弹出菜单的按钮。

另请参阅 setMenu()、QMenu::addAction() 和QMenu::menuInAction()。

void QAction::setActionGroup(QActionGroup *group)

将此操作组设置为“group ”。该操作将自动添加到该组的操作列表中。

该组内的操作将相互排斥。

另请参阅 QActionGroup 和actionGroup()。

void QAction::setData(const QVariant &data)

将操作的内部数据设置为给定的data 。

另请参阅 data()。

[slot] void QAction::setDisabled(bool b)

这是一个用于enabled 属性的便捷函数，在信号-槽连接中非常有用。如果b 为true，则该操作被禁用；否则，该操作被启用。

void QAction::setMenu(QMenu *menu)

将此操作所包含的菜单设置为指定的menu 。

另请参阅 menu()。

void QAction::setSeparator(bool b)

如果 `b ` 为真，则该操作将被视为分隔符。

分隔符的显示方式取决于其插入的控件。在大多数情况下，分隔符操作中的文本、子菜单和图标将被忽略。

另请参阅 isSeparator()。

void QAction::setShortcut(const QKeySequence &shortcut)

将shortcut 设置为触发该操作的唯一快捷键。

另请参阅 shortcut 和setShortcuts()。

void QAction::setShortcuts(QKeySequence::StandardKey key)

根据key 设置一组与平台相关的快捷键列表。调用此函数的结果将取决于当前运行的平台。请注意，此操作可分配多个快捷键。如果仅需主快捷键，请改用setShortcut 。

另请参阅 shortcuts() 和QKeySequence::keyBindings()。

void QAction::setShortcuts(const QList<QKeySequence> &shortcuts)

将 `shortcuts ` 设置为触发该操作的快捷键列表。列表中的第一个元素是主快捷键。

另请参阅 shortcut 以及setShortcut()。

QKeySequence QAction::shortcut() const

返回主快捷方式。

另请参阅 setShortcuts()。

QList<QKeySequence> QAction::shortcuts() const

返回快捷方式列表，其中主快捷方式作为列表的第一个元素。

另请参阅 ` setShortcuts()`。

bool QAction::showStatusText(QObject *object = nullptr)

通过发送QStatusTipEvent 来更新由object 表示的UI的相关状态栏。如果已发送事件，则返回true ；否则返回false 。

如果指定了 null 小部件，则将事件发送到该操作的父级。

另请参阅 statusTip 。

[slot] void QAction::toggle()

这是一个用于checked 属性的便捷函数。调用该函数可将选中状态切换为相反状态。

[signal] void QAction::toggled(bool checked)

每当可选中操作（checkable action）的isChecked()状态发生变化时，都会触发此信号。这可能是用户交互的结果，也可能是因为调用了setChecked()。由于setChecked()会更改QAction ，因此它除了触发toggled()外，还会触发changed()。

checked 如果该操作被选中，则返回 true；如果未被选中，则返回 false。

另请参阅 activate()、triggered() 以及checked 。

[slot] void QAction::trigger()

这是一个用于调用 activate(Trigger) 的便捷槽。

[signal] void QAction::triggered(bool checked = false)

当用户触发某个操作时，会发出此信号；例如，当用户单击菜单选项、工具栏按钮，或按下操作的快捷键组合时，或者调用trigger()方法时。需要注意的是，当调用setChecked()或toggle()方法时，不会发出此信号。

如果该操作可选中，当该操作被选中时，checked 返回 true；若未被选中，则返回 false。

另请参阅 activate()、toggled() 以及checked 。