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 为真时调用setExclusionPolicy(ExclusionPolicy::Exclusive) ，否则调用setExclusionPolicy(QActionGroup::ExclusionPolicy::None) 。

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

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

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

命令操作会连接到该信号。

另请参阅 QAction::activate() 。