Qt QGroupBox 组件总结

Qt QGroupBox 组件总结

1. 概述

• 作用：QGroupBox 是一个容器部件，用于将界面中相关的控件分组，提供逻辑上的视觉分离，通常带有标题（title）和边框。
• 继承关系：继承自 QWidget，具备所有 QWidget 的功能，同时支持分组布局和可选的复选框功能。

2. 核心特性

• 标题（Title）：通过 setTitle() 设置分组框的标题，支持富文本（如 HTML 格式）。
• 复选框（Checkable）：可设置为带有复选框的分组框（setCheckable(true)），用于启用/禁用组内控件。
• 布局管理：内部可添加布局（如 QVBoxLayout），自动管理子控件的排列。
• 边框样式：支持扁平化或带边框样式（通过样式表自定义）。

3. 常用成员函数

4. 信号与槽

• 信号：
  • void toggled(bool checked)：当复选框状态变化时触发。
• 槽：
  • 通常与 connect 结合，动态响应分组框的启用/禁用状态。

5. 样式设置

• 使用 Qt 样式表：自定义边框、标题颜色、背景等。

  groupBox->setStyleSheet(
      "QGroupBox { border: 2px solid gray; border-radius: 5px; margin-top: 1ex; }"
      "QGroupBox::title { subcontrol-origin: margin; padding: 0 3px; }"
  );
  

• 扁平化效果：setFlat(true) 移除默认的立体边框。

6. 示例代码

// 创建分组框并设置属性
QGroupBox *groupBox = new QGroupBox("用户信息");
groupBox->setCheckable(true); // 启用复选框
groupBox->setChecked(true);   // 默认选中

// 添加布局和控件
QVBoxLayout *layout = new QVBoxLayout;
layout->addWidget(new QLineEdit("姓名"));
layout->addWidget(new QLineEdit("邮箱"));
groupBox->setLayout(layout);

// 连接信号：当复选框状态变化时隐藏/显示子控件
connect(groupBox, &QGroupBox::toggled, [groupBox](bool checked) {
    groupBox->setVisible(checked); // 示例：动态控制可见性
});

7. 注意事项

• 布局管理：必须为 QGroupBox 设置布局（如 QVBoxLayout），否则子控件无法正确显示。
• 内存管理：父对象析构时自动释放子控件，无需手动删除。
• 复选框状态同步：若组内控件需要跟随复选框禁用，需手动处理（如遍历子控件设置 setEnabled(checked)）。

8. 与其他组件对比

• QFrame：仅提供边框绘制，无标题或复选框功能。
• QTabWidget：用于多页切换，而 QGroupBox 在同一页面内分组控件。

通过合理使用 QGroupBox，可以显著提升 Qt 界面的组织性和用户体验，特别是在复杂表单或配置界面中。