桌面应用 / 系统课时
用选择控件收集用户选项
用选择控件收集用户选项
本节解决桌面界面中如何让用户通过选项完成配置选择的问题。你将学习 RadioButton、ComboBox 和 SpinBox 的使用方式,并了解它们分别适合单选、列表选择和数值调整场景。
学习目标
- 掌握常用选择控件的基本属性和交互方式。
- 学会读取用户选择结果并绑定到应用逻辑。
- 能够根据业务场景选择合适的 Controls 组件。
区分不同选择控件
不同选择控件解决的问题不同。RadioButton 适合少量互斥选项,ComboBox 适合较多候选值,SpinBox 适合有范围限制的数字输入。
例如主题切换可以使用 RadioButton,语言选择可以使用 ComboBox,数量或端口编号可以使用 SpinBox。
使用 RadioButton 完成互斥选择
RadioButton 通常配合 ButtonGroup 使用,保证多个按钮中只有一个处于选中状态。
qml
import QtQuick
import QtQuick.Controls
ApplicationWindow {
width: 320
height: 200
visible: true
ButtonGroup {
id: themeGroup
}
Column {
anchors.centerIn: parent
RadioButton {
text: "浅色主题"
checked: true
ButtonGroup.group: themeGroup
}
RadioButton {
text: "深色主题"
ButtonGroup.group: themeGroup
}
Button {
text: "确认"
onClicked: console.log(themeGroup.checkedButton.text)
}
}
}预期输出
text
默认选择浅色主题并点击确认
浅色主题RadioButton 的核心是选择状态,而不是直接保存业务值。实际项目中通常读取 checked 或通过关联对象转换为配置数据。
使用 ComboBox 提供列表选择
ComboBox 将多个候选值收纳到下拉列表中,适合空间有限但选项较多的场景。
qml
ComboBox {
id: languageBox
model: ["中文", "English", "日本語"]
onCurrentTextChanged: console.log(currentText)
}预期输出
text
选择 English 后
EnglishcurrentIndex 表示当前选项的位置,currentText 表示当前显示文本。需要提交给后端时,通常建议根据索引映射稳定的数据值,而不是直接依赖显示文本。
使用 SpinBox 限制数字输入
SpinBox 用于整数范围选择,可以避免用户输入非法数字。
qml
SpinBox {
id: countBox
from: 1
to: 10
value: 3
onValueChanged: console.log(value)
}预期输出
text
修改数值为 5 后
5设置 from 和 to 可以限制允许范围。对于数量、等级、重试次数等离散整数配置,SpinBox 比普通文本输入更可靠。
选择控件的使用边界
选择控件的关键不是组件名称,而是数据特点。选项数量少且需要快速比较时使用 RadioButton;候选项较多时使用 ComboBox;连续数字调整时使用 SpinBox。
如果选项会动态变化,应优先考虑模型驱动方式,例如为 ComboBox 提供动态模型,而不是在界面中硬编码所有选项。
按自己的节奏,确认真正理解。