DelegateChooser QML Type

Allows a view to use different delegates for different types of items in the model. More...

• List of all members, including inherited members

Properties

• choices : list<DelegateChoice>
• role : string

Detailed Description

The DelegateChooser is a special Component type intended for those scenarios where a Component is required by a view and used as a delegate. DelegateChooser encapsulates a set of DelegateChoices. These choices are used to determine the delegate that will be instantiated for each item in the model. The selection of the choice is performed based on the value that a model item has for role, and also based on index.

DelegateChooser is commonly used when a view needs to display a set of delegates that are significantly different from each other. For example, a typical phone settings view might include toggle switches, sliders, radio buttons, and other visualizations based on the type of each setting. In this case, DelegateChooser could provide an easy way to associate a different type of delegate with each setting:

import QtQml.Models
import QtQuick
import QtQuick.Controls

ListView {
    width: 200; height: 400

    ListModel {
        id: listModel
        ListElement { type: "info"; ... }
        ListElement { type: "switch"; ... }
        ListElement { type: "swipe"; ... }
        ListElement { type: "switch"; ... }
    }

    DelegateChooser {
        id: chooser
        role: "type"
        DelegateChoice { roleValue: "info"; ItemDelegate { ... } }
        DelegateChoice { roleValue: "switch"; SwitchDelegate { ... } }
        DelegateChoice { roleValue: "swipe"; SwipeDelegate { ... } }
    }

    model: listModel
    delegate: chooser
}

See also DelegateChoice.

Property Documentation