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

Виджет ComboBox

Выпадающий список для выбора одного варианта из нескольких

Что такое ComboBox?

gui.ComboBox — это выпадающий список, который позволяет пользователю выбрать один вариант из заранее заданного набора.

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

  • 🌍 Выбор страны или города в форме регистрации
  • 🎮 Выбор уровня сложности в игре
  • 📅 Выбор месяца или года в календаре
  • ⚙️ Выбор языка интерфейса в настройках

Вот простейший ComboBox с несколькими пунктами:

📋 Выпадающий список с тремя пунктами. Нажмите, чтобы раскрыть.

Добавление пунктов: метод add_item()

Пункты в список добавляются методом add_item(текст). Каждый вызов добавляет новый пункт в конец списка.

Очистка списка: метод clear_items()

Метод clear_items() удаляет все пункты из списка:

Свойства selected_index и selected_text

ComboBox предоставляет два способа узнать, что выбрал пользователь:

  • selected_index — номер выбранного пункта (int, нумерация с 0)
  • selected_text — текст выбранного пункта (string)
🎨 Выберите цвет из списка, нажмите кнопку — программа покажет ваш выбор.

Событие on_change

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

Выберите цвет
🔄 Меняйте выбранный пункт — лейбл обновляется мгновенно.