Sur cette page

RadioDelegate QML Type

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

Import Statement: import QtQuick.Controls
Inherits:

ItemDelegate

Description détaillée

RadioDelegate présente un délégué d'élément qui peut être activé (coché) ou désactivé (non coché). Les délégués radio sont généralement utilisés pour sélectionner une option parmi un ensemble d'options.

RadioDelegate hérite son API de ItemDelegate, qui hérite 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 contrôlé à la fois parmi les délégués radio qui appartiennent au même élément parent ; le contrôle d'un autre délégué annule automatiquement le contrôle du délégué précédemment contrôlé. Pour les délégués radio qui ne partagent pas un parent commun, ButtonGroup peut être utilisé pour gérer l'exclusivité.

RadioButton est similaire à RadioDelegate, sauf 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 aussi Personnaliser RadioDelegate, Contrôles délégués et RadioButton.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.