RadioDelegate QML Type

Élément « delegate » exclusif doté d'un indicateur radio pouvant être activé ou désactivé. En savoir plus...

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

Description détaillée

RadioDelegate propose un délégué d'élément pouvant être activé (coché) ou désactivé (décoché). Les délégués de type radio sont généralement utilisés pour sélectionner une option parmi un ensemble d'options.

RadioDelegate 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é radio peut être défini à l’aide de la propriété checked.

Les délégués radio sont « auto-exclusive » par défaut. Un seul délégué peut être coché à la fois parmi les délégués radio appartenant au même élément parent ; cocher un autre délégué décoche automatiquement celui qui était coché auparavant. Pour les délégués radio qui ne partagent pas de parent commun, la méthode « ButtonGroup » peut être utilisée pour gérer l’exclusivité.

RadioButton est similaire à RadioDelegate, à la différence qu’il n’est généralement pas utilisé dans les vues, mais plutôt lorsqu’il n’y a que quelques options, et souvent avec l’exigence que chaque bouton soit identifiable de manière unique.

ButtonGroup {
    id: buttonGroup
}

ListView {
    model: ["Option 1", "Option 2", "Option 3"]
    delegate: RadioDelegate {
        text: modelData
        checked: index == 0
        ButtonGroup.group: buttonGroup
    }
}

Voir également Personnalisation de RadioDelegate, Contrôles délégués et RadioButton.