前言

前面兩篇文章已經介紹了 QML 中如何呼叫 C++中的基礎屬性以及物件屬性，今天繼續來介紹另外一種：物件為列表型別的屬性呼叫方法。

概述

包含QObject派生型別列表的屬性也可以暴露給QML使用，但是，應該使用QQmlListProperty類而不是QList< T >作為屬性型別。這是因為QList不是QObject派生的型別，所以不能通過Qt元物件系統提供必要的QML屬性特性，例如，當列表被修改時的訊號通知，這就需要呼叫物件為列表型別的屬性。

QQmlListProperty是一個模板類，可以通過QList值方便地構建。

正文

我們繼續在之前的工程中進行修改，新建一個 School 類，示例如下：

//school.h
#include <QQmlListProperty>
#include <QObject>
#include <QDebug>
#include "student.h"

class School : public QObject
{
    Q_OBJECT
    Q_PROPERTY(QQmlListProperty<Student> students READ students)

public:

    explicit School(QObject * parent = 0);
    QQmlListProperty<Student> students();
    void
 
 appendStudent(Student * stu);
    int studentCount() const;
    Student *student(int) const;
    void clearStudent();

private:
    static void appendStudent(QQmlListProperty<Student> *list, Student * s);
    static int studentCount(QQmlListProperty<Student>*);
    static Student* student(QQmlListProperty<Student>*, int
 
);
    static void clearStudent(QQmlListProperty<Student>*);


private:
    QList<Student *> m_students;
};

//school.cpp
School::School(QObject *parent) : QObject(parent)
{

}

QQmlListProperty<Student> School::students()
{
    return QQmlListProperty<Student>(this,this,
                                     &School::appendStudent,
                                     &School::studentCount,
                                     &School::student,
                                     &School::clearStudent);
}

void School::appendStudent(Student *stu)
{
    m_students.append(stu);
}

int School::studentCount() const
{
    return m_students.count();
}

Student *School::student(int index) const
{
    return m_students.at(index);
}

void School::clearStudent()
{
    return m_students.clear();
}

void School::appendStudent(QQmlListProperty<Student> *list, Student *s)
{
    reinterpret_cast< School* >(list->data)->appendStudent(s);
}

int School::studentCount(QQmlListProperty<Student> *list)
{
    return reinterpret_cast< School* >(list->data)->studentCount();
}

Student *School::student(QQmlListProperty<Student> *list, int i)
{
    return reinterpret_cast< School* >(list->data)->student(i);
}

void School::clearStudent(QQmlListProperty<Student> *list)
{
    reinterpret_cast< School* >(list->data)->clearStudent();
}

School 裡面提供了一個students列表，並註冊成QQmlListProperty型別供 QML 呼叫。

然後 Student 類保持不變：

class Student : public QObject
{
    Q_OBJECT
    Q_PROPERTY(QString name READ getName WRITE setName NOTIFY sigNameChanged)


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


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


private:
    QString m_name;

};

在 Main 函式中對類進行註冊：

qmlRegisterType<Student>("Student", 1, 0, "Student");
qmlRegisterType<School>("School", 1, 0, "School");

然後在 QML 中進行呼叫：

import QtQuick 2.8
import Student 1.0
import School 1.0

School{
    students:[
        Student{name:"xiaoming"},
        Student{name:"zhangsan"},
        Student{name:"lisi"}
    ]
}

這裡定義了一個School型別，其中包含三個 Student，每個 Student 設定其名稱。

然後我們回到 main 函式中 將 qml 定義好的物件打印出來看看效果：

QQmlEngine engine;
QQmlComponent component(&engine, QUrl("qrc:main.qml"));
School *school = qobject_cast<School *>(component.create());

if(school){
   for (int i = 0; i < school->studentCount(); ++i)
      qWarning() << "   " << school->student(i)->getName();
}

執行程式，輸出如下：

"xiaoming"
"zhangsan"
"lisi"

本文中是試驗從 QML 中建立列表物件，然後在C++中打印出建立好的列表，當然也可以在 C++中建立好列表，然後在 QML 中進行呼叫。使用方法都是一樣，這裡就不再贅述。

需要注意的是，在 Qt 幫助文件中，QQmlListProperty的使用方法如下：

class MessageBoard : public QObject
{
    Q_OBJECT
    Q_PROPERTY(QQmlListProperty<Message> messages READ messages)
public:
    QQmlListProperty<Message> messages();

private:
    static void append_message(QQmlListProperty<Message> *list, Message *msg);

    QList<Message *> m_messages;
};

QQmlListProperty<Message> MessageBoard::messages()
{
    return QQmlListProperty<Message>(this, 0, &MessageBoard::append_message);
}

void MessageBoard::append_message(QQmlListProperty<Message> *list, Message *msg)
{
    MessageBoard *msgBoard = qobject_cast<MessageBoard *>(list->object);
    if (msg)
        msgBoard->m_messages.append(msg);
}

• 這裡新增列表元素的時候只用到了一個靜態函式append_message，奇怪的是我用這種方法一直會報錯，編譯不通過，無奈之下用了第二種方法，將所有需要的靜態函式全部寫進去了。其實該類的建構函式有三個，如下：

QQmlListProperty::QQmlListProperty(QObject *object, QList<T *> &list)
QQmlListProperty::QQmlListProperty(QObject *object, void *data, AppendFunction append, CountFunction count, AtFunction at, ClearFunction clear)
QQmlListProperty::QQmlListProperty(QObject *object, void *data, CountFunction count, AtFunction at)

我用第一個建構函式的方式一直報錯，然而使用所有引數的形式就正常，目前還不知道是什麼原因，先這樣吧。

程式碼在這裡