桌面应用 / 系统课时
用按钮和开关触发操作
用按钮和开关触发操作
桌面界面中的“点击一下执行命令”和“切换一个持续状态”不是同一种交互。Button、ToolButton、CheckBox 与 Switch 都建立在可点击控件能力之上,但适用语义不同。本节用一个可运行页面同时处理命令、勾选、开关以及禁用状态。
学习目标
- 根据交互语义选择
Button、ToolButton、CheckBox或Switch。 - 使用
onClicked、checked和onToggled连接用户操作与界面状态。 - 通过
enabled阻止当前不可执行的操作,并保留清晰的禁用反馈。
先按交互语义选控件
Button 适合“保存”“提交”“删除”这类执行一次动作的命令;ToolButton 通常放在工具栏或紧凑操作区,承担返回、刷新、清空等轻量命令。两者处理点击时通常响应 onClicked。
CheckBox 表示一个可以独立选择的选项,例如“记住窗口位置”或“同时导出日志”。Switch 同样具有 checked 状态,但更适合表达立即生效的开关,例如“启用通知”“开启深色模式”。对于这两类状态控件,业务逻辑通常读取 checked,需要响应用户实际切换时再处理 onToggled。
| 控件 | 典型语义 | 常用状态或信号 |
|---|---|---|
Button |
执行主要命令 | onClicked、enabled |
ToolButton |
执行紧凑型工具命令 | onClicked、enabled |
CheckBox |
选择独立选项 | checked、onToggled |
Switch |
打开或关闭立即生效的功能 | checked、onToggled |
在一个页面中处理四种控件
下面的完整示例中,保存按钮只有输入名称后才能点击;清空按钮使用更紧凑的 ToolButton;CheckBox 保存一个独立偏好;Switch 直接控制窗口的明暗外观。控件的默认样式会根据 enabled 自动表现禁用状态,不需要自己拦截每一次点击。
import QtQuick
import QtQuick.Controls
ApplicationWindow {
id: window
width: 520
height: 360
visible: true
title: "Controls Demo"
color: darkMode.checked ? "#202124" : "#f5f5f5"
Column {
anchors.centerIn: parent
spacing: 14
TextField {
id: nameField
width: 280
placeholderText: "输入名称"
}
Row {
spacing: 8
Button {
text: "保存"
enabled: nameField.text.length > 0
onClicked: statusLabel.text = "已保存:" + nameField.text
}
ToolButton {
text: "清空"
enabled: nameField.text.length > 0
onClicked: {
nameField.clear()
statusLabel.text = "内容已清空"
}
}
}
CheckBox {
id: rememberOption
text: "记住本次设置"
onToggled: statusLabel.text = checked
? "已选择记住设置"
: "已取消记住设置"
}
Switch {
id: darkMode
text: "深色模式"
onToggled: statusLabel.text = checked
? "深色模式已开启"
: "深色模式已关闭"
}
Label {
id: statusLabel
text: "请输入名称"
color: darkMode.checked ? "white" : "black"
}
}
}预期结果
程序启动时,“保存”和“清空”处于禁用状态。输入名称后两个按钮恢复可用;点击“保存”会显示已保存的名称,点击“清空”会清除输入。勾选复选框会更新提示文字,切换“深色模式”会改变窗口背景和提示文字颜色。不要重复维护 checked 状态
CheckBox 和 Switch 已经由控件自身管理交互产生的 checked 变化,因此通常不需要在 onClicked 中再手动执行 checked = !checked。重复翻转会让最终状态与用户看到的操作相反,也会使后续的数据绑定更难维护。
如果状态需要来自业务模型,更合适的做法是把 checked 绑定到模型属性,并在用户切换后更新模型。对于一次性命令,则继续使用 onClicked,不要为了复用写法把普通按钮强行设计成可勾选按钮。
用 enabled 表达当前能不能操作
当业务条件不满足时,把控件的 enabled 绑定到条件表达式,比在 onClicked 中先判断再直接返回更合适。禁用控件不仅不会触发正常操作,Qt Quick Controls 的样式还会向用户提供视觉反馈,并避免键盘操作误触发该命令。
示例中的 enabled: nameField.text.length > 0 会随着输入实时更新,因此无需额外监听文本变化。类似地,只有存在选中项目时才允许“删除”、只有表单通过校验时才允许“提交”,都可以采用同样的绑定方式。
选择控件时先判断它是在表达“执行一次命令”还是“保存一个持续状态”。命令交给 Button 或 ToolButton,独立选项交给 CheckBox,即时开关交给 Switch,再通过 enabled 和状态绑定把业务条件直接反映到界面上。