ListElement QML Type

ListModel 의 데이터 항목을 정의합니다. 더 보기...

• 상속된 멤버를 포함한 모든 멤버 목록

상세 설명

List 요소는 ListModel 정의 내부에 정의되며, ListView 또는 Repeater 항목을 사용하여 표시될 목록의 항목을 나타냅니다.

목록 요소는 속성 대신 역할 정의 모음을 포함한다는 점을 제외하면 다른 QML 요소와 마찬가지로 정의됩니다. 속성 정의와 동일한 구문을 사용하는 역할은 데이터에 접근하는 방식을 정의할 뿐만 아니라 데이터 자체도 포함합니다.

역할에 사용되는 이름은 소문자로 시작해야 하며, 주어진 모델 내의 모든 요소에서 공통적으로 사용되어야 합니다. 값은 간단한 상수여야 하며, 문자열(따옴표로 묶고 선택적으로 ` QT_TR_NOOP()` 호출 내에 포함), 부울 값(true, false), 숫자 또는 열거형 값(예: `AlignText.AlignHCenter`)이어야 합니다.

Qt 5.11부터 ListElement는 역할에 함수 선언을 할당할 수도 있습니다. 이를 통해 호출 가능한 액션을 가진 ListElement를 정의할 수 있습니다.

역할 참조

델리게이트는 역할 이름을 사용하여 리스트 요소로부터 데이터를 가져옵니다. 각 역할 이름은 델리게이트의 범위 내에서 접근 가능하며, 현재 요소의 해당 역할을 가리킵니다. 역할 이름의 사용이 모호할 수 있는 경우, model 속성을 통해 접근할 수 있습니다(예: cost 대신 model.cost ).

사용 예시

다음 모델은 일련의 목록 요소를 정의하며, 각 요소는 "name" 및 "cost" 역할과 이에 연관된 값을 포함합니다.

ListModel {
    id: fruitModel

    ListElement {
        name: "Apple"
        cost: 2.45
    }
    ListElement {
        name: "Orange"
        cost: 3.25
    }
    ListElement {
        name: "Banana"
        cost: 1.95
    }
}

델리게이트는 name 및 cost 을 참조하기만 하면 각 요소의 이름과 비용을 얻을 수 있습니다:

ListView {
    anchors.fill: parent
    model: fruitModel
    delegate: Row {
        Text { text: "Fruit: " + name }
        Text { text: "Cost: $" + cost }
    }
}

ListModel도 참조하십시오 .