PySide6.QtGui.QActionGroup¶

class QActionGroup¶

QActionGroup 类将动作分组在一起。更多…

概要¶

属性¶

• enabledᅟ - 操作组是否启用

• exclusionPolicyᅟ - 此属性保存组独占检查策略

• visibleᅟ - 操作组是否可见

方法¶

• def __init__()

• def actions()

• def addAction()

• def checkedAction()

• def exclusionPolicy()

• def isEnabled()

• def isExclusive()

• def isVisible()

• def removeAction()

插槽¶

• def setDisabled()

• def setEnabled()

• def setExclusionPolicy()

• def setExclusive()

• def setVisible()

信号¶

• def hovered()

• def triggered()

注意

本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题，您也可以通过在我们的https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。

详细描述¶

QActionGroup 是一个基类，用于将继承 QAction 对象的类分组在一起。

在某些情况下，将QAction对象分组是有用的。例如，如果你有一个左对齐操作、一个右对齐操作、一个两端对齐操作和一个居中对齐操作，任何时候只有一个操作应该是激活的。实现这一点的一个简单方法是将这些操作分组到一个操作组中，继承QActionGroup。

另请参阅

QAction

class ExclusionPolicy¶

此枚举指定了可用于控制组如何对可检查操作执行独占检查的不同策略。

常量	描述
QActionGroup.ExclusionPolicy.None	组中的操作可以相互独立地选中。
QActionGroup.ExclusionPolicy.Exclusive	任何时候只能选中一个操作。这是默认策略。
QActionGroup.ExclusionPolicy.ExclusiveOptional	在任何时候最多只能选中一个操作。操作也可以全部未选中。

另请参阅

exclusionPolicy

注意

当使用from __feature__ import true_property时，属性可以直接使用，否则通过访问器函数使用。

property enabledᅟ: bool¶

此属性表示操作组是否启用。

组中的每个操作将被启用或禁用，除非它已被明确禁用。

另请参阅

setEnabled()

Access functions:

• isEnabled()

• setEnabled()

property exclusionPolicyᅟ: QActionGroup.ExclusionPolicy¶

此属性保存此属性保存组独占检查策略。

如果exclusionPolicy设置为Exclusive，则在任何时候，操作组中只能有一个可检查的操作处于活动状态。如果用户选择组中的另一个可检查操作，他们选择的操作将变为活动状态，而之前处于活动状态的操作将变为非活动状态。如果exclusionPolicy设置为ExclusionOptional，则组是独占的，但组中的活动可检查操作可以取消选中，从而使组中没有操作被选中。

另请参阅

checkable

Access functions:

• exclusionPolicy()

• setExclusionPolicy()

property visibleᅟ: bool¶

此属性表示操作组是否可见。

除非明确隐藏，否则操作组中的每个操作都将匹配此组的可见状态。

另请参阅

setEnabled()

Access functions:

• isVisible()

• setVisible()

__init__(parent)¶

Parameters:

父对象 – QObject

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

默认情况下，操作组是独占的。调用setExclusive (false) 可以使操作组非独占。要使组独占但允许取消选中活动操作，请改为调用setExclusionPolicy ( ExclusiveOptional )

actions()¶

Return type:

QAction的列表

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

addAction(a)¶

Parameters:

a – QAction

Return type:

QAction

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

通常，一个动作是通过将其父级设置为组来添加到组中的，因此通常不使用此函数。

另请参阅

setActionGroup()

addAction(text)

Parameters:

文本 – str

Return type:

QAction

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

通常，通过将组作为父级创建操作来将操作添加到组中，因此通常不使用此函数。

另请参阅

setActionGroup()

addAction(icon, text)

Parameters:

• 图标 – QIcon

• 文本 – str

Return type:

QAction

创建并返回一个带有text和icon的操作。新创建的操作是该操作组的子项。

通常，一个动作是通过将其父级设置为组来添加到组中的，因此这个函数通常不使用。

另请参阅

setActionGroup()

checkedAction()¶

Return type:

QAction

返回组中当前选中的操作，如果没有选中任何操作，则返回None。

exclusionPolicy()¶

Return type:

ExclusionPolicy

另请参阅

setExclusionPolicy()

属性 exclusionPolicyᅟ 的获取器。

hovered(action)¶

Parameters:

动作 – QAction

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

另请参阅

activate()

isEnabled()¶

Return type:

布尔

属性 enabledᅟ 的获取器。

isExclusive()¶

Return type:

布尔

如果组是独占的，则返回 true

如果ExclusionPolicy是Exclusive或ExclusionOptional，则该组是独占的。

isVisible()¶

Return type:

布尔

属性 visibleᅟ 的获取器。

removeAction(a)¶

Parameters:

a – QAction

从该组中移除action。结果，该操作将没有父级。

另请参阅

setActionGroup()

setDisabled(b)¶

Parameters:

b – 布尔值

这是一个方便的函数，用于enabled属性，对于信号-槽连接非常有用。如果b为真，则操作组被禁用；否则，它被启用。

setEnabled(arg__1)¶

Parameters:

arg__1 – 布尔值

另请参阅

isEnabled()

属性 enabledᅟ 的设置器。

setExclusionPolicy(policy)¶

Parameters:

策略 – ExclusionPolicy

另请参阅

exclusionPolicy()

属性 exclusionPolicyᅟ 的设置器。

setExclusive(b)¶

Parameters:

b – 布尔值

启用或禁用组排除检查

这是一个便捷方法，当b为真时调用setExclusionPolicy（Exclusive），否则调用setExclusionPolicy（None）。

另请参阅

isExclusive() exclusionPolicy

setVisible(arg__1)¶

Parameters:

arg__1 – 布尔值

另请参阅

isVisible()

属性 visibleᅟ 的设置器。

triggered(action)¶

Parameters:

动作 – QAction

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

连接到此信号以执行命令操作。

另请参阅

activate()