C

ListModel QML 类型

定义了一个自由格式的列表数据源。 更多...

导入语句import QtQuick
实例化 ListModel

属性属性

方法方法

  • var data(int index)
  • var get(int index)

详细描述详细描述

ListModel 是一个简单的 ListElement 定义容器，每个定义包含数据角色。内容可以在 QML 中声明性定义。

作为 Qul::ListModel，可以通过其 count 属性获取模型中元素的数量，并可以使用 data 或 get 查询数据。

与 Qt Quick 相反，ListModel 在 Qt Quick Ultralite 中是只读的。没有添加、删除或更改元素的函数。请参阅Qt Quick Ultralite 中的模型差异。

示例用法示例用法

以下示例展示了包含三个元素和“name”、“cost”角色的 ListModel。

ListModel {
    id: fruitModel

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

每个元素中的角色（属性）必须以小写字母开头，并应与模型中所有元素通用。有关元素定义的更多指南，请参阅 ListElement 文档。

示例模型包含一个 id 属性，该属性可以通过视图进行引用，例如，本例中的 ListView。

import QtQuick 2.15

Rectangle {
    width: 200; height: 200

    ListModel {
        id: fruitModel
        ...
    }

    Component {
        id: fruitDelegate
        Row {
            width: view.width / fruitModel.count
            height: view.height / fruitModel.count
            spacing: 10
            Text { text: model.name }
            Text { text: '$' + model.cost }
        }
    }

    ListView {
        id: view
        anchors.fill: parent
        model: fruitModel
        delegate: fruitDelegate
    }
}

另请参阅ListElement 和 Qt Quick Ultralite 中的模型差异。

属性文档

count : int

模型中的数据条目数。


方法文档

var data(int index)

在 index 位置访问模型数据。


var get(int index)

在 index 位置访问模型数据。


在某些 Qt 许可下可用。
了解更多。