QML ListHeading Element

Symbian: Provides a heading for a list or a section in a list. More...

Inherits Item

List of all members, including inherited members

Properties

• paddingItem : Item

Detailed Description

ListHeading can be used as the header at the top of a list or as a header for sections within a list. ListHeading only draws a background, so ListItemText is typically used to display text on top of ListHeading. ListItemText provides styled fonts for the ListItem and ListHeading components.

The area to which Items can be added within ListHeading is defined by the paddingItem property. ListItemText can be anchored to the paddingItems anchor lines.

The following two examples illustrate how to use ListHeading with ListItemText.

Using a ListHeading as a list header

 Component {
     id: listHeader

     ListHeading {
         id: listHeading

         ListItemText {
             id: headingText
             anchors.fill: listHeading.paddingItem
             role: "Heading"
             text: "Test list"
         }
     }
 }

 ListView {
     id: listView
     anchors.fill: parent
     header: listHeader
     ...
 }

Using a ListHeading as a section header

 Component {
     id: sectionHeader

     ListHeading {
         id: sectionHeading

         ListItemText {
             id: headingText
             anchors.fill: sectionHeading.paddingItem
             role: "Heading"
             text: "Items with " + section + " in them:"
         }
     }
 }

 ListModel {
     id: listModel
     ListElement {
         image: "list2.png"
         ...
     }
     ...
 }

 ListView {
     id: listView
     anchors.fill: parent
     model: listModel
     section.property: "image"
     section.delegate: sectionHeader
     ...
 }

See also ListItem and ListItemText.

Property Documentation