class QActionGroup#

QActionGroup类将动作分组。 更多…

Inheritance diagram of PySide6.QtGui.QActionGroup

摘要#

属性#

方法#

槽函数#

信号#

注意

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

详细描述#

QActionGroup 是一个基类，用于组合继承自 QAction 对象的类。

在某些情况下，组合 QAction 对象是有用的。例如，如果您有一个左对齐操作、一个右对齐操作、一个居中对齐操作和一个中心对齐操作，那么在任何给定时间内只有一个这些操作应该是活动的。实现这一点的一个简单方法是将这些操作组合在一个动作组中，继承自 QActionGroup。

另请参阅

QAction

类ExclusionPolicy#

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

常量

描述

QActionGroup.ExclusionPolicy.None

组中的动作可以独立于彼此进行检查。

QActionGroup.ExclusionPolicy.Exclusive

任何时间只能检查一个动作。这是默认策略。

QActionGroup.ExclusionPolicy.ExclusiveOptional

任何时间最多只能检查一个动作。动作也可以全部未选中。

另请参阅

exclusionPolicy

注意

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

属性enabledᅟ: bool#

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

除非它已被明确禁用，否则组中的每个动作都将是启用或禁用的。

另请参阅

setEnabled()

访问函数
属性exclusionPolicy: QActionGroup.ExclusionPolicy#

这个属性包含此属性的组独享检查策略。

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

另请参阅

checkable

访问函数
属性visible: bool#

这个属性决定了这个动作组是否可见。

除非动作已被明确隐藏，否则动作组中的每个动作都将与这个组的可见状态相匹配。

另请参阅

setEnabled()

访问函数
__init__(parent)#
参数:

parent – QObject

为父对象构造一个动作组。

动作组默认是独享的。调用 setExclusive (false) 来使动作组非独享。要使组独享但允许取消勾选活动动作，请调用 setExclusionPolicy ( ExclusiveOptional )

actions()#
返回类型:

.列表 QAction

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

addAction(a)#
参数:

a – QAction

返回类型:

QAction

将动作 action 添加到该组，并返回它。

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

另请参阅

setActionGroup()

addAction(icon, text)
参数:

  • icon – QIcon

  • text – 字符串

返回类型:

QAction

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

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

另请参阅

setActionGroup()

addAction(text)
参数:

text – 字符串

返回类型:

QAction

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

通常通过将组作为父项创建动作将其添加到组中，因此这个函数通常不使用。

另请参阅

setActionGroup()

checkedAction()#
返回类型:

QAction

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

exclusionPolicy()#
返回类型:

排除策略

另请参阅

setExclusionPolicy()

属性 exclusionPolicyᅟ 的获取器。

hovered(arg__1)#
参数:

arg__1 – QAction

isEnabled()#
返回类型:

布尔值

属性 enabledᅟ 的获取器。

isExclusive()#
返回类型:

布尔值

如果组是排他的，则返回 true

组是排他的，如果ExclusionPolicy 是 Exclusive 或 ExclusionOptional。

isVisible()#
返回类型:

布尔值

属性 visibleᅟ 的获取器。

removeAction(a)#
参数:

a – QAction

从该组中删除 action。动作将没有父项。

另请参阅

setActionGroup()

setDisabled(b)#
参数:

b – 布尔值

这是为 enabled 属性提供的便利函数，对于信号-槽连接非常有用。如果 b 为真，则禁用动作组；否则启用。

setEnabled(arg__1)#
参数:

arg__1 – bool

另请参阅

isEnabled()

enabledᅟ 属性的设置器。

setExclusionPolicy(policy)#
参数:

policy – ExclusionPolicy

另请参阅

exclusionPolicy()

exclusionPolicyᅟ 属性的设置器。

setExclusive(arg__1)#
参数:

arg__1 – bool

启用或禁用组排除检查

这是一个便利方法，当 b 为真时，调用 setExclusionPolicy ( Exclusive )，否则调用 setExclusionPolicy ( None )。

setVisible(arg__1)#
参数:

arg__1 – bool

另请参阅

isVisible()

visibleᅟ 属性的设置器。

triggered(arg__1)#
参数:

arg__1 – QAction