How to expose lists to QML/el
Ελληνικά English
Πώς να χρησιμοποιήσετε λίστες στην QML
Ποιες κλάσεις να χρησιμοποιήσετε;
Η QDeclarativeListProperty [doc.qt.nokia.com] σας επιτρέπει να χρησιμοποιήσετε (κάνει expose) τις λίστες ως ιδιότητες στην QML. Όταν υλοποιείτε τους function pointers σε αυτή την κλάση, η διαχείριση μνήμης θα γίνει αυτόματα και τα bindings θα δουλεύουν σωστά. Χρησιμοποιώντας μία στάνταρ QList [doc.qt.nokia.com] αντί για μια QDeclarativeListProperty, δεν θα λάβει χώρα η αυτόματη διαχείριση μνήμης με πιθανό κίνδυνο leak της εφαρμογής σας. Επιπρόσθετα, η QList δεν παρέχει σήματα ειδοποίησης (notification signals) όταν τα παιδιά της (children) τροποποιούνται. Έτσι, όταν χρησιμοποιείτε μια QList, τα bindings δεν θα λειτουργούν σωστά. Συνεπώς, η QDeclarativeListProperty είναι η ενδεδειγμένη κλάση για χρήση λιστών στην QML.
Ποιον constructor να χρησιμοποιήσω?
Η QDeclarativeListProperty παρέχει 2 constructors. Ο πρώτος [doc.qt.nokia.com] με όρισμα μία QList παρέχεται για διευκόλυνση και πρέπει να χρησιμοποιείται μόνο για prototyping καθώς δεν κάνει αυτόματη διαχείριση μνήμης. Σε κάθε περίπτωση, ενώνει τα bindings κατάλληλα και για το λόγο αυτό προτείνεται σε σχέση με την απλή χρήση μιας QList.
Ο δεύτερος QDeclarativeListProperty constructor [doc.qt.nokia.com] κατασκευάζει μια QDeclarativeListProperty από ένα σύνολο από operation functions. Λειτουργεί με το πέρασμα συναρτήσεων που καλούνται κατά την επέκταση, τον καθαρισμό, το μέτρημα και τη λήψη της τρέχουσας θέσης, αλλά απαιτείται να υλοποιήσετε μόνο την συνάρτηση επέκτασης. Αυτός είναι ο constructor που πρέπει να χρησιμοποιήσετε σε κώδικα παραγωγής (production code).
Παράδειγμα για τη χρήση της QDeclarativeListProperty
Το παρακάτω παράδειγμα δείχνει το πώς η QDeclarativeListProperty::AppendFunction [doc.qt.nokia.com] και η QDeclarativeListProperty::ClearFunction [doc.qt.nokia.com] μπορούν να υλοποιηθούν:
Λόγω του τρόπου που η QDeclarativeListProperty λειτουργεί είναι απαραίτητο να κρατάτε διαθέσιμη την QList όσο η ιδιότητα είναι έγκυρη και αυτός είναι ο λόγος για τον οποίο είναι μέλος της κλάσης εδώ.
Το ακόλουθο αρχείο QML δείχνει το πώς η παραπάνω κλάση μπορεί να χρησιμοποιηθεί και να καθαριστεί στην qml.
Σημειώστε ότι για τον καθαρισμό είναι απαραίτητο να κάνετε το εξής:
καθώς η Javascript δεν θα ξέρει αλλιώς πότε να κάνει τον καθαρισμό.
Η τεκμηρίωση του Qt παρέχει το ακόλουθο παράδειγμα [doc.qt.nokia.com] το οποίο μπορεί να σας φανεί χρήσιμο να του ρίξετε μια ματιά.
Δυναμική τροποποίηση των λιστών
Η δυναμική τροποποίηση των λιστών δεν υποστηρίζεται σωστά ακόμη, λόγω ζητημάτων με τα bindings και τις λίστες. Ο τρέχων τρόπος τροποποίησης μιας λίστας είναι η ανάθεση μιας νέας λίστας στη θέση της.