list QML Value Type

a list of QML objects. 更多...

詳細描述

The list type refers to a list of QML objects or values.

Properties of type list are empty by default.

A list can store QML objects or 值類型值。

集成 C++ 時，注意任何 QQmlListProperty 值傳入 QML 來自 C++ is automatically converted into a list value, and vice-versa.

Similarly any QList<T> of a registered value type T is automatically converted into a list value, and vice-versa.

Using the list Type

例如， Item 類型擁有狀態 list-type property that can be assigned to and used as follows:

import QtQuick
Item {
    width: 100; height: 100
    states: [
        State { name: "activated" },
        State { name: "deactivated" }
    ]
    Component.onCompleted: {
        console.log("Name of first state:", states[0].name)
        for (var i = 0; i < states.length; i++)
            console.log("state", i, states[i].name)
    }
}

The defined State objects will be added to the states list in the order in which they are defined.

If the list only contains one object, the square brackets may be omitted:

import QtQuick
Item {
    width: 100; height: 100
    states: State { name: "activated" }
}

You can also declare your own list properties in QML:

import QtQml
QtObject {
    property list<int> intList: [1, 2, 3, 4]
    property list<QtObject> objectList
}

Lists can be used much like JavaScript arrays. For example:

Values are assigned using the [] square bracket syntax with comma-separated values
The length property provides the number of items in the list
Values in the list are accessed using the [index] syntax
可以使用 push() to append entries
可以設置 length property of the list to truncate or extend it.

However, you can not automatically extend the list by assigning to an index currently out of range. Furthermore, if you insert null values into a list of objects, those are converted to nullptr entries in the underlying QQmlListProperty .

A list of value types is different from a JavaScript array in one further important aspect: Growing it by setting its length does not produce undefined entries, but rather default-constructed instances of the value type.

Similarly, growing a list of object types this way produces null entries, rather than undefined entries.

此值類型由 QML 語言提供。

另請參閱 QML 值類型 .