How to expose lists to QML/el: Difference between revisions

From Qt Wiki
Jump to navigation Jump to search
(Add "cleanup" tag)
(Convert ExpressionEngine links)
Line 12: Line 12:
== Ποιες κλάσεις να χρησιμοποιήσετε; ==
== Ποιες κλάσεις να χρησιμοποιήσετε; ==


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


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


Η QDeclarativeListProperty παρέχει 2 constructors. Ο "πρώτος":http://doc.qt.nokia.com/latest/qdeclarativelistproperty.html#QDeclarativeListProperty με όρισμα μία QList παρέχεται για διευκόλυνση και πρέπει να χρησιμοποιείται μόνο για prototyping καθώς δεν κάνει αυτόματη διαχείριση μνήμης. Σε κάθε περίπτωση, ενώνει τα bindings κατάλληλα και για το λόγο αυτό προτείνεται σε σχέση με την απλή χρήση μιας QList.
Η 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).
Ο δεύτερος [http://doc.qt.nokia.com/latest/qdeclarativelistproperty.html#QDeclarativeListProperty-3 QDeclarativeListProperty constructor] κατασκευάζει μια QDeclarativeListProperty από ένα σύνολο από operation functions. Λειτουργεί με το πέρασμα συναρτήσεων που καλούνται κατά την επέκταση, τον καθαρισμό, το μέτρημα και τη λήψη της τρέχουσας θέσης, αλλά απαιτείται να υλοποιήσετε μόνο την συνάρτηση επέκτασης. Αυτός είναι ο constructor που πρέπει να χρησιμοποιήσετε σε κώδικα παραγωγής (production code).


== Παράδειγμα για τη χρήση της QDeclarativeListProperty ==
== Παράδειγμα για τη χρήση της 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 μπορούν να υλοποιηθούν:
Το παρακάτω παράδειγμα δείχνει το πώς η [http://doc.qt.nokia.com/latest/qdeclarativelistproperty.html#AppendFunction-typedef QDeclarativeListProperty::AppendFunction] και η [http://doc.qt.nokia.com/latest/qdeclarativelistproperty.html#ClearFunction-typedef QDeclarativeListProperty::ClearFunction ] μπορούν να υλοποιηθούν:


<code>
<code>
Line 109: Line 109:
καθώς η Javascript δεν θα ξέρει αλλιώς πότε να κάνει τον καθαρισμό.
καθώς η Javascript δεν θα ξέρει αλλιώς πότε να κάνει τον καθαρισμό.


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


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


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

Revision as of 14:59, 4 March 2015

This article may require cleanup to meet the Qt Wiki's quality standards. Reason: Auto-imported from ExpressionEngine.
Please improve this article if you can. Remove the {{cleanup}} tag and add this page to Updated pages list after it's clean.

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

Ελληνικά English

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

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

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

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

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

Ο δεύτερος QDeclarativeListProperty constructor κατασκευάζει μια QDeclarativeListProperty από ένα σύνολο από operation functions. Λειτουργεί με το πέρασμα συναρτήσεων που καλούνται κατά την επέκταση, τον καθαρισμό, το μέτρημα και τη λήψη της τρέχουσας θέσης, αλλά απαιτείται να υλοποιήσετε μόνο την συνάρτηση επέκτασης. Αυτός είναι ο constructor που πρέπει να χρησιμοποιήσετε σε κώδικα παραγωγής (production code).

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

Το παρακάτω παράδειγμα δείχνει το πώς η QDeclarativeListProperty::AppendFunction και η QDeclarativeListProperty::ClearFunction μπορούν να υλοποιηθούν:

#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 παρέχει το ακόλουθο παράδειγμα το οποίο μπορεί να σας φανεί χρήσιμο να του ρίξετε μια ματιά.

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

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