ListElement QML Type

ListModel...에서 데이터 항목을 정의합니다.. ..

Import Statement: import QtQml.Models

상세 설명

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

목록 요소는 속성 대신 역할 정의 모음을 포함한다는 점을 제외하면 다른 QML 요소처럼 정의됩니다. 역할은 속성 정의와 동일한 구문을 사용하여 데이터에 액세스하는 방법을 정의하고 데이터 자체를 포함합니다.

역할에 사용되는 이름은 소문자로 시작해야 하며 지정된 모델의 모든 요소에 공통적으로 사용해야 합니다. 값은 단순한 상수여야 하며, 문자열( QT_TR_NOOP() 호출 내에서 따옴표로 묶어 선택적으로 사용), 부울 값(참, 거짓), 숫자 또는 열거형 값(예: AlignText.AlignHCenter) 중 하나여야 합니다.

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

역할 참조

역할 이름은 델리게이트가 목록 엘리먼트에서 데이터를 가져오는 데 사용됩니다. 각 역할 이름은 델리게이트의 범위에서 액세스할 수 있으며 현재 요소의 해당 역할을 참조합니다. 역할 이름을 사용하기 모호한 경우 model 속성을 통해 액세스할 수 있습니다(예: cost 대신 model.cost ).

사용 예

다음 모델은 일련의 목록 요소를 정의하며, 각 요소에는 '이름' 및 '비용' 역할과 관련 값이 포함되어 있습니다.

ListModel {
    id: fruitModel

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

델리게이트는 namecost 을 참조하여 각 요소의 이름과 비용을 얻습니다:

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

ListModel참조하세요 .

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.