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

Виджеты SpinBox и FloatSpinBox

Числовые поля с кнопками увеличения и уменьшения

Что такое SpinBox?

gui.SpinBox — это поле для ввода целых чисел со встроенными кнопками ▲ и ▼ для увеличения/уменьшения значения. gui.FloatSpinBox — то же самое, но для дробных чисел.

Где они встречаются в реальной жизни:

  • 🎮 Выбор количества игроков в лобби
  • ⚙️ Настройка чувствительности мыши (0–100)
  • 🎨 Выбор размера кисти в графическом редакторе
  • ⏰ Установка таймера (минуты и секунды)

Вот как выглядит простейший SpinBox со значением 5:

🔢 SpinBox для целых чисел. Попробуйте покрутить стрелки или ввести число вручную.

Основные свойства SpinBox

SpinBox имеет несколько важных свойств для управления диапазоном и поведением:

  • value — текущее значение (int)
  • min — минимальное допустимое значение
  • max — максимальное допустимое значение
  • step — шаг изменения при нажатии на стрелки
🎯 min=0, max=100, step=5 — значение меняется на 5 при каждом нажатии.

FloatSpinBox — для дробных чисел

gui.FloatSpinBox работает так же, как SpinBox, но хранит дробные числа (float):

🔢 FloatSpinBox для дробных чисел. Шаг 0.1, диапазон от 0.0 до 1.0.

Событие on_change

Когда пользователь меняет значение (через стрелки, клавиатуру или прямой ввод), срабатывает событие on_change. Это позволяет реагировать на изменения в реальном времени:

Текущее: 50
📢 Меняйте значение — текст рядом обновляется автоматически через on_change.