Класс QSpinBox

Класс QSpinBox предоставляет виджет спин-бокc. Подробнее...

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

Свойства

• 12 свойств унаследовано от QAbstractSpinBox
• 58 свойств унаследовано от QWidget
• 1 свойство унаследовано от QObject

Открытые функции

• 30 открытых функций унаследовано от QAbstractSpinBox
• 211 открытых функций унаследовано от QWidget
• 31 открытых функций унаследовано от QObject
• 14 открытых функций унаследовано от QPaintDevice

Открытые слоты

• 4 открытых слота унаследовано от QAbstractSpinBox
• 19 открытых слотов унаследовано от QWidget
• 1 открытый слот унаследовано от QObject

Сигналы

• 1 сигнал унаследован от QAbstractSpinBox
• 3 сигнала унаследовано от QWidget
• 2 сигнала унаследовано от QObject

Защищённые функции

Переопределённые защищённые функции

• 20 защищённых функций, унаследованных от QAbstractSpinBox
• 35 защищённых функций, унаследованных от QWidget
• 9 защищённых функций, унаследованных от QObject
• 1 защищённая функция, унаследованная от QPaintDevice

Дополнительные унаследованные члены

• 5 статических публичных членов, унаследованных от QWidget
• 11 статических публичных членов, унаследованных от QObject
• 1 защищённый слот, унаследованный от QWidget

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

Класс QSpinBox предоставляет виджет спин-бокса.

QSpinBox предназначен для работы с целыми числами и дискретными наборами значений (например, названиями месяцев); используйте QDoubleSpinBox для значений с плавающей точкой.

QSpinBox позволяет пользователю выбирать значение, нажимая кнопки вверх/вниз или нажимая клавиши вверх/вниз на клавиатуре для увеличения/уменьшения текущего значения. Пользователь также может ввести значение вручную. Спин-бокс поддерживает целые значения, но может быть расширен для использования различных строк с помощью validate(), textFromValue() и valueFromText().

Каждый раз, когда значение изменяется, QSpinBox излучает два сигнала valueChanged(), один с целым значением и другой с QString. Перегрузка сигнала с QString предоставляет значение с префиксом prefix() и суффиксом suffix(). Текущее значение можно получить с помощью value() и установить с помощью setValue().

Нажатие кнопок вверх/вниз или использование клавиш ускорения вверх и вниз увеличит или уменьшит текущее значение на величину шага singleStep(). Если вам нужно изменить это поведение, вы можете переопределить виртуальную функцию stepBy(). Минимальное и максимальное значения, а также шаг могут быть установлены с помощью одного из конструкторов и изменены позже с помощью setMinimum(), setMaximum() и setSingleStep().

Большинство спин-боксов направлены, но QSpinBox также может работать как циклический спин-бокс, т. е. если диапазон составляет от 0 до 99, а текущее значение равно 99, нажатие «вверх» даст 0, если wrapping() установлено в true. Используйте setWrapping(), если вам нужно циклическое поведение.

Отображаемое значение может быть добавлено с помощью произвольных строк, например, валюты или единиц измерения. См. setPrefix() и setSuffix(). Текст в спин-боксе извлекается с помощью text() (который включает любой prefix() и suffix()), или с помощью cleanText() (который не имеет prefix(), не имеет suffix() и не имеет начального и конечного пробелов).

Часто желательно предоставить пользователю специальный (часто по умолчанию) выбор в дополнение к диапазону числовых значений. См. setSpecialValueText() для того, как это сделать с помощью QSpinBox.

	Поле ввода с шагом, отображаемое в стиле виджетов Windows Vista.
	Поле ввода с шагом, отображаемое в стиле виджетов Fusion.
	Поле ввода с шагом, отображаемое в стиле виджетов Macintosh.

Наследование от QSpinBox

Если использования prefix(), suffix() и specialValueText() недостаточно для управления, необходимо наследоваться от QSpinBox и переопределить valueFromText() и textFromValue(). Например, вот код для пользовательского поля ввода, позволяющего пользователю вводить размеры иконок (например, «32 х 32»):

