En esta página

ListElement QML Type

Define un elemento de datos en un « ListModel ». Más información...

Import Statement: import QtQml.Models

Descripción detallada

Los elementos de lista se definen dentro de las definiciones de « ListModel » y representan elementos de una lista que se mostrarán mediante elementos « ListView » o « Repeater ».

Los elementos de lista se definen como cualquier otro elemento QML, salvo que contienen una colección de definiciones de roles en lugar de propiedades. Utilizando la misma sintaxis que las definiciones de propiedades, los roles definen cómo se accede a los datos e incluyen los propios datos.

Los nombres utilizados para los roles deben comenzar con una letra minúscula y deben ser comunes a todos los elementos de un modelo determinado. Los valores deben ser constantes simples: cadenas (entre comillas y, opcionalmente, dentro de una llamada a ` QT_TR_NOOP()`), valores booleanos (`true`, `false`), números o valores de enumeración (como `AlignText.AlignHCenter`).

A partir de Qt 5.11, ListElement también permite asignar una declaración de función a un rol. Esto permite definir ListElements con acciones invocables.

Referencia a roles

Los delegados utilizan los nombres de los roles para obtener datos de los elementos de la lista. Se puede acceder a cada nombre de rol en el ámbito del delegado, y hace referencia al rol correspondiente en el elemento actual. Cuando el uso de un nombre de rol resulte ambiguo, se puede acceder a él a través de la propiedad ` model ` (por ejemplo, ` model.cost ` en lugar de ` cost`).

Ejemplo de uso

El siguiente modelo define una serie de elementos de lista, cada uno de los cuales contiene los roles «name» y «cost» y sus valores asociados.

ListModel {
    id: fruitModel

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

El delegado obtiene el nombre y el coste de cada elemento simplemente haciendo referencia a name y cost:

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

Véase también ListModel.

© 2026 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.