Графические виджеты
Уроки Открыть IDE
На главную
Виджеты • Урок 8

Виджет RadioButton

Переключатель для выбора одного варианта из группы

Что такое RadioButton?

gui.RadioButton — это переключатель, который может быть либо выбран, либо нет. Главное отличие от CheckBox: радио-кнопки объединяются в группы, где только одна кнопка может быть выбрана в каждый момент времени.

Где он встречается:

  • 🎮 Выбор уровня сложности в игре (Лёгкий / Средний / Сложный)
  • 💳 Выбор способа оплаты (Карта / Наличные / Перевод)
  • 🌍 Выбор языка интерфейса
  • ⚙️ Настройки — «Вкл» / «Выкл» (когда вариантов 2–5)

Вот пример трёх радио-кнопок:

🔘 Выберите один из вариантов — остальные сбросятся автоматически.

Свойства text и is_selected

RadioButton имеет два основных свойства:

  • text — текст рядом с переключателем (string)
  • is_selected — выбран ли переключатель (bool)
🎮 Выберите уровень сложности, нажмите кнопку — программа покажет ваш выбор.

Группировка: свойство group

По умолчанию все RadioButton в одном окне (или одном контейнере) считаются одной группой. Но с помощью свойства group можно создавать независимые группы переключателей:

🔘 Две независимые группы: выбор в группе A не влияет на группу B.

Событие on_change

Событие on_change срабатывает каждый раз, когда пользователь меняет состояние переключателя:

Любимый цвет:
Выбрано: Красный
🔄 Переключайтесь между цветами — результат обновляется мгновенно через on_change.

RadioButton vs CheckBox

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