int IconSizeSpinBox::valueFromText(const QString &text) const
{
    static const QRegularExpression regExp(tr("(\\d+)(\\s*[xx]\\s*\\d+)?"));
    Q_ASSERT(regExp.isValid());

    const QRegularExpressionMatch match = regExp.match(text);
    if (match.isValid())
        return match.captured(1).toInt();
    return 0;
}

QString IconSizeSpinBox::textFromValue(int value) const
{
    return tr("%1 x %1").arg(value);
}

См. пример Иконки для полного исходного кода.

См. также QDoubleSpinBox, QDateTimeEdit, QSlider и Пример полей ввода с шагом.

sb->setPrefix("$");

sb->setSuffix(" km");

Документация по членам-функциям

QSpinBox::QSpinBox(QWidget *parent = Q_NULLPTR)

Конструктор поля ввода с шагом, в котором минимальное значение равно 0, максимальное — 99, а значение шага — 1. Значение по умолчанию равно 0. Родительским элементом является parent.

См. также setMinimum(), setMaximum() и setSingleStep().

QSpinBox::~QSpinBox()

Деструктор.

[virtual protected] bool QSpinBox::event(QEvent *event)

Переопределено из QObject::event().

[virtual protected] void QSpinBox::fixup(QString &input) const

Переопределено из QAbstractSpinBox::fixup().

void QSpinBox::setRange(int minimum, int maximum)

Функция удобства для установки минимального и максимального значений с помощью одной функции.

setRange(minimum, maximum);

эквивалентно:

setMinimum(minimum);
setMaximum(maximum);

См. также minimum и maximum.

[virtual protected] QString QSpinBox::textFromValue(int value) const

Эта виртуальная функция используется спин-боксом всякий раз, когда ему нужно отобразить заданное значение value. По умолчанию реализация возвращает строку, содержащую value, напечатанное стандартным способом с помощью QWidget::locale().toString(), но с удаленным разделителем тысяч, если setGroupSeparatorShown() не задано. Переопределения могут возвращать что угодно. (См. пример в подробном описании.)

Примечание: QSpinBox не вызывает эту функцию для specialValueText(), и ни prefix(), ни suffix() не должны включаться в возвращаемое значение.

Если вы переопределите эту функцию, вам также может потребоваться переопределить valueFromText() и validate()

См. также valueFromText(), validate() и QLocale::groupSeparator().

[virtual protected] QValidator::State QSpinBox::validate(QString &text, int &pos) const

Переопределено из QAbstractSpinBox::validate().

[signal] void QSpinBox::valueChanged(int i)

Этот сигнал испускается всякий раз, когда значение спин-бокса изменяется. Новое значение в виде целого числа передаётся в i.

Примечание: Сигнал valueChanged перегружен в этом классе. Чтобы подключиться к нему с использованием синтаксиса указателя на функцию, необходимо указать тип сигнала в статическом преобразовании, как показано в этом примере:

connect(spinBox, static_cast<void(QSpinBox::*)(int)>(&QSpinBox::valueChanged),
    [=](int i){ /* ... */ });

Примечание: Сигнал уведомления для свойства value.

[signal] void QSpinBox::valueChanged(const QString &text)

Это перегруженная функция.

Новое значение передаётся в text с prefix() и suffix().

Примечание: Сигнал valueChanged перегружен в этом классе. Чтобы подключиться к нему с использованием синтаксиса указателя на функцию, необходимо указать тип сигнала в статическом преобразовании, как показано в этом примере:

connect(spinBox, static_cast<void(QSpinBox::*)(const QString &)>(&QSpinBox::valueChanged),
    [=](const QString &text){ /* ... */ });

Примечание: Сигнал уведомления для свойства value.

[virtual protected] int QSpinBox::valueFromText(const QString &text) const

Эта виртуальная функция используется спин-боксом всякий раз, когда ему необходимо интерпретировать text, введённое пользователем, как значение.

Подклассы, которым нужно отображать значения спин-бокса нечисловым способом, должны переопределить эту функцию.

Примечание: QSpinBox обрабатывает specialValueText() отдельно; эта функция связана только с другими значениями.

См. также textFromValue() и validate().