Тип QML RadioDelegate

Эксклюзивный элемент-делегат с индикатором радиокнопки, который можно включить или выключить. Подробнее...

• Список всех членов, включая унаследованные

Подробное описание

RadioDelegate представляет собой элемент-делегат, который можно включить (отметить) или выключить (не отметить). Делегаты RadioDelegate обычно используются для выбора одного варианта из набора вариантов.

RadioDelegate наследует свой API от ItemDelegate, который наследует от AbstractButton. Например, вы можете установить текст и реагировать на щелчки с использованием API AbstractButton. Состояние делегата RadioDelegate можно установить с помощью свойства checked.

Делегаты RadioDelegate по умолчанию являются автоматически исключающими. Только один делегат может быть отмечен в любой момент среди делегатов RadioDelegate, которые принадлежат одному родительскому элементу; выбор другого делегата автоматически сбрасывает предыдущий выбранный. Для делегатов RadioDelegate, которые не имеют общего родителя, можно использовать ButtonGroup для управления эксклюзивностью.

RadioButton похож на RadioDelegate, за исключением того, что его обычно не используют в представлениях, а скорее тогда, когда имеется лишь несколько вариантов, и часто с требованием уникальной идентификации каждой кнопки.

ButtonGroup {
    id: buttonGroup
}

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

См. также Настройка RadioDelegate, Делегатские элементы управления и RadioButton.