4. 基础控件（二）
在 Qt Widgets 的控件体系中，选择类控件与进度反馈类控件是构建交互式界面的高频组件。QComboBox（下拉列表框）、QSpinBox（数字调节框）、QSlider（滑块）和 QProgressBar（进度条）分别承担着“选项选择”“数值输入”“范围调节”和“状态反馈”四种核心职责。它们看似独立，但在实际项目中往往需要协同工作——例如一个视频播放器需要滑块控制进度、数字框显示当前时间、进度条反映缓冲状态。本章将深入剖析这四个控件的核心机制、信号槽行为、数据绑定方式，并通过一个“温度控制器”联动案例，展示如何将它们组合成完整的业务闭环。
4.1 核心原理：四个控件的本质与数据模型
这四个控件虽然外观差异明显，但底层都遵循 Qt 的 MVC（Model-View-Controller）设计思想。QComboBox 内部维护一个 QStandardItemModel 作为数据源，每个选项对应一个 item，用户选择时通过 currentIndexChanged 信号通知外部；QSpinBox 和 QSlider 本质上是同一个数值模型的两种不同呈现方式——它们都基于 QAbstractSpinBox 和 QAbstractSlider 的数值范围逻辑，只是交互形态不同；QProgressBar 则是一个只读的数值显示器，它不接收用户输入，只负责将 0~100 的整数映射为可视化的填充比例。
| 控件 | 数据模型 | 核心信号 | 典型用途 |
|---|---|---|---|
| QComboBox | QStandardItemModel（字符串列表） | currentIndexChanged(int)、currentTextChanged(QString) | 模式选择、枚举值输入 |
| QSpinBox | int（可设置范围、步长、前缀后缀） | valueChanged(int)、textChanged(QString) | 数值精确输入、参数设置 |
| QSlider | int（与 QSpinBox 共享数值语义） | valueChanged(int)、sliderMoved(int) | 连续调节、音量/亮度控制 |
| QProgressBar | int（只读，范围通常 0~100） | valueChanged(int)（仅用于监听） | 任务进度、加载状态 |
理解这些控件的本质差异至关重要：QComboBox 处理的是离散的枚举值，而 QSpinBox 和 QSlider 处理的是连续的数值区间。QProgressBar 则是一个“被动”控件，它不产生用户交互信号，只响应 setValue() 调用。这种分工决定了它们在联动中的角色——前三个是“输入源”，最后一个是“输出目标”。
4.2 操作流程：从创建到联动的标准步骤
在实际开发中，这四个控件的组合使用遵循一套可复用的流程。以“温度控制器”为例，我们需要一个下拉框选择温度单位（摄氏/华氏），一个数字框输入目标温度，一个滑块进行快速调节，一个进度条显示当前温度与目标温度的接近程度。
- 创建控件并设置基本属性：在 Qt Designer 中拖入控件，或通过代码 new 创建。QComboBox 使用 addItem() 添加选项；QSpinBox 调用 setRange(-50, 150) 设置合理范围；QSlider 设置 Qt::Horizontal 方向并同步范围；QProgressBar 设置 setRange(0, 100)。
- 建立信号槽连接：核心是让 QSpinBox 和 QSlider 的值保持同步。当用户拖动滑块时，滑块发出 valueChanged(int)，我们将其连接到数字框的 setValue()；反之，当用户直接输入数字时，数字框的 valueChanged 连接到滑块的 setValue()。但要注意，这种双向连接会引发信号循环——A 改变触发 B，B 改变又触发 A。
- 处理联动逻辑：使用 QSignalBlocker 或标志位（如 bool m_updating）来防止循环。在槽函数中先阻断信号，更新对方控件后再恢复。
- 映射到进度条：进度条的值不直接等于温度值，而是根据当前温度与目标温度的差值计算百分比。例如目标 50°C，当前 30°C，则进度为 |50-30|/50 * 100 = 40%。
// 关键代码片段：双向同步与进度映射
connect(ui->spinBox, QOverload<int>::of(&QSpinBox::valueChanged), this, [=](int val) {
QSignalBlocker blocker(ui->slider); // 阻断滑块信号
ui->slider->setValue(val);
updateProgress(val);
});
connect(ui->slider, &QSlider::valueChanged, this, [=](int val) {
QSignalBlocker blocker(ui->spinBox); // 阻断数字框信号
ui->spinBox->setValue(val);
updateProgress(val);
});
void updateProgress(int currentTemp) {
int target = ui->spinBox->value();
int diff = qAbs(currentTemp - target);
int maxDiff = ui->spinBox->maximum() - ui->spinBox->minimum();
ui->progressBar->setValue(100 - (diff * 100 / maxDiff));
}4.3 案例拆解：温度控制器联动实现
我们构建一个完整的温度控制面板，包含单位选择（QComboBox）、温度设定（QSpinBox + QSlider 联动）、实时进度（QProgressBar）。初始界面中，下拉框提供“摄氏温度”和“华氏温度”两个选项，数字框范围设为 -50~150（摄氏），滑块同步。当用户切换单位时，需要将当前数值进行换算并更新范围。
| 交互行为 | 触发信号 | 响应逻辑 | 涉及控件 |
|---|---|---|---|
| 选择“华氏” | currentIndexChanged | 将摄氏值转换为华氏（F = C*9/5+32），更新范围 -58~302 | QComboBox → QSpinBox |
| 拖动滑块 | sliderMoved | 实时更新数字框显示，并刷新进度条 | QSlider → QSpinBox + QProgressBar |
| 直接输入数字 | valueChanged | 滑块位置跟随，进度条同步 | QSpinBox → QSlider + QProgressBar |
| 点击“开始加热” | 按钮 clicked | 启动 QTimer 模拟温度上升，进度条动态变化 | QTimer → QProgressBar |
这个案例揭示了几个关键设计点：单位切换时不能简单修改显示文本，必须同步调整数值范围和当前值，否则会出现“50°C”变成“50°F”的逻辑错误；进度条的映射不是线性的，需要根据实际业务定义“完成”的含义——这里我们定义为“温度越接近目标，进度越高”。此外，当用户切换单位时，滑块和数字框的数值需要重新计算，此时必须使用 QSignalBlocker 防止在初始化过程中触发不必要的信号。
实战经验：在真实项目中，QComboBox 的 currentIndexChanged 信号会携带 int 类型的索引，而 currentTextChanged 携带 QString。如果选项文本可能重复（例如两个“自动”选项），应优先使用索引而非文本进行逻辑判断。同时，QSpinBox 的 setSuffix() 方法可以添加单位后缀（如“°C”），但注意后缀不会影响数值本身，只是显示效果。
4.4 常见误区与总结复盘
在开发中，开发者常犯以下错误：第一，忽略信号循环。双向绑定 QSpinBox 和 QSlider 时，如果不加保护，程序会陷入死循环甚至栈溢出。解决方案是使用 QSignalBlocker 或自定义标志位。第二，QComboBox 的 currentIndex 与数据分离。当选项列表动态变化时，索引可能失效，应通过 findData() 查找关联数据而非依赖固定索引。第三，QProgressBar 的 range 设置不当。如果进度条范围是 0~100，而实际任务需要 0~500，直接 setValue(300) 会导致进度条瞬间满格，应动态调整范围或使用 setMaximum()。
风险提示：QSlider 的 valueChanged 信号在用户拖动过程中会连续触发，如果槽函数中执行了耗时操作（如数据库写入），会导致界面卡顿。建议在 sliderReleased 信号中处理最终值，或使用 setSingleStep() 控制步长来减少触发频率。
总结本章要点：四个控件分别对应“选择、输入、调节、反馈”四种交互模式，它们的联动本质是数据流的单向或双向传递。QComboBox 提供离散选项，QSpinBox 和 QSlider 共享数值语义但呈现方式不同，QProgressBar 作为纯输出控件。在实际项目中，应优先明确数据流方向，再设计信号槽连接，最后考虑边界条件和异常处理。通过本章的温度控制器案例，读者应掌握 QSignalBlocker 的使用、单位换算时的数据一致性维护，以及进度映射的灵活设计。