桌面应用 / 系统课时

用选择控件收集用户选项

用选择控件收集用户选项

本节解决桌面界面中如何让用户通过选项完成配置选择的问题。你将学习 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 后
English

currentIndex 表示当前选项的位置,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 提供动态模型,而不是在界面中硬编码所有选项。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用选择控件收集用户选项

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通