QML 信号和信号处理器程序

原创

waleon 2022-07-29 11:11:48 博主文章分类：细说 QML ©著作权

文章标签 Qt QML QML信号 QML信号处理程序 QML槽 文章分类 后端开发

©著作权归作者所有：来自51CTO博客作者waleon的原创作品，请联系作者获取转载授权，否则将追究法律责任

简述

信号和槽作为 Qt 的核心机制，在 Qt 编程中有着广泛的应用。同样，QML 也继承了这样的特性 - 信号和信号处理程序，只不过叫法上略有不同。

信号：来自 QML 对象的通知。
信号处理程序：由信号触发的表达式（或函数），也被称为 Qt C++ 中的“槽”。

信号是事件，信号通过信号处理程序来响应。当一个信号被发射时，相应的信号处理程序就会被调用，在处理程序中放置逻辑（例如：脚本或其他操作）以允许组件响应事件。

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

信号是来自对象的通知，表示发生了某些事件（例如：鼠标已点击、属性已更改、动画已启动/停止）。每当特定信号被发射时，若要接收通知：

对象定义应声明一个名on<Signal> 的信号处理程序，其中<Signal> 是信号的名称，首字母大写。
信号处理程序必须在发出信号的对象定义中声明，并且处理程序应包含调用时要执行的 JavaScript 代码块。

例如，MouseArea 类型有一个 clicked 信号，无论何时在该区域内单击鼠标都会发出该信号。由于信号名称是 clicked，所以接收该信号的信号处理程序应命名为 onClicked。

下面的示例中，每当鼠标区域被点击时，onClicked 处理程序就会被调用，为 Rectangle 分配一个随机颜色：

import QtQuick 2.3

Rectangle {
    id:100; height:100

    MouseArea {
        anchors.fill: parent
        onClicked: {  // 鼠标单击
            rect.color = Qt.rgba(Math.random(), Math.random(), Math.random(), 1);
        }

查看 MouseArea 文档，可以看到 clicked 信号发出时带有一个名为 mouse 的参数，这是一个 MouseEvent 对象，包含了有关鼠标单击事件的很多详细信息，可以在 onClicked 处理程序中引用该名称来访问此参数。

例如，MouseEvent 类型有 x 和 y 坐标，这使我们可以打印出鼠标点击的确切位置：

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);

            // 访问 mouse 参数
            console.log("Clicked mouse at", mouse.x, mouse.y)
        }
    }
}

属性改变信号处理程序

当 QML 属性值发生改变时，将自动发出信号。这种类型的信号是属性改变信号，对应的处理程序为属性改变信号处理程序。

属性改变信号处理程序以on<Property>Changed 的形式写入，<Property> 是属性的名称，首字母大写。

例如，MouseArea 类型具有 pressed 属性，要在该属性改变时接收通知，需要编写名为 onPressedChanged 的信号处理程序：

import QtQuick 2.3

Rectangle {
    id:100; height:100

    MouseArea {
        anchors.fill: parent
        onPressedChanged: {  // 鼠标按下/释放
            console.log("Mouse area is pressed?", pressed)}
    }
}

尽管 MouseArea 文档中没有记录名为 onPressedChanged 的信号处理程序，但是因为存在 pressed 属性，所以它也被隐式地提供了。

使用 Connections 类型

QtQuick 模块提供了 Connections 类型，用于连接到任意对象的信号。Connections 的优点是：

可以在发射信号的对象外部访问该信号

例如，上述示例中的 onClicked 处理程序可以由根 Rectangle 接收，只需要将其放置在一个 Connections 对象中，并指定 target 为 mouseArea：

import QtQuick 2.3

Rectangle {
    id:100; height:100}

    Connections {
        target:rgba(Math.random(), Math.random(), Math.random(), 1);
        }

附加信号处理程序

附加信号处理程序所接收的信号来自附加类型，而非声明处理程序的对象。

附加，也称为额外。可以简单理解为：对象本身或其基类没有的属性和信号，需要通过外部（附加类型）提供。

要引用附加属性和处理程序，可以使用以下语法形式：

<AttachingType>.<propertyName>
<AttachingType>.on<SignalName>

例如，下面的 Item 可以通过附加类型 Keys 来访问其附加属性和附加信号处理程序：

import QtQuick 2.3

Item {
    width:100; height:100

    focus: true
    Keys.enabled: true
    Keys.onReturnPressed: console.log("Return key was pressed")}

enabled 是 Keys 的一个属性，为其赋值为 true（默认值是 true，这里主要用于说明如何使用附加类型的属性），表明启用键盘处理。

由于 Keys 提供了 returnPressed 信号，所以可以通过 onReturnPressed 来引用相应的附加信号处理程序。

