QML 信号与信号处理器程序

QML 信号与信号处理器程序

在 Qt 编程中，信号与槽机制是一个核心特性，广泛用于事件响应和对象间的通信。QML 作为 Qt 的声明式语言，同样继承并扩展了这一特性，只是在语法和实现上有所不同。在 QML 中，信号和信号处理器也有着非常重要的作用，能够帮助我们高效地处理用户交互、对象状态变化等事件。

信号与信号处理器概述

在 QML 中，信号是表示某个事件的通知，而信号处理器（即槽函数）则是接收到信号后执行的代码块。信号和信号处理器的工作机制与 Qt C++ 中的信号与槽类似，主要体现在以下两个方面：

• 信号：由 QML 对象发出，表示某个事件的发生（如用户点击、属性变化等）。
• 信号处理器：一个或多个函数或表达式，用于响应特定的信号。

1. 使用信号处理程序接收信号

在 QML 中，信号的接收方式很简单。当对象发出信号时，我们通过在对象中声明对应的信号处理程序来接收和处理这些信号。信号处理程序的名称通常以 on<Signal> 形式命名，其中 <Signal> 是信号的名称，首字母大写。

示例：使用 onClicked 处理 MouseArea 的点击事件

import QtQuick 2.3

Rectangle {
    id: rect
    width: 100; height: 100

    MouseArea {
        anchors.fill: parent
        onClicked: {  // 信号处理程序
            rect.color = Qt.rgba(Math.random(), Math.random(), Math.random(), 1);
        }
    }
}

在上述示例中，当 MouseArea 被点击时，onClicked 信号处理程序会被触发，随机改变矩形的颜色。

访问信号参数

onClicked 信号处理程序可以接收到一个 MouseEvent 对象，这个对象包含了有关鼠标事件的信息（如鼠标的坐标）。

import QtQuick 2.3

Rectangle {
    id: rect
    width: 100; height: 100

    MouseArea {
        anchors.fill: parent
        onClicked: {  // 信号处理程序
            rect.color = Qt.rgba(Math.random(), Math.random(), Math.random(), 1);
            console.log("Clicked at", mouse.x, mouse.y)  // 访问 mouse 参数
        }
    }
}

此时，mouse.x 和 mouse.y 返回鼠标点击的坐标。

2. 属性改变信号处理程序

当 QML 中的属性值发生改变时，会自动触发一个信号，通常是属性改变信号。你可以通过在对象中声明以 on<Property>Changed 命名的信号处理程序来响应这种变化。

示例：响应属性变化

import QtQuick 2.3

Rectangle {
    id: rect
    width: 100; height: 100

    MouseArea {
        anchors.fill: parent
        onPressedChanged: {  // 属性变化信号处理程序
            console.log("Mouse pressed state changed:", pressed);
        }
    }
}

onPressedChanged 会在 MouseArea 的 pressed 属性发生变化时被触发。

3. 使用 Connections 类型

Connections 类型允许在 QML 中跨对象连接信号。当信号的发射者和接收者不在同一对象时，可以使用 Connections 来连接它们。

示例：使用 Connections 类型接收信号

import QtQuick 2.3

Rectangle {
    id: rect
    width: 100; height: 100

    MouseArea {
        id: mouseArea
        anchors.fill: parent
    }

    Connections {
        target: mouseArea  // 连接到 MouseArea 对象
        onClicked: {
            rect.color = Qt.rgba(Math.random(), Math.random(), Math.random(), 1);
        }
    }
}

在此示例中，MouseArea 的 clicked 信号被连接到 rect 对象的颜色更改操作。

4. 附加信号处理程序

有时候我们希望从外部对象接收信号，而不是从当前对象或其子对象接收。在 QML 中，可以使用附加类型来实现这个功能。附加信号处理程序属于附加类型，允许你监听并处理本身并未声明的信号。

示例：使用附加信号处理程序

import QtQuick 2.3

Item {
    width: 100; height: 100
    focus: true
    Keys.enabled: true  // 启用键盘事件

    Keys.onReturnPressed: {
        console.log("Return key was pressed");
    }
}

在这个例子中，Keys 是一个附加类型，onReturnPressed 是其信号处理程序，用于响应回车键的按下事件。

5. 自定义信号

QML 允许你为自定义类型定义信号。当标准信号不足以满足需求时，可以通过 signal 关键字自定义信号。

示例：自定义信号

import QtQuick 2.3

Item {
    signal clicked
    signal hovered()
    signal actionPerformed(string action, var result)
}

你可以定义带有参数的信号，并在需要时发射它们：

MouseArea {
    anchors.fill: parent
    onPressed: root.clicked()  // 发射 clicked 信号
}

6. 信号到方法的连接

虽然信号处理程序是最常见的信号接收方式，但有时你需要将信号连接到多个方法。可以使用 connect() 方法将信号连接到方法或其他信号。

示例：信号连接到多个方法

import QtQuick 2.3

Rectangle {
    id: relay

    signal messageReceived(string message)

    Component.onCompleted: {
        relay.messageReceived.connect(sendToLiLei)  // 连接信号到方法
        relay.messageReceived.connect(sendToHanMeimei)
        relay.messageReceived("Hello, world!")
    }

    function sendToLiLei(message) {
        console.log("Sending to LiLei: " + message);
    }

    function sendToHanMeimei(message) {
        console.log("Sending to HanMeimei: " + message);
    }
}

每当 messageReceived 信号被触发时，sendToLiLei 和 sendToHanMeimei 两个方法都会被调用。

7. 信号到信号的连接

你也可以将信号连接到其他信号，从而形成信号链。

示例：信号到信号的连接

import QtQuick 2.3

Rectangle {
    id: forwarder
    width: 100; height: 100

    signal sendToLiLei()
    signal sendToHanMeimei()

    MouseArea {
        id: mousearea
        anchors.fill: parent
        onClicked: console.log("Clicked")
    }

    Component.onCompleted: {
        mousearea.clicked.connect(sendToLiLei)
        mousearea.clicked.connect(sendToHanMeimei)
    }

    onSendToLiLei: console.log("Send to LiLei")
    onSendToHanMeimei: console.log("Send to HanMeimei")
}

在这个例子中，mousearea.clicked 信号会触发 sendToLiLei 和 sendToHanMeimei 两个信号。

总结

QML 中的信号与信号处理机制，使得对象间的通信变得非常灵活和高效。通过使用 on<Signal> 语法，你可以方便地接收并响应各种信号。此外，QML 还支持通过 Connections 类型跨对象连接信号、定义自定义信号以及使用 connect() 方法将信号连接到多个方法或信号。这些功能使得 QML 在构建交互式应用程序时变得更加高效和易于管理。