【PySide6拓展】QGroupBox 容器组

PySide6拓展：QGroupBox

前言

在 GUI 开发中，组织界面控件并对其进行分组是提升用户体验和界面可读性的一种常见方式。QGroupBox 是 PySide6 中的一种控件，它允许开发者将一组相关的控件放在一个带有标题的区域内，从而清晰地标识控件的功能区域。QGroupBox 是一个容器控件，通常用于分组显示按钮、文本框、标签等控件，常见于设置面板和表单中。

本文将介绍 QGroupBox 的基本用法，包括如何创建和定制它的外观，以及常用的功能和方法。

什么是QGroupBox？

QGroupBox 是一个可包含其他控件的容器控件，它带有一个可定制的标题，可以作为一个“框架”来分组控件。QGroupBox 主要用于将控件逻辑上相关的部分进行视觉分组，常用于用户界面中，尤其是在需要明确区分不同功能区块时。

QGroupBox 的常见应用场景包括：

• 在表单中将控件按照不同功能分组。
• 在设置界面中对不同设置项进行分组，方便用户快速识别。
• 在复杂的界面中使用 QGroupBox 对控件进行组织，使界面更加简洁。

QGroupBox 提供了许多方法，允许你自定义它的标题、外观以及包含的控件。

如何使用QGroupBox？

1. 创建QGroupBox

QGroupBox 的创建和其他控件类似，你可以通过传入标题文本来创建一个基本的 QGroupBox，然后将其他控件添加到 QGroupBox 中。

示例代码：

from PySide6.QtWidgets import QApplication, QWidget, QVBoxLayout, QGroupBox, QCheckBox, QRadioButton

app = QApplication([])

window = QWidget()
layout = QVBoxLayout()

# 创建QGroupBox控件
group_box = QGroupBox("Settings")
group_box.setCheckable(True)  # 设置QGroupBox为可勾选
group_box.setChecked(True)    # 设置默认勾选状态

# 在QGroupBox内添加控件
check_box = QCheckBox("Enable Feature")
radio_button = QRadioButton("Option 1")

group_box_layout = QVBoxLayout()
group_box_layout.addWidget(check_box)
group_box_layout.addWidget(radio_button)

group_box.setLayout(group_box_layout)

# 将QGroupBox添加到窗口布局中
layout.addWidget(group_box)

window.setLayout(layout)
window.show()
app.exec()

在这个示例中，我们创建了一个 QGroupBox，并为其添加了一个复选框和一个单选按钮。我们还设置了 QGroupBox 为可勾选状态，使其具有折叠/展开的效果。

2. 设置标题和样式

你可以通过 setTitle() 方法来设置 QGroupBox 的标题。标题默认居中显示，也可以通过设置样式来调整标题的位置或字体。

示例代码：

group_box.setTitle("User Settings")  # 设置QGroupBox的标题

如果你想自定义 QGroupBox 的标题样式，可以使用 setStyleSheet() 方法来修改标题的样式，例如字体、颜色等：

group_box.setStyleSheet("QGroupBox { font: bold; font-size: 16px; }")

3. 设置是否可勾选

QGroupBox 可以设置为可勾选或不可勾选，通过 setCheckable() 方法来实现。当勾选框被选中时，QGroupBox 内的控件状态通常也会发生变化。

• setCheckable()：设置 QGroupBox 是否可勾选。
• setChecked()：设置 QGroupBox 的默认勾选状态。
• isChecked()：获取 QGroupBox 当前的勾选状态。

示例代码：

group_box.setCheckable(True)  # 设置QGroupBox为可勾选
group_box.setChecked(True)    # 设置默认勾选状态

你可以通过 isChecked() 方法检查 QGroupBox 是否被勾选。

if group_box.isChecked():
    print("GroupBox is checked")
else:
    print("GroupBox is unchecked")

4. 控制 QGroupBox 的折叠行为

通过设置 QGroupBox 为可勾选，你可以模拟折叠/展开的效果。QGroupBox 内的控件可以在勾选或取消勾选时隐藏或显示，这为创建动态表单或设置界面提供了便利。

示例代码：

group_box.setChecked(False)  # 设置为未勾选状态，使控件折叠

5. 设置QGroupBox的布局

QGroupBox 的内部布局可以通过 setLayout() 方法进行设置。你可以选择合适的布局方式来添加控件，例如垂直布局 (QVBoxLayout)、水平布局 (QHBoxLayout) 等。

示例代码：

group_box_layout = QVBoxLayout()  # 创建垂直布局
group_box_layout.addWidget(check_box)
group_box_layout.addWidget(radio_button)

group_box.setLayout(group_box_layout)  # 设置布局

QGroupBox 常用函数分类介绍

1. 标题设置

• setTitle(title)
  设置 QGroupBox 的标题。

  • 参数： title：字符串，表示要设置的标题。
  • 返回值： 无。

• title()
  获取当前 QGroupBox 的标题。

  • 参数： 无。
  • 返回值： 字符串，当前的标题文本。

2. 可勾选状态

• setCheckable(checkable)
  设置 QGroupBox 是否可以勾选。

  • 参数： checkable：布尔值，True 表示可以勾选，False 表示不可勾选。
  • 返回值： 无。

• setChecked(checked)
  设置 QGroupBox 的勾选状态。

  • 参数： checked：布尔值，True 表示勾选，False 表示未勾选。
  • 返回值： 无。

• isChecked()
  获取 QGroupBox 是否已勾选。

  • 参数： 无。
  • 返回值： 布尔值，True 表示已勾选，False 表示未勾选。

3. 布局管理

• setLayout(layout)
  设置 QGroupBox 内部的布局。

  • 参数： layout：QLayout 对象，表示要设置的布局。
  • 返回值： 无。

• layout()
  获取 QGroupBox 内部的布局。

  • 参数： 无。
  • 返回值： QLayout 对象，表示当前的布局。

4. 外观设置

• setStyleSheet(style)
  设置 QGroupBox 的样式表，包括背景、字体、边框等样式。
  • 参数： style：字符串，样式表内容。
  • 返回值： 无。

总结

QGroupBox 是一个强大的控件，用于将相关控件进行分组，并为其提供视觉上的分隔和标签。它不仅允许你设置标题、外观、勾选状态等属性，还可以通过布局管理器控制内部控件的排布。通过合理使用 QGroupBox，你可以使用户界面更加清晰和易于使用，尤其是在需要分组和组织多个控件时。掌握 QGroupBox 的使用方法，将为开发复杂的界面提供极大的帮助。