QAction Class

成员函数文档

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

用parent 构建一个动作。如果parent 是一个动作组，该动作将自动插入该组。

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

用text 和parent 构建一个动作。如果parent 是一个动作组，该动作将自动插入该组。

除非分别使用setToolTip() 或setIconText() 指定不同的文本，否则工具提示和图标文本将使用text 的剥离版本（例如，"&Menu Option... "变为 "Menu Option"）。

另请参阅 text 。

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

构造一个包含icon 以及text 和parent 的操作。如果parent 是一个操作组，该操作将自动插入该组。

除非分别使用setToolTip() 或setIconText() 指定不同的文本，否则工具提示和图标文本将使用text 的剥离版本（例如，"&Menu Option... "变为 "Menu Option"）。

另请参阅 text 和icon 。

[virtual noexcept] QAction::~QAction()

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

QActionGroup *QAction::actionGroup() const

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

另请参阅 QActionGroup 和setActionGroup()。

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

为ActionEvent event 发送相关信号。

基于操作的 widget 可使用此 API 使QAction 发送信号，同时也发送自己的信号。

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

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

此函数在 Qt 6.0 中引入。

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

[signal] void QAction::changed()

该信号在操作发生变化时发出。如果您只对给定 widget 中的操作感兴趣，可以查看QWidget::actionEvent() 发送的QEvent::ActionChanged 。

另请参阅 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

返回该操作包含的菜单。

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

另请参阅 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 为 true，则该操作将被视为分隔符。

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

另请参见 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 所代表的用户界面的相关状态栏。如果发送了事件，则返回true ，否则返回false 。

如果指定的部件为空，事件将发送到操作的父节点。

另请参见 statusTip 。

[slot] void QAction::toggle()

这是checked 属性的方便函数。连接该函数可将选中状态更改为相反状态。

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

每当可检查操作改变其isChecked() 状态时，就会发出该信号。这可能是用户交互的结果，也可能是因为调用了setChecked() 。当setChecked() 更改QAction 时，除了触发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 。