Sur cette page

RadioButton QML Type

Bouton radio exclusif pouvant être activé ou désactivé. En savoir plus...

Import Statement: import QtQuick.Controls
Inherits:

AbstractButton

Description détaillée

RadioButton présente un bouton d'option pouvant être activé (coché) ou désactivé (décoche). Les boutons radio sont généralement utilisés pour sélectionner une option parmi un ensemble d'options.

RadioButton hérite de son API de AbstractButton. Par exemple, vous pouvez définir text et réagir à clicks à l’aide de l’API AbstractButton. L’état du bouton radio peut être défini à l’aide de la propriété checked.

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

RadioDelegate est similaire à RadioButton, à la différence qu’il est généralement utilisé dans les vues.

ColumnLayout {
    RadioButton {
        checked: true
        text: qsTr("First")
    }
    RadioButton {
        text: qsTr("Second")
    }
    RadioButton {
        text: qsTr("Third")
    }
}

Voir également « ButtonGroup» , «Customizing RadioButton, Button Controls» et « RadioDelegate ».

© 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.