PySide6.QtWidgets.QGroupBox¶
- class QGroupBox¶
QGroupBox
小部件提供了一个带有标题的组框框架。更多…概要¶
属性¶
alignmentᅟ
- 组框标题的对齐方式checkableᅟ
- 组框的标题中是否有一个复选框checkedᅟ
- 组框是否被选中flatᅟ
- 组框是否以平面样式绘制或带有边框titleᅟ
- 组框标题文本
方法¶
def
__init__()
def
alignment()
def
isCheckable()
def
isChecked()
def
isFlat()
def
setAlignment()
def
setCheckable()
def
setFlat()
def
setTitle()
def
title()
虚拟方法¶
插槽¶
def
setChecked()
信号¶
注意
本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题,您也可以通过在我们的https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。
详细描述¶
警告
本节包含从C++自动翻译到Python的代码片段,可能包含错误。
一个组框提供了一个框架、顶部的标题、一个键盘快捷键,并在其内部显示各种其他小部件。键盘快捷键将键盘焦点移动到组框的一个子部件上。
QGroupBox
还允许您设置title
(通常在构造函数中设置)和标题的 alignment。组框可以是checkable
。可选中组框中的子部件会根据组框是否被checked
来启用或禁用。您可以通过启用
flat
属性来最小化组框的空间消耗。在大多数styles
中,启用此属性会导致移除框架的左侧、右侧和底部边缘。QGroupBox
不会自动布局子部件(这些子部件通常是QCheckBox
或QRadioButton
,但也可以是任何部件)。以下示例展示了如何设置带有布局的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)
另请参阅
注意
当使用
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¶
此属性决定组框是绘制为平面还是带有框架。
一个组框通常由一个带有顶部标题的周围框架组成。如果启用了此属性,大多数样式中只绘制框架的顶部部分;否则,绘制整个框架。
默认情况下,此属性是禁用的,即除非明确指定,否则组框不是扁平的。
- property titleᅟ: str¶
警告
本节包含从C++自动翻译到Python的代码片段,可能包含错误。
此属性保存组框标题文本。
如果组框标题文本包含一个与号(’&’)后跟一个字母,则该标题文本将具有键盘快捷键。
g.setTitle("User information")
在上面的例子中,Alt+U 将键盘焦点移动到组框。详情请参阅 QShortcut 文档(要显示实际的 & 符号,请使用 ‘&&’)。
没有默认的标题文本。
另请参阅
- Access functions:
构造一个带有给定
parent
但没有标题的组框小部件。- __init__(title[, parent=None])
- Parameters:
标题 – str
parent –
QWidget
使用给定的
title
和parent
构造一个组框。- alignment()¶
- Return type:
AlignmentFlag
的组合
另请参阅
属性
alignmentᅟ
的获取器。- clicked([checked=false])¶
- Parameters:
checked – 布尔值
当复选框被激活时(即鼠标光标在按钮内按下然后释放),或者当按下快捷键时,会发出此信号。值得注意的是,如果你调用
setChecked()
,则不会发出此信号。如果复选框被选中,
checked
为真;如果复选框未被选中,则为假。另请参阅
checkable
toggled()
checked
- initStyleOption(option)¶
- Parameters:
选项 –
QStyleOptionGroupBox
使用此
QGroupBox
中的值初始化option
。当子类需要QStyleOptionGroupBox
但不想自己填写所有信息时,此方法非常有用。另请参阅
- isCheckable()¶
- Return type:
布尔
属性
checkableᅟ
的获取器。- isChecked()¶
- Return type:
布尔
属性
checkedᅟ
的获取器。- isFlat()¶
- Return type:
布尔
属性
flatᅟ
的获取器。- setAlignment(alignment)¶
- Parameters:
alignment – int
另请参阅
- setCheckable(checkable)¶
- Parameters:
checkable – 布尔值
另请参阅
属性
checkableᅟ
的设置器。- setChecked(checked)¶
- Parameters:
checked – 布尔值
另请参阅
属性
checkedᅟ
的设置器。属性
flatᅟ
的设置器。属性
titleᅟ
的设置器。- title()¶
- Return type:
字符串
另请参阅
属性
titleᅟ
的获取器。- toggled(on)¶
- Parameters:
on – 布尔值
如果组框是可勾选的,当复选框被切换时,会发出此信号。
on
如果复选框被勾选,则为 true;否则为 false。另请参阅
checkable
属性
checkedᅟ
的通知信号。