Qt C++属性类型提供给 QML调用（五）

前言

前面已经介绍了四种从 QML 调用 C++的属性的方法，今天介绍最后一种，从 QML 调用 C++中的函数以及连接 C++中的信号。

调用 C++函数

任何继承于 QObject 类的 C++类型都可以在 QML 中进行调用，调用C++方法有两个前提：

C++类继承于 QObject 类
将要调用的方法必须是 public 类型的

满足以上两个条件就可以对 C++方法进行调用，但是调用的函数只有两种：

通过Q_INVOKABLE宏声明
公有的槽函数

OK，写得已经很清楚了，下面来看看示例：
同样是在之前的 demo 中进行修改。

class Student : public QObject
{
    Q_OBJECT
public:
    explicit Student(QObject *parent = nullptr);
    ~Student(){}

    Q_INVOKABLE bool setHeight(int h){
        qDebug() << __FUNCTION__ << "call the C++ function with: " << h;
        return true;
    }
public slots:
    void onRefresh(){
        qDebug() << "call the c++ slot.";
    }
};

在 Main 函数中进行注册上下文属性：

Student student;
engine.rootContext()->setContextProperty("student", &student);

然后在 QML 中进行调用。

Button{
   width: 30
   height: 30
   text: "click me"
   onClicked: {
       var ret = student.setHeight(100)
       console.log("C++ result of setHeight:",ret)
       student.onRefresh()
   }
}

运行程序，点击按钮，程序输出如下：

setHeight call the C++ function with:  100
qml: C++ result of setHeight: true
call the c++ slot.

以上示例说明了从 QML 调用Q_INVOKABLE宏标记的公有函数以及公有槽函数。
QML支持重载C ++函数的调用。如果有多个具有相同名称但参数不同的C ++函数，则将根据提供的参数的数量和类型调用正确的函数。

当从QML中的JavaScript表达式访问时，从C ++方法返回的值被转换为JavaScript值。

连接 C++的信号

从 QML 连接 C++中的信号就更简单了，其实在第一篇文章中已经用过了信号的连接，这里再单独提出来讲一遍，和上面一样，也需要满足 C++是继承于 QObject 类型才可以，在 QML 中连接信号，格式如下：

on < singles >:
其中，signals 是 C++中定义的信号名称，在 QML 中连接的时候，只需要在信号名前面加 on，然后信号的第一个字母大写，最后加一个冒号，就 OK 了，我们来看看实际的示例：
同样是在上面的代码中进行修改：

class Student : public QObject
{
    Q_OBJECT
    Q_PROPERTY(QString name READ getName WRITE setName NOTIFY sigNameChanged)
public:
    explicit Student(QObject *parent = nullptr);
    ~Student(){}

    Q_INVOKABLE bool setHeight(int h){
        qDebug() << __FUNCTION__ << "call the C++ function with: " << h;
        return true;
    }

    void setName(const QString & name){
        if(name != m_name){
            m_name = name;
            emit sigNameChanged(m_name);
        }
    }
    QString getName() const {return m_name;}
signals:
    void sigNameChanged(QString name);

public slots:
    void onRefresh(){
        qDebug() << "call the c++ slot.";
    }

private:
    QString m_name;
};

在之前的基础上，这里多增加了一个信号，属性定义在之前的文章中已经介绍过了，就不在多说。

然后在 QML 中进行调用：

Window {
    visible: true
    width: 640
    height: 480

    Label{
        anchors.centerIn: parent
        text: student.name
    }

    Connections{
        target: student
        onSigNameChanged:{
            console.log("student name changed",name)
        }
    }

    Component.onCompleted: {
        student.name = "xiaoming"
    }

    Button{
        width: 30
        height: 30
        text: "click me"
        onClicked: {
            var ret = student.setHeight(100)
            console.log("C++ result of setHeight:",ret)
            student.onRefresh()
        }
    }
}

我们在页面加载完成后设置了 Student 的 name 属性：

Component.onCompleted: {
   student.name = "xiaoming"
}

然后通过Connections连接了信号，最后我们来看看输出消息：

qml: student name changed xiaoming

与属性值和方法参数一样，信号参数必须具有QML引擎支持的类型; （使用未注册的类型不会生成错误，但参数值将无法从处理程序访问。）
请注意，名称相同但参数不同的信号不能相互区分的，所以尽量不要使用同名的信号。
代码已经很简单了，至于信号的连接方式，后期再单独写文章进行介绍。

至此，所有的从 QML 调用 C++属性的方法都已经全部介绍完了。

回顾一下前面的文章：
基础属性调用->Qt C++属性类型提供给 QML调用（一）
对象类型属性调用->Qt C++属性类型提供给 QML调用（二）
列表类型属性调用->Qt C++属性类型提供给 QML调用（三）
分组类型属性调用->Qt C++属性类型提供给 QML调用（四）