CheckDelegate QML Type

Délégué d'élément doté d'un indicateur de sélection pouvant être activé ou désactivé. En savoir plus...

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

Propriétés

• checkState : enumeration
• nextCheckState : function (since QtQuick.Controls 2.4 (Qt 5.11))
• tristate : bool

Description détaillée

CheckDelegate propose un délégué d'élément pouvant être activé (coché) ou désactivé (décoché). Les délégués Check sont généralement utilisés pour sélectionner une ou plusieurs options parmi un ensemble d'options figurant dans une liste. Pour les petits ensembles d'options, ou pour les options devant être identifiables de manière unique, envisagez plutôt d'utiliser CheckBox.

CheckDelegate hérite de son API de ItemDelegate, qui hérite lui-même de AbstractButton. Par exemple, vous pouvez définir text et réagir à clicks à l’aide de l’API AbstractButton. L’état du délégué de case à cocher peut être défini à l’aide de la propriété checked.

Outre les états « coché » et « non coché », il existe un troisième état : « partiellement coché ». L’état « partiellement coché » peut être activé à l’aide de la propriété tristate. Cet état indique que l’état « coché » ou « non coché » habituel ne peut pas être déterminé, généralement en raison d’autres états qui affectent le délégué de sélection. Cet état est utile lorsque plusieurs nœuds enfants sont sélectionnés dans une arborescence, par exemple.

ListView {
    model: ["Option 1", "Option 2", "Option 3"]
    delegate: CheckDelegate {
        text: modelData
    }
}

Voir également Personnalisation de CheckDelegate, Contrôles délégués et CheckBox.

Documentation sur les propriétés

checkState : enumeration

Cette propriété détermine l'état de vérification du délégué de vérification.

États disponibles :

Voir également « tristate » et « checked ».

nextCheckState : function [since QtQuick.Controls 2.4 (Qt 5.11)]

Cette propriété contient une fonction de rappel qui est appelée pour déterminer l'état suivant de la case à cocher chaque fois que l'utilisateur modifie l'état de la case à cocher de manière interactive, que ce soit au toucher, à la souris ou au clavier.

Par défaut, un délégué de coche normal alterne entre les états « Qt.Unchecked » et « Qt.Checked », tandis qu’un délégué de coche à trois états alterne entre les états « Qt.Unchecked », « Qt.PartiallyChecked » et « Qt.Checked ».

La fonction de rappel « nextCheckState » peut remplacer le comportement par défaut. L’exemple suivant implémente un délégué de vérification à trois états capable d’afficher un état « partiellement coché » en fonction de conditions externes, mais qui ne bascule jamais vers cet état lorsqu’il est activé ou désactivé de manière interactive par l’utilisateur.

CheckDelegate {
    tristate: true
    checkState: allChildrenChecked ? Qt.Checked :
                   anyChildChecked ? Qt.PartiallyChecked : Qt.Unchecked

    nextCheckState: function() {
        if (checkState === Qt.Checked)
            return Qt.Unchecked
        else
            return Qt.Checked
    }
}

Cette propriété a été introduite dans QtQuick.Controls 2.4 (Qt 5.11).

tristate : bool

Cette propriété détermine si le délégué de vérification dispose de trois états.

Dans l'animation ci-dessous, le premier délégué de case à cocher présente trois états :

La valeur par défaut est « false », c'est-à-dire que le délégué ne dispose que de deux états.