桌面应用 / 系统课时

用按钮和开关触发操作

用按钮和开关触发操作

桌面界面中的“点击一下执行命令”和“切换一个持续状态”不是同一种交互。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 自动表现禁用状态,不需要自己拦截每一次点击。

qml
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"
        }
    }
}

预期结果

text
程序启动时,“保存”和“清空”处于禁用状态。输入名称后两个按钮恢复可用;点击“保存”会显示已保存的名称,点击“清空”会清除输入。勾选复选框会更新提示文字,切换“深色模式”会改变窗口背景和提示文字颜色。

不要重复维护 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 和状态绑定把业务条件直接反映到界面上。

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

目录与阅读设置

阅读设置

17

记录一个想法

用按钮和开关触发操作

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

登录哪都通