QActionGroup Class

成员函数文档

[explicit] QActionGroup::QActionGroup(QObject *parent)

为parent 对象创建一个操作组。

该操作组默认是排他性的。调用setExclusive(false) 可将操作组设为非排他性。若要使该组保持排他性，但允许取消选中当前活动操作，请改用setExclusionPolicy(QActionGroup::ExclusionPolicy::ExclusiveOptional)

[virtual noexcept] QActionGroup::~QActionGroup()

删除该操作组。

QList<QAction *> QActionGroup::actions() const

返回该组的操作列表。该列表可能为空。

QAction *QActionGroup::addAction(QAction *action)

将action 添加到该组中，并返回该组。

通常，将一个操作添加到组中是通过将其父组设为该组来创建该操作的，因此该函数通常不会被使用。

另请参阅 QAction::setActionGroup()。

QAction *QActionGroup::addAction(const QString &text)

创建并返回一个具有text 的动作。新创建的动作是该动作组的子动作。

通常，通过将操作创建为该组的子项来将其添加到组中，因此此函数通常不会被使用。

另请参阅 QAction::setActionGroup()。

QAction *QActionGroup::addAction(const QIcon &icon, const QString &text)

创建并返回一个包含text 和icon 的操作。新创建的操作是该操作组的子操作。

通常，通过将操作创建为该组的子操作来将其添加到组中，因此此函数通常不被使用。

另请参阅 QAction::setActionGroup()。

QAction *QActionGroup::checkedAction() const

返回该组中当前选中的操作，如果未选中任何操作，则返回nullptr 。

[signal] void QActionGroup::hovered(QAction *action)

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

另请参阅 QAction::activate()。

bool QActionGroup::isExclusive() const

如果该组为排他组，则返回 true

若ExclusionPolicy 的值为Exclusive或ExclusionOptional，则该组为排他组。

void QActionGroup::removeAction(QAction *action)

将action 从该组中移除。此操作完成后，该 将不再有父级。

另请参阅 QAction::setActionGroup()。

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

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

[slot] void QActionGroup::setExclusive(bool b)

启用或禁用组排除检查

这是一个便捷方法，当b 为 true 时，它会调用setExclusionPolicy （ExclusionPolicy::Exclusive ）；否则，则调用setExclusionPolicy （QActionGroup::ExclusionPolicy::None ）。

另请参阅 isExclusive() 和QActionGroup::exclusionPolicy 。

[signal] void QActionGroup::triggered(QAction *action)

当用户激活操作组中指定的action 时，会发出此信号；例如，当用户单击菜单选项或工具栏按钮，或按下操作的快捷键组合时。

请将此信号连接到命令操作。

另请参阅 QAction::activate()。