桌面应用 / 系统课时

处理信号与事件处理器

处理信号与事件处理器

本篇解决 QML 组件如何响应用户操作和对象状态变化的问题。通过信号处理器可以监听按钮点击、属性变化等事件,同时使用自定义 signal 建立组件之间清晰的通信方式。

学习目标

  • 理解 QML 信号与事件处理器的对应关系。
  • 掌握常用内置信号处理器的写法。
  • 学会通过自定义 signal 向外部组件传递事件。

理解 QML 信号驱动模型

QML 对象中的事件通常通过 signal 表达。当某个动作发生时,对象发出信号,连接到该信号的处理器会执行对应逻辑。

例如按钮被点击时,会触发 clicked 信号,组件内部可以通过 onClicked 处理这个事件。

qml
import QtQuick
import QtQuick.Controls

ApplicationWindow {
    visible: true
    width: 400
    height: 300

    Button {
        text: "保存"

        onClicked: {
            console.log("用户点击保存")
        }
    }
}

预期输出

text
qml: 用户点击保存

事件处理器名称通常由信号名称转换而来,例如 clicked 对应 onClicked,textChanged 对应 onTextChanged。

使用属性变化信号

QML 属性通常会自动提供变化通知信号。当属性值变化时,可以通过对应处理器执行额外逻辑。

qml
TextField {
    id: input

    onTextChanged: {
        console.log("当前输入:", text)
    }
}

预期输出

text
qml: 当前输入: hello

这类处理器适合响应状态变化,例如校验输入、刷新其他控件状态,但不应该把大量业务逻辑直接堆积在界面文件中。

创建自定义 signal

组件需要向外部通知内部状态变化时,可以定义自己的 signal。这样组件内部实现和外部使用方可以保持解耦。

qml
import QtQuick

Item {
    id: panel

    signal submitted(string value)

    function submit() {
        submitted("完成")
    }
}

外部组件可以监听该信号:

qml
Panel {
    onSubmitted: function(value) {
        console.log("收到事件:", value)
    }
}

预期输出

text
qml: 收到事件: 完成

自定义 signal 不负责保存状态,它只负责通知“某件事情发生了”。需要共享数据时,应结合属性绑定或属性暴露实现。

选择事件处理方式

不同变化场景适合不同机制:

场景 推荐方式
用户点击按钮 使用内置信号处理器
属性变化后更新界面 使用属性绑定
子组件通知父组件 使用自定义 signal
复杂业务流程 调用 JavaScript 函数或连接外部逻辑

事件处理器应该保持简单,负责触发动作或更新少量状态。如果一个处理器包含大量业务代码,可以将逻辑移动到独立 JavaScript 文件或 C++ 后端。

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

目录与阅读设置

阅读设置

17

记录一个想法

处理信号与事件处理器

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

登录哪都通