QML 信号与信号响应方法的总结

以下内容为本人的学习笔记的一部分

QML 中信号的定义分为 QtQuick 框架提供和自定义两种。
下面就介绍一下信号的定义和响应方式。

1. QtQuick 提供的信号：

这些信号都是已经预定义好了，我们需要的是声明响应（方法）即可。比如 MouseArea 的 clicked 信号，要响应它，仅需要在 QML 文件中添加以下形式的语句即可：

on<Signal>: {
 do something ....
}

这里注意一下，Signal 必须首字母大写。冒号后边如果仅是单语句，可以不用大括号{}。

2. 属性变化发射的信号：

假设声明了一属性 property，可添加以下形式语句响应属性的变化：

on<Property>Changed: {
 do something ....
}

这里注意一下，Property 必须首字母大写。语句的形式和上面类似。

3. 附加类型对象的信号：

举个栗子，QML 引擎会自动附加 Component 对象到 QML 文件里声明对象中，当对象加载完成时，会触发 Component 对象的 completed 信号，为了响应此信号，那么添加以下形式语句：

Component.onCompleted: {
 do something ....
}

4. 自定义信号：

用以下形式声明自定义的信号，

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

调用自定义信号，比如：

Rectangle {
    id: root

    signal mysignal(int x, int y)

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

上面的 mouse 来自于对象 MouseArea 的信号 pressed 定义声明。

自定义信号的处理形式和其它的预定义信号一致。

5. 处理任意对象的信号：

QtQuick 框架提供了一个类型：Connections 用于处理任意对象的信号。参考以下形式：

Connections {
 target: object_id
 onSignal: {
  do something ....
 }
}

以上用于响应 id 为 object_id 的对象发出的信号 signal。

6. QML 中的 connect 方法

和 C ++ 部分类似，QML 中也有 connect 方法，但是 QML 的 connect 更灵活。QML 的 connect 由信号提供，可以连接任意的（包括多个）信号和方法。参考以下形式：

signal.connect(signal / function name)

Rectangle {
    id: root

    signal mySignal()
    \\ 信号响应处理
    onMySignal: console.log("clicked connect mySignal")

    \\ 普通方法
    function slt_clicked() {
      console.log("Clicked");
    }

    Component.onCompleted: {
        mousearea.clicked.connect(slt_clicked);
        mousearea.clicked.connect(mySignal);
    }

    MouseArea {
        id: mousearea
        anchors.fill: parent
    }
}

注意一下，连接的信号 ( clicked ) 如果带有参数，那么被连接的方法 ( slt_clicked ) 也应该有同样数目的参数。

当然，如果连接不再需要，那么 disconnect 也是不能缺少的。

Rectangle {
    id: relay
    \\ ... 省略

    function removeSignal() {
        mousearea.clicked.disconnect(slt_clicked);
        mousearea.clicked.disconnect(mySignal);
    }
}