深圳电子商城网站建设网站搭建需要什么技术
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 界面的组织性和用户体验，特别是在复杂表单或配置界面中。