DelegateChooser QML Type

Permet à une vue d'utiliser différents délégués pour différents types d'éléments du modèle. En savoir plus...

• Liste de tous les membres, y compris les membres hérités

Propriétés

• choices : list<DelegateChoice>
• role : string

Description détaillée

DelegateChooser est un type d'Component s spécial destiné aux scénarios dans lesquels un composant est requis par une vue et utilisé comme délégué. DelegateChooser encapsule un ensemble d'DelegateChoice. Ces choix permettent de déterminer le délégué qui sera instancié pour chaque élément du modèle. La sélection s'effectue en fonction de la valeur attribuée à l'élément du modèle pour la propriété « role », ainsi qu'en fonction de son index.

DelegateChooser est couramment utilisé lorsqu’une vue doit afficher un ensemble de délégués très différents les uns des autres. Par exemple, une vue typique des paramètres d’un téléphone peut inclure des boutons à bascule, des curseurs, des boutons radio et d’autres éléments visuels en fonction du type de chaque paramètre. Dans ce cas, DelegateChooser peut offrir un moyen simple d’associer un type de délégué différent à chaque paramètre :

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
}

Voir également DelegateChoice.

Documentation sur les propriétés

choices : list<DelegateChoice> [default]

La liste des options de délégué pour le sélecteur.

Cette liste est traitée comme une liste ordonnée, dans laquelle la première propriété « DelegateChoice » correspondant à la condition sera utilisée par la vue.

Il n'est généralement pas nécessaire de faire référence à la propriété « choices », car il s'agit de la propriété par défaut de « DelegateChooser » et, par conséquent, tous les éléments enfants sont automatiquement attribués à cette propriété.

role : string

Cette propriété contient le rôle ou le nom de la propriété utilisé pour déterminer le délégué d'un élément de modèle donné.

Voir également DelegateChoice.