list QML Value Type

QML 객체 목록입니다. 더 보기...

상세 설명

list 유형은 QML 개체 또는 값의 목록을 나타냅니다.

list 유형의 속성은 기본적으로 비어 있습니다.

list 에는 QML 객체 또는 값 유형 값을 저장할 수 있습니다.

C++와 통합할 때 C++에서 QML로 전달된 QQmlListProperty 값은 자동으로 list 값으로 변환되며, 그 반대의 경우도 마찬가지입니다.

마찬가지로 등록된 값 유형 T 의 QList<T> 은 list 값으로 자동 변환되며, 그 반대의 경우도 마찬가지입니다.

목록 유형 사용

예를 들어 Item 유형에는 states 목록 유형 속성을 다음과 같이 할당하여 사용할 수 있습니다:

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)
    }
}

정의된 State 개체는 정의된 순서대로 states 목록에 추가됩니다.

목록에 객체가 하나만 포함된 경우 대괄호는 생략할 수 있습니다:

import QtQuick

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

QML에서 자체 목록 속성을 선언할 수도 있습니다:

import QtQml

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

목록은 JavaScript 배열과 매우 유사하게 사용할 수 있습니다. 예를 들어

• 쉼표로 구분된 값과 함께 [] 대괄호 구문을 사용하여 값을 할당합니다.
• length 속성은 목록의 항목 수를 제공합니다.
• 목록의 값은 [index] 구문을 사용하여 액세스합니다.
• push() 을 사용하여 항목을 추가할 수 있습니다.
• 목록의 length 속성을 설정하여 목록을 잘라내거나 확장할 수 있습니다.

그러나 현재 범위를 벗어난 인덱스에 할당하여 목록을 자동으로 확장할 수는 없습니다. 또한 객체 목록에 null 값을 삽입하면 해당 값은 기본 QQmlListProperty 에서 nullptr 항목으로 변환됩니다.

값 유형 목록은 한 가지 더 중요한 측면에서 자바스크립트 배열과 다릅니다: 길이를 설정하여 길이를 늘리면 정의되지 않은 항목이 생성되지 않고 기본적으로 구성된 값 유형의 인스턴스가 생성됩니다.

마찬가지로 이러한 방식으로 객체 유형 목록을 늘리면 정의되지 않은 항목이 아니라 null 항목이 생성됩니다.

이 값 유형은 QML 언어에서 제공합니다.

QML 값 유형도 참조하세요 .