QML-Sequenztypen

Für jeden Objekt- und Wertetyp wird automatisch ein Sequenztyp zum Speichern mehrerer Instanzen des Typs zur Verfügung gestellt. Mit dem Schlüsselwort list können Sie Eigenschaften von Sequenztypen erstellen:

import QtQml

QtObject {
    property list<int> ints: [1, 2, 3, 4]
    property list<Connection> connections: [
        Connection {
            // ...
        },
        Connection {
            // ...
        }
    ]
}

Sequenzen von Wertetypen sind als QList und Sequenzen von Objekttypen als QQmlListProperty implementiert.

Sequenzen in QML verhalten sich im Allgemeinen wie der JavaScript-Typ Array, mit einigen wichtigen Unterschieden, die sich aus der Verwendung eines C++-Speichertyps in der Implementierung ergeben:

1. Das Löschen eines Elements aus einer Sequenz führt dazu, dass dieses Element durch einen standardmäßig konstruierten Wert ersetzt wird, und nicht durch einen undefined Wert.
2. Das Setzen der length Eigenschaft einer Sequenz auf einen Wert, der größer ist als ihr aktueller Wert, führt dazu, dass die Sequenz auf die angegebene Länge mit standardmäßig konstruierten Elementen aufgefüllt wird, anstatt mit undefined Elementen.
3. Die Qt-Containerklassen unterstützen vorzeichenbehaftete (und nicht vorzeichenlose) Integer-Indizes; der Versuch, auf einen Index zuzugreifen, der größer ist als die maximale Anzahl, die qsizetype aufnehmen kann, schlägt daher fehl.

Wenn Sie Elemente aus einer Sequenz entfernen möchten, anstatt sie einfach durch konstruierte Standardwerte zu ersetzen, verwenden Sie nicht den indizierten Löschoperator (delete sequence[i]), sondern verwenden Sie stattdessen die Funktion splice (sequence.splice(startIndex, deleteCount)).

Im Allgemeinen kann jeder Container, der von QMetaSequence erkannt wird, von C++ an QML über die Methoden Q_PROPERTY oder Q_INVOKABLE übergeben werden. Dies beinhaltet, ist aber nicht beschränkt auf, alle registrierten QList, QQueue, QStack, QSet, std::list, std::vector, die einen mit Q_DECLARE_METATYPE markierten Typ enthalten.

Die Verwendung einer Sequenz über QMetaSequence führt zu teuren Datenkonvertierungen. Um die Konvertierungen zu vermeiden, können Sie Ihre eigenen anonymen Sequenztypen mit QML_SEQUENTIAL_CONTAINER von C++ aus registrieren. Auf diese Weise registrierte Typen verhalten sich wie die vordefinierten Sequenztypen und werden so gespeichert, wie sie sind. Sie haben jedoch keine QML-Namen.

Das Modul QtQml enthält ein paar sequence types, die Sie vielleicht verwenden möchten.