QtQGroupBox组件总结

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

---

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

---

3. 常用成员函数 方法描述void setTitle(const QString &title)设置分组框标题QString title() const获取当前标题void setCheckable(bool checkable)启用/禁用复选框bool isCheckable() const返回是否启用复选框void setChecked(bool checked)设置复选框选中状态bool isChecked() const获取复选框状态void setFlat(bool flat)设置扁平化边框（无立体效果）bool isFlat() const返回是否为扁平样式

---

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 界面的组织性和用户体验，特别是在复杂表单或配置界面中。