Класс QSpinBox

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

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

Свойства

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

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

• 30 открытых функций унаследовано от QAbstractSpinBox
• 214 открытых функций унаследовано от QWidget
• 32 открытых функции унаследовано от 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(), один с int, а другой с 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.

Наследование 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()

Деструктор.

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

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

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

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

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

Функция-обёртка для установки minimum и 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().

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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