ListElement QML Element

TheListElement element defines a data item in aListModel.More...

• List of all members, including inherited members

Detailed Description

List elements are defined insideListModel definitions, and represent items in a list that will be displayed usingListView orRepeater items.

List elements are defined like other QML elements except that they contain a collection ofrole definitions instead of properties. Using the same syntax as property definitions, roles both define how the data is accessed and include the data itself.

The names used for roles must begin with a lower-case letter and should be common to all elements in a given model. Values must be simple constants; either strings (quoted and optionally within a call toQT_TR_NOOP), boolean values (true, false), numbers, or enumeration values (such as AlignText.AlignHCenter).

Referencing Roles

The role names are used by delegates to obtain data from list elements. Each role name is accessible in the delegate's scope, and refers to the corresponding role in the current element. Where a role name would be ambiguous to use, it can be accessed via themodel property (e.g.,model.cost instead ofcost).

Example Usage

The following model defines a series of list elements, each of which contain "name" and "cost" roles and their associated values.

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

The delegate obtains the name and cost for each element by simply referring toname andcost:

ListView {anchors.fill:parentmodel:fruitModeldelegate:Row {Text {text:"Fruit: "+name }Text {text:"Cost: $"+cost }    }}

See alsoListModel.