Back to Qt.io
Contact Us Blog Download Qt

ItemDelegate QML Type

Basic item delegate that can be used in various views and controls. More...

Import Statement: import QtQuick.Controls
Inherits:

AbstractButton

Inherited By:

CheckDelegate, RadioDelegate, SwipeDelegate, SwitchDelegate, and TreeViewDelegate

Properties

Detailed Description

ItemDelegate presents a standard view item. It can be used as a delegate in various views and controls, such as ListView and ComboBox.

ItemDelegate inherits its API from AbstractButton. For instance, you can set text, display an icon, and react to clicks using the AbstractButton API.

ListView {
    id: listView
    width: 160
    height: 240

    model: Qt.fontFamilies()

    delegate: ItemDelegate {
        text: modelData
        width: listView.width
        onClicked: console.log("clicked:", modelData)

        required property string modelData
    }

    ScrollIndicator.vertical: ScrollIndicator { }
}

See also Customizing ItemDelegate and Delegate Controls.

Property Documentation

highlighted : bool

This property holds whether the delegate is highlighted.

A delegate can be highlighted in order to draw the user's attention towards it. It has no effect on keyboard interaction. For example, you can highlight the current item in a ListView using the following code:

ListView {
    id: listView
    model: 10
    delegate: ItemDelegate {
        text: index
        highlighted: ListView.isCurrentItem

        required property int index

        onClicked: listView.currentIndex = index
    }
}

The default value is false.


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