How to expose lists to QML/el

[toc align_right="yes" depth="2"]

Ελληνικά English

Πώς να χρησιμοποιήσετε λίστες στην QML

Ποιες κλάσεις να χρησιμοποιήσετε;

Η "QDeclarativeListProperty":http://doc.qt.nokia.com/latest/qdeclarativelistproperty.html σας επιτρέπει να χρησιμοποιήσετε (κάνει expose) τις λίστες ως ιδιότητες στην QML. Όταν υλοποιείτε τους function pointers σε αυτή την κλάση, η διαχείριση μνήμης θα γίνει αυτόματα και τα bindings θα δουλεύουν σωστά. Χρησιμοποιώντας μία στάνταρ "QList ":http://doc.qt.nokia.com/latest/qlist.html αντί για μια QDeclarativeListProperty, δεν θα λάβει χώρα η αυτόματη διαχείριση μνήμης με πιθανό κίνδυνο leak της εφαρμογής σας. Επιπρόσθετα, η QList δεν παρέχει σήματα ειδοποίησης (notification signals) όταν τα παιδιά της (children) τροποποιούνται. Έτσι, όταν χρησιμοποιείτε μια QList, τα bindings δεν θα λειτουργούν σωστά. Συνεπώς, η QDeclarativeListProperty είναι η ενδεδειγμένη κλάση για χρήση λιστών στην QML.

Ποιον constructor να χρησιμοποιήσω?

Η QDeclarativeListProperty παρέχει 2 constructors. Ο "πρώτος":http://doc.qt.nokia.com/latest/qdeclarativelistproperty.html#QDeclarativeListProperty με όρισμα μία QList παρέχεται για διευκόλυνση και πρέπει να χρησιμοποιείται μόνο για prototyping καθώς δεν κάνει αυτόματη διαχείριση μνήμης. Σε κάθε περίπτωση, ενώνει τα bindings κατάλληλα και για το λόγο αυτό προτείνεται σε σχέση με την απλή χρήση μιας QList.

Ο δεύτερος "QDeclarativeListProperty constructor":http://doc.qt.nokia.com/latest/qdeclarativelistproperty.html#QDeclarativeListProperty-3 κατασκευάζει μια QDeclarativeListProperty από ένα σύνολο από operation functions. Λειτουργεί με το πέρασμα συναρτήσεων που καλούνται κατά την επέκταση, τον καθαρισμό, το μέτρημα και τη λήψη της τρέχουσας θέσης, αλλά απαιτείται να υλοποιήσετε μόνο την συνάρτηση επέκτασης. Αυτός είναι ο constructor που πρέπει να χρησιμοποιήσετε σε κώδικα παραγωγής (production code).

Παράδειγμα για τη χρήση της QDeclarativeListProperty

Το παρακάτω παράδειγμα δείχνει το πώς η "QDeclarativeListProperty::AppendFunction":http://doc.qt.nokia.com/latest/qdeclarativelistproperty.html#AppendFunction-typedef και η "QDeclarativeListProperty::ClearFunction ":http://doc.qt.nokia.com/latest/qdeclarativelistproperty.html#ClearFunction-typedef μπορούν να υλοποιηθούν:

#include <QtGui>
#include <QtDeclarative>

class MyObject : public QObject
{
 Q_OBJECT
 Q_PROPERTY(QDeclarativeListProperty<MyObject> getInfo READ getInfo CONSTANT)
public:
 MyObject()
 {}

~MyObject()
 {}
 QDeclarativeListProperty<MyObject> getInfo()
 {
 for (int i = 0; i < 10; +''i)
 {
 list << new MyObject();
 }
 return QDeclarativeListProperty<MyObject>(this, 0, &amp;MyObject::appendObject, 0, 0, &amp;MyObject::clearObject);
 }
 static void appendObject(QDeclarativeListProperty<MyObject> *l, MyObject *obj)
 {
 MyObject '''object = qobject_cast<MyObject'''>(l->object);
 if (object)
 object->list << obj;
 }
 static void clearObject(QDeclarativeListProperty<MyObject> *l)
 {
 MyObject '''object = qobject_cast<MyObject'''>(l->object);
 if (object) {
 foreach (MyObject '''o, object->list)
 delete o;
 object->list.clear();
 }
 }
 QList<MyObject'''> list;
}; 

#include "main.moc" 

int main(int argc, char** argv)
{
 QApplication app(argc, argv);
 QDeclarativeView view;
 qmlRegisterType<MyObject>("QtQuick", 1, 0, "MyObject");
 view.setSource(QUrl::fromLocalFile("test.qml"));
 view.show();
 return app.exec();
}

Λόγω του τρόπου που η QDeclarativeListProperty λειτουργεί είναι απαραίτητο να κρατάτε διαθέσιμη την QList όσο η ιδιότητα είναι έγκυρη και αυτός είναι ο λόγος για τον οποίο είναι μέλος της κλάσης εδώ.

Το ακόλουθο αρχείο QML δείχνει το πώς η παραπάνω κλάση μπορεί να χρησιμοποιηθεί και να καθαριστεί στην qml.

import QtQuick 1.0 

Rectangle {
 id: page
 width: 500; height: 200
 color: "red" 

 MyObject
 {
 id: myObject
 Component.onCompleted: {
 print("completed…"'' myObject.getInfo);

for (var i=0; i<100; ++i) {
 myObject.getInfo = [];
 }
 }
 }
}

Σημειώστε ότι για τον καθαρισμό είναι απαραίτητο να κάνετε το εξής:

myObject.getInfo = []

καθώς η Javascript δεν θα ξέρει αλλιώς πότε να κάνει τον καθαρισμό.

Η τεκμηρίωση του Qt παρέχει το ακόλουθο "παράδειγμα":http://doc.qt.nokia.com/latest/declarative-tutorials-extending-chapter5-listproperties.html το οποίο μπορεί να σας φανεί χρήσιμο να του ρίξετε μια ματιά.

Δυναμική τροποποίηση των λιστών

Η δυναμική τροποποίηση των λιστών δεν υποστηρίζεται σωστά ακόμη, λόγω ζητημάτων με τα bindings και τις λίστες. Ο τρέχων τρόπος τροποποίησης μιας λίστας είναι η ανάθεση μιας νέας λίστας στη θέση της.