当前位置：首页 > news >正文

Qt QGroupBox 组件总结

news 2025/11/4 9:36:02

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); // 示例：动态控制可见性
});