CheckDelegate QML Type

Délégué d'élément avec un indicateur de vérification qui peut être activé ou désactivé. Plus d'informations...

• 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 présente un délégué d'élément qui peut être activé (coché) ou désactivé (non coché). Les délégués de contrôle sont généralement utilisés pour sélectionner une ou plusieurs options parmi un ensemble d'options dans une liste. Pour des ensembles d'options plus petits ou pour des options qui doivent être identifiables de manière unique, il est préférable d'utiliser CheckBox.

CheckDelegate hérite son API de ItemDelegate, qui hérite de AbstractButton. Par exemple, vous pouvez définir text et réagir à clicks en utilisant l'API AbstractButton. L'état du délégué au contrôle peut être défini à l'aide de la propriété checked.

Outre les états "checked" et "unchecked", il existe un troisième état : "partially checked". L'état partiellement vérifié peut être activé à l'aide de la propriété tristate. Cet état indique que l'état normal coché/décoché ne peut pas être déterminé, généralement en raison d'autres états qui affectent le délégué au contrôle. 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 aussi 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 contrôle du délégué au contrôle.

É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 de contrôle suivant chaque fois que le délégué de contrôle est basculé de manière interactive par l'utilisateur au moyen du toucher, de la souris ou du clavier.

Par défaut, un délégué de contrôle normal alterne entre les états Qt.Unchecked et Qt.Checked, et un délégué de contrôle à 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 met en œuvre un délégué de vérification à trois états qui peut présenter un état partiellement vérifié en fonction de conditions externes, mais qui ne passe jamais à l'état partiellement vérifié lorsque l'utilisateur le fait basculer de manière interactive.

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é au contrôle a trois états.

Dans l'animation ci-dessous, le premier délégué au contrôle est à trois états :

La valeur par défaut est false, c'est-à-dire que le délégué n'a que deux états.