PySide6.QtWidgets.QGroupBox

class QGroupBox

QGroupBox 小部件提供了一个带有标题的组框框架。更多

PySide6.QtWidgets.QGroupBox 的继承图

概要

属性

方法

虚拟方法

插槽

信号

注意

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

详细描述

警告

本节包含从C++自动翻译到Python的代码片段,可能包含错误。

../../_images/fusion-groupbox.png

一个组框提供了一个框架、顶部的标题、一个键盘快捷键,并在其内部显示各种其他小部件。键盘快捷键将键盘焦点移动到组框的一个子部件上。

QGroupBox 还允许您设置 title(通常在构造函数中设置)和标题的 alignment。组框可以是 checkable。可选中组框中的子部件会根据组框是否被 checked 来启用或禁用。

您可以通过启用flat属性来最小化组框的空间消耗。在大多数styles中,启用此属性会导致移除框架的左侧、右侧和底部边缘。

QGroupBox 不会自动布局子部件(这些子部件通常是 QCheckBoxQRadioButton,但也可以是任何部件)。以下示例展示了如何设置带有布局的 QGroupBox

groupBox = QGroupBox(tr("Group Box with Layout"))
radio1 = QRadioButton(tr("Radio button 1"))
radio2 = QRadioButton(tr("Radio button 2"))
radio3 = QRadioButton(tr("Radio button 3"))
radio1.setChecked(True)
vbox = QVBoxLayout()
vbox.addWidget(radio1)
vbox.addWidget(radio2)
vbox.addWidget(radio3)
vbox.addStretch(1)
groupBox.setLayout(vbox)

另请参阅

QButtonGroup

注意

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

property alignmentᅟ: Combination of Qt.AlignmentFlag

此属性保存组框标题的对齐方式。

大多数样式将标题放置在框架的顶部。可以使用以下列表中的单个值来指定标题的水平对齐方式:

  • Qt::AlignLeft 将标题文本与组框的左侧对齐。

  • Qt::AlignRight 将标题文本与组框的右侧对齐。

  • Qt::AlignHCenter 将标题文本与组框的水平中心对齐。

默认对齐方式是 Qt::AlignLeft。

另请参阅

Alignment

Access functions:
property checkableᅟ: bool

此属性表示组框的标题中是否有一个复选框。

如果此属性为true,则组框将使用复选框代替普通标签显示其标题。如果复选框被选中,则组框的子项将被启用;否则,它们将被禁用且无法访问。

默认情况下,分组框是不可勾选的。

如果为分组框启用了此属性,它也将被初始选中以确保其内容被启用。

另请参阅

checked

Access functions:
property checkedᅟ: bool

此属性表示组框是否被选中。

如果组框是可勾选的,它将显示一个复选框。如果复选框被勾选,组框的子项将被启用;否则,子项将被禁用,用户无法访问。

默认情况下,可选的组框也是被选中的。

另请参阅

checkable

Access functions:
property flatᅟ: bool

此属性决定组框是绘制为平面还是带有框架。

一个组框通常由一个带有顶部标题的周围框架组成。如果启用了此属性,大多数样式中只绘制框架的顶部部分;否则,绘制整个框架。

默认情况下,此属性是禁用的,即除非明确指定,否则组框不是扁平的。

注意

在某些样式中,平面和非平面组框具有相似的表示形式,可能不像其他样式中那样容易区分。

另请参阅

title

Access functions:
property titleᅟ: str

警告

本节包含从C++自动翻译到Python的代码片段,可能包含错误。

此属性保存组框标题文本。

如果组框标题文本包含一个与号(’&’)后跟一个字母,则该标题文本将具有键盘快捷键。

g.setTitle("User information")

在上面的例子中,Alt+U 将键盘焦点移动到组框。详情请参阅 QShortcut 文档(要显示实际的 & 符号,请使用 ‘&&’)。

没有默认的标题文本。

另请参阅

alignment

Access functions:
__init__([parent=None])
Parameters:

父级QWidget

构造一个带有给定parent但没有标题的组框小部件。

__init__(title[, parent=None])
Parameters:
  • 标题 – str

  • parentQWidget

使用给定的titleparent构造一个组框。

alignment()
Return type:

AlignmentFlag 的组合

另请参阅

setAlignment()

属性 alignmentᅟ 的获取器。

clicked([checked=false])
Parameters:

checked – 布尔值

当复选框被激活时(即鼠标光标在按钮内按下然后释放),或者当按下快捷键时,会发出此信号。值得注意的是,如果你调用setChecked(),则不会发出此信号。

如果复选框被选中,checked 为真;如果复选框未被选中,则为假。

另请参阅

checkable toggled() checked

initStyleOption(option)
Parameters:

选项QStyleOptionGroupBox

使用此QGroupBox中的值初始化option。当子类需要QStyleOptionGroupBox但不想自己填写所有信息时,此方法非常有用。

另请参阅

initFrom()

isCheckable()
Return type:

布尔

属性 checkableᅟ 的获取器。

isChecked()
Return type:

布尔

属性 checkedᅟ 的获取器。

isFlat()
Return type:

布尔

属性 flatᅟ 的获取器。

setAlignment(alignment)
Parameters:

alignment – int

另请参阅

alignment()

setCheckable(checkable)
Parameters:

checkable – 布尔值

另请参阅

isCheckable()

属性 checkableᅟ 的设置器。

setChecked(checked)
Parameters:

checked – 布尔值

另请参阅

isChecked()

属性 checkedᅟ 的设置器。

setFlat(flat)
Parameters:

flat – 布尔值

另请参阅

isFlat()

属性 flatᅟ 的设置器。

setTitle(title)
Parameters:

标题 – str

另请参阅

title()

属性 titleᅟ 的设置器。

title()
Return type:

字符串

另请参阅

setTitle()

属性 titleᅟ 的获取器。

toggled(on)
Parameters:

on – 布尔值

如果组框是可勾选的,当复选框被切换时,会发出此信号。on 如果复选框被勾选,则为 true;否则为 false。

另请参阅

checkable

属性 checkedᅟ 的通知信号。