QAction 类

成员函数文档

[显式构造函数] QAction::QAction(QObject *parent = nullptr)

使用 parent 构造动作。如果 parent 是动作组，则动作将自动插入到组中。

[显式构造函数] QAction::QAction(const QString &text, QObject *parent = nullptr)

构建一个包含一些 文本 和 父对象 的动作。如果 父对象 是动作组，该动作将被自动插入该组。

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

另请参阅文本。

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

构建一个包含 图标 和一些 文本 以及 父对象 的动作。如果 父对象 是动作组，则该动作将被自动插入该组。

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

另请参阅文字 和 图标。

[虚函数 noexcept] QAction::~QAction()

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

QActionGroup *QAction::actionGroup() const

返回此动作的动作组。如果没有动作组管理此动作，则将返回 nullptr。

另请参阅QActionGroup 和 setActionGroup。

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

发送与 ActionEvent 事件 相关的信号。

基于动作的控件使用此 API 使 QAction 发出信号，同时发出它们自己的信号。

[自 6.0 版本以来] QList<QObject *> QAction::associatedObjects() const

返回此动作已添加到的对象列表。

此函数自 Qt 6.0 版本引入。

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

[信号] void QAction::changed()

当动作发生变化时，会发出此信号。如果您只对特定控件中的动作感兴趣，可以监听带有 QEvent::ActionChanged 的 QWidget::actionEvent()。

另请参阅 QWidget::actionEvent。

QVariant QAction::data() const

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

另请参阅 setData。

[重写虚保护] bool QAction::event(QEvent *e)

重实现: QObject::event(QEvent *e).

[槽] void QAction::hover()

这是一个方便的槽，它调用 activate(Hover)。

[信号] 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。

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

这是一个对 enabled 属性的便利函数，对于信号-槽连接很有用。如果 b 为 true，则禁用动作；否则启用。

void QAction::setMenu(QMenu *menu)

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

另请参阅 menu。

void QAction::setSeparator(bool b)

如果 b 为 true，则此动作将被视为分隔符。

分隔符的表示方式取决于它插入的部件。在大多数情况下，分隔符动作将忽略文本、子菜单和图标。

另请参阅 isSeparator。

void QAction::setShortcut(const QKeySequence &shortcut)

将快捷键 设置为触发动作的唯一快捷键。

另请参阅 shortcut 和 setShortcuts。

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

将快捷键 设置为触发动作的快捷键列表。列表的第一个元素是主要快捷键。

另请参阅 shortcuts，shortcut 和 setShortcut。

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

根据键 设置平台依赖的快捷键列表。此函数调用的结果取决于当前运行的平台。注意，此动作可以分配多个快捷键。如果只需主要快捷键，请使用 setShortcut。

另请参阅 QKeySequence::keyBindings。

QKeySequence QAction::shortcut() const

返回主要快捷键。

另请参阅 setShortcuts。

QList<QKeySequence> QAction::shortcuts() const

返回快捷键列表，其中主要快捷键为列表的第一个元素。

另请参阅 setShortcuts。

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

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

如果指定了空控件，将事件发送到动作的父控件。

另请参阅 statusTip。

[slot] void QAction::toggle()

这是一个用于 checked 属性的便利函数。连接到此以将选中状态切换为它的相反状态。

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

每当可检查的动作更改其 isChecked() 状态时，都会触发此信号。这可能是由于用户交互，或者由于调用了 setChecked()。由于 setChecked() 改变了 QAction，所以除了 toggled()，它还会发射 changed()。

checked 为 true，如果动作被选中，或为 false，如果动作未被选中。

另请参阅activate()，triggered() 和 checked。

[槽] void QAction::trigger()

这是一个便利槽，它调用 activate(触发器)。

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

当动作被用户激活时发出此信号；例如，当用户点击菜单选项、工具栏按钮或按动作的快捷键组合，或者调用 trigger() 时。值得注意的是，当调用 setChecked() 或 toggle() 时不会发出此信号。

如果动作是可复选的，则当动作被选中时 checked 为 true，如果未选中则为 false。

另请参阅activate()，toggled() 和 checked。