TableViewDelegate QML Type

Un délégué pouvant être attribué à une TableView. En savoir plus…

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

Propriétés

• current : bool
• editing : bool
• selected : bool
• tableView : TableView

Description détaillée

Un TableViewDelegate est un délégué qui peut être attribué à la propriété delegate property d'un TableView. Il affiche chaque cellule du tableau dans la vue en utilisant le style de l'application.

TableView {
    anchors.fill: parent
    delegate: TableViewDelegate {}
    // model: yourModel
}

TableViewDelegate hérite de ItemDelegate, ce qui signifie qu’il est composé de deux éléments : un background et un contentItem.

La position du `contentItem` est contrôlée par ` padding`.

Interaction avec les pointeurs

TableViewDelegate hérite de ItemDelegate. Cela signifie qu’il émettra des signaux tels que clicked lorsque l’utilisateur clique sur le délégué. Vous pouvez vous connecter à ce signal pour implémenter des fonctionnalités spécifiques à votre application.

Cependant, l’API ` ItemDelegate ` ne fournit aucune information sur la position du clic ni sur les touches de modification enfoncées. Si cela s’avère nécessaire, il est préférable d’utiliser des gestionnaires de pointeur, par exemple :

TableView {
    id: tableView
    delegate: TableViewDelegate {
        TapHandler {
            acceptedButtons: Qt.RightButton
            onTapped: someContextMenu.open()
        }

        TapHandler {
            acceptedModifiers: Qt.ControlModifier
            onTapped: tableView.doSomethingToCell(row, column)
        }
    }
}

Modification des cellules du tableau

TableViewDelegate dispose d’un edit delegate attribué par défaut. Si TableView a edit triggers défini, et si l’ model prend en charge editing model items, l’utilisateur peut alors activer n’importe lequel des déclencheurs d’édition pour modifier le texte de la cellule de tableau current.

Le délégué d'édition par défaut utilisera le Qt.EditRole pour lire et écrire des données dans le model. Si vous devez utiliser un autre rôle ou si vos besoins dépassent les capacités du délégué d'édition par défaut, vous pouvez toujours attribuer votre propre délégué à TableView.editDelegate.

Voir également Personnalisation deTableViewDelegate et TableView.

Documentation sur les propriétés

current : bool

Cette propriété s'applique, que le délégué représente ou non l'current index dans l'selection model.

editing : bool

Cette propriété est valable, que le délégué soit ou non en cours d'edited.

selected : bool

Cette propriété s'applique, que le délégué représente ou non une « selected index » dans l'selection model.

tableView : TableView

Cette propriété pointe vers l'TableView e qui contient l'élément délégué.