类似的附加类型还有很多，例如：Component，它有一个 onCompleted 附加信号处理程序，通常用于在创建完成后执行某些 JavaScript 代码：

import QtQuick 2.3

Rectangle {
    width:200; height:200
    color: Qt.rgba(Qt.random(), Qt.random(), Qt.random(), 1)

    Component.onCompleted: {
        console.log("The rectangle's color is", color)}
}

onCompleted 处理程序没有响应来自 Rectangle 类型的 completed 信号。相反，Component 对象由 QML 引擎自动附加到 Rectangle 对象，当对象完全创建时，引擎发出 completed 信号，从而触发 Component.onCompleted 信号处理程序。

附加信号处理程序允许向对象通知有意义的特定信号。如果没有为某个特定对象注册信号，那么就不能接收相应的通知，附加信号处理机制使得对象能够接收特定的信号而无需这些额外的处理。

自定义信号

当自定义类型不可避免，当现有信号无法满足，这时，最好的方法就是自定义信号。

可以通过 signal 关键字来添加自定义信号，语法如下：

signal <name>[([<type> <parameter name>[, ...]])]

例如，下面声明了三个自定义信号：

import QtQuick 2.3

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

如果信号没有参数，括号“()” 是可选的；倘若有参数，那么必须声明参数的类型（正如上述 actionPerformed 信号中的 string 和 var 一样）。

要发射信号，可以将其作为方法来调用。任何相关的信号处理程序将在发出信号时被调用，处理程序可以使用定义的信号参数名称来访问相应的参数。

例如，假设下面的代码被定义在一个名为 SquareButton.qml 的文件中，根 Rectangle 对象有一个 activated 信号。当子 MouseArea 被点击时，它会以鼠标点击的坐标发出 parent 的 activated 信号：

// SquareButton.qml
Rectangle {
    id: root

    signal activated(real xPosition, real yPosition)

    property int side: 100
    width: side; height: side

    MouseArea {
        anchors.fill: parent
        onPressed: root.activated(mouse.x, mouse.y)
    }
}

然后，SquareButton 的任何对象都可以使用 onActivated 信号处理程序连接到 activated 信号：

// myapplication.qml
SquareButton {
    onActivated: console.log("Activated at " + xPosition + ","

信号到方法/信号的连接

大部分情况下，通过信号处理程序接收信号就足够了，然而，要将信号连接至多个方法/信号，这对于信号处理程序来说是不可能的（因为信号处理程序的命名必须唯一）。

在 Qt C++ 中，信号与槽的连接方式使用的是 QObject::connect()。相应地，在 QML 中，signal 对象也有一个 connect() 方法，用于将信号连接到一个方法或另一信号。当信号连接到方法时，无论信号何时发出，该方法都将被自动调用。有了这种机制，可以通过方法来接收信号，而无需使用信号处理器。

所以呢，相对于信号处理程序来说，connect() 更加灵活：

可以将信号连接至多个方法/信号

此外，当将信号连接到动态创建的对象时，connect() 方法也很有用。

信号到方法的连接

下面，使用 connect() 方法将 messageReceived 信号连接到两个方法：

import QtQuick 2.3

Rectangle {
    id: relay

    signal messageReceived(string message, string qq)

    Component.onCompleted: {
        relay.messageReceived.connect(sendToLiLei)  // 连接信号和方法
        relay.messageReceived.connect(sendToHanMeimei)  // 连接信号和方法
        relay.messageReceived("Welcome to join us（QML分享&交流）", "26188347")  // 发射信号
    }

    function sendToLiLei(message, qq) {
        console.log("Sending to LiLei: " + message + ", " + qq)
    }
    function sendToHanMeimei(message, qq) {
        console.log("Sending to HanMeimei: " + message + ", "

广播一下，李雷和韩梅梅就可以很快的找到组织了~O(∩_∩)O~！

有 connect() 方法，必然也会有相应的 disconnect() 方法，用于删除连接的信号：

Rectangle {
    id: relay
    //...

    function

用法很简单，和 connect() 相同。

信号到信号的连接

通过将信号连接到其他信号，connect() 方法可以形成不同的信号链。

import QtQuick 2.3

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

    signal sendToLiLei()  // 自定义信号
    signal sendToHanMeimei()  // 自定义信号
    onSendToLiLei: console.log("Send to LiLei")  // 信号处理程序
    onSendToHanMeimei: console.log("Send to HanMeimei")  // 信号处理程序

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

    Component.onCompleted: {
        // 连接信号至两个信号
        mousearea.clicked.connect(sendToLiLei)
        mousearea.clicked.connect(sendToHanMeimei)
    }
}