Класс QAbstractSpinBox

Класс QAbstractSpinBox предоставляет спинбокс и поле ввода для отображения значений. Подробнее...

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

Публичные типы

Свойства

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

Переопределённые открытые функции

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

Сигналы

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

Реализованные защищённые функции

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

Класс разработан как общий базовый класс для виджетов, таких как QSpinBox, QDoubleSpinBox и QDateTimeEdit

Вот основные свойства класса:

1. text: Текст, отображаемый в QAbstractSpinBox.
2. alignment: Выравнивание текста в QAbstractSpinBox.
3. wrapping: Определяет, обёртывается ли QAbstractSpinBox от минимального значения к максимальному и наоборот.

QAbstractSpinBox предоставляет виртуальную функцию stepBy(), которая вызывается всякий раз, когда пользователь выполняет шаг. Эта функция принимает целое значение, указывающее, сколько шагов было сделано. Например, нажатие Qt::Key_Down вызовет stepBy(-1).

Когда пользователь выполняет шаг, удерживая клавишу Qt::ControlModifier, QAbstractSpinBox выполняет шаг на 10 единиц вместо одного. Этот модификатор шага влияет на события колёсика мыши, события нажатия клавиш и взаимодействие с кнопками спинбокса. Обратите внимание, что на macOS клавиша Control соответствует клавише Command.

Начиная с Qt 5.12, QStyle::SH_SpinBox_StepModifier может быть использован для выбора Qt::KeyboardModifier, увеличивающего скорость шага. Qt::NoModifier отключает эту функцию.

QAbstractSpinBox также предоставляет виртуальную функцию stepEnabled() для определения, разрешено ли выполнение шагов вверх/вниз в любой момент. Эта функция возвращает битовую комбинацию StepEnabled.

См. также QAbstractSlider, QSpinBox, QDoubleSpinBox, QDateTimeEdit и Пример спинбоксов.

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

enum QAbstractSpinBox::ButtonSymbols

Этот перечисление описывает символы, которые могут быть отображены на кнопках в спинбоксе.

См. также QAbstractSpinBox::buttonSymbols.

enum QAbstractSpinBox::CorrectionMode

Этот тип перечисления описывает режим, который спинбокс будет использовать для исправления значения Intermediate, если редактирование завершено.

См. также correctionMode.

enum QAbstractSpinBox::StepEnabledFlagflags QAbstractSpinBox::StepEnabled

Тип StepEnabled является псевдонимом для QFlags<StepEnabledFlag>. Он хранит логическое ИЛИ сочетание значений StepEnabledFlag.

enum QAbstractSpinBox::StepType

    QSpinBox *zoomSpinBox = new QSpinBox;
    zoomSpinBox->setRange(0, 1000);
    zoomSpinBox->setSingleStep(10);
    zoomSpinBox->setSuffix("%");
    zoomSpinBox->setSpecialValueText(tr("Automatic"));
    zoomSpinBox->setValue(100);

QSpinBox *spinBox = new QSpinBox(this);
spinBox->setRange(0, 100);
spinBox->setWrapping(true);
spinBox->setValue(100);
spinBox->stepBy(1);
// value is 0

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

QAbstractSpinBox::QAbstractSpinBox(QWidget *parent = nullptr)

Создаёт абстрактный спинбокс с заданным parent с свойствами переноса и выравнивания по умолчанию.

[virtual slot] void QAbstractSpinBox::clear()

Очищает lineedit от всего текста, кроме префикса и суффикса.

[signal] void QAbstractSpinBox::editingFinished()

Этот сигнал испускается при завершении редактирования. Это происходит, когда спинбокс теряет фокус и когда нажата клавиша Enter.

[slot] void QAbstractSpinBox::selectAll()

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

[slot] void QAbstractSpinBox::stepDown()

Уменьшает значение на одну строку. Вызов этого слота аналогичен вызову stepBy(-1);

См. также stepBy() и stepUp().

[slot] void QAbstractSpinBox::stepUp()

Увеличивает значение на одну строку. Вызов этого слота аналогичен вызову stepBy(1);

См. также stepBy() и stepDown().

[virtual] QAbstractSpinBox::~QAbstractSpinBox()

Вызывается при уничтожении QAbstractSpinBox.

[override virtual protected] void QAbstractSpinBox::changeEvent(QEvent *event)

Переопределяет: QWidget::changeEvent(QEvent *event).

[override virtual protected] void QAbstractSpinBox::closeEvent(QCloseEvent *event)

Переопределяет: QWidget::closeEvent(QCloseEvent *event).

[override virtual protected] void QAbstractSpinBox::contextMenuEvent(QContextMenuEvent *event)

Переопределяет: QWidget::contextMenuEvent(QContextMenuEvent *event).

[override virtual] bool QAbstractSpinBox::event(QEvent *event)

Переопределяет: QWidget::event(QEvent *event).

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

Этот виртуальный метод вызывается QAbstractSpinBox, если input не валидируется в QValidator::Acceptable при нажатии Return или вызове interpretText(). Он попытается изменить текст, чтобы он стал валидным. Переопределяется в различных подклассах.

[override virtual protected] void QAbstractSpinBox::focusInEvent(QFocusEvent *event)

Переопределяет: QWidget::focusInEvent(QFocusEvent *event).

[override virtual protected] void QAbstractSpinBox::focusOutEvent(QFocusEvent *event)

Переопределяет: QWidget::focusOutEvent(QFocusEvent *event).

[override virtual protected] void QAbstractSpinBox::hideEvent(QHideEvent *event)

Переопределяет: QWidget::hideEvent(QHideEvent *event).

[protected] void QAbstractSpinBox::initStyleOption(QStyleOptionSpinBox *option) const

Инициализирует option значениями из этого QSpinBox. Этот метод полезен для подклассов, когда им нужен QStyleOptionSpinBox, но они не хотят сами заполнять всю информацию.

См. также QStyleOption::initFrom().

[override virtual] QVariant QAbstractSpinBox::inputMethodQuery(Qt::InputMethodQuery query) const

Переопределяет: QWidget::inputMethodQuery(Qt::InputMethodQuery query) const.

void QAbstractSpinBox::interpretText()

Этот метод интерпретирует текст спинбокса. Если значение изменилось с момента последней интерпретации, он будет испускать сигналы.

[override virtual protected] void QAbstractSpinBox::keyPressEvent(QKeyEvent *event)

Переопределяет: QWidget::keyPressEvent(QKeyEvent *event).

Этот метод обрабатывает ввод с клавиатуры.

Следующие клавиши обрабатываются специально:

См. также stepBy().

[override virtual protected] void QAbstractSpinBox::keyReleaseEvent(QKeyEvent *event)

Переопределяет: QWidget::keyReleaseEvent(QKeyEvent *event).

[protected] QLineEdit *QAbstractSpinBox::lineEdit() const

Этот метод возвращает указатель на line edit спинбокса.

См. также setLineEdit().

[override virtual] QSize QAbstractSpinBox::minimumSizeHint() const

Переопределяет функцию доступа к свойству: QWidget::minimumSizeHint.

[override virtual protected] void QAbstractSpinBox::mouseMoveEvent(QMouseEvent *event)

Переопределяет: QWidget::mouseMoveEvent(QMouseEvent *event).

[override virtual protected] void QAbstractSpinBox::mousePressEvent(QMouseEvent *event)

Переопределяет: QWidget::mousePressEvent(QMouseEvent *event).

[override virtual protected] void QAbstractSpinBox::mouseReleaseEvent(QMouseEvent *event)

Переопределяет: QWidget::mouseReleaseEvent(QMouseEvent *event).

[override virtual protected] void QAbstractSpinBox::paintEvent(QPaintEvent *event)

Переопределяет: QWidget::paintEvent(QPaintEvent *event).

[override virtual protected] void QAbstractSpinBox::resizeEvent(QResizeEvent *event)

Переопределяет: QWidget::resizeEvent(QResizeEvent *event).

[protected] void QAbstractSpinBox::setLineEdit(QLineEdit *lineEdit)

Устанавливает line edit спинбокса на lineEdit вместо текущего line edit виджета. lineEdit не может быть nullptr.
QAbstractSpinBox принимает во владение новый lineEdit

Если QLineEdit::validator() для lineEdit возвращает nullptr, внутренний валидатор спинбокса будет установлен на line edit.

См. также lineEdit().

[override virtual protected] void QAbstractSpinBox::showEvent(QShowEvent *event)

Переопределяет: QWidget::showEvent(QShowEvent *event).

[override virtual] QSize QAbstractSpinBox::sizeHint() const

Переопределяет функцию доступа к свойству: QWidget::sizeHint.

[virtual] void QAbstractSpinBox::stepBy(int steps)

Виртуальный метод, вызываемый всякий раз, когда пользователь активирует шаг. Параметр steps указывает, сколько шагов было сделано. Например, нажатие Qt::Key_Down вызовет вызов stepBy(-1), а нажатие Qt::Key_PageUp вызовет вызов stepBy(10).

Если вы наследуете класс QAbstractSpinBox, вы должны переопределить эту функцию. Обратите внимание, что эта функция вызывается даже если результирующее значение окажется вне границ минимального и максимального значений. Именно эта функция должна обрабатывать такие ситуации.

См. также stepUp(), stepDown() и keyPressEvent().

[virtual protected] QAbstractSpinBox::StepEnabled QAbstractSpinBox::stepEnabled() const

Виртуальная функция, определяющая, разрешены ли операции увеличения и уменьшения в данный момент.

Стрелка вверх будет отображаться как отключенная, если (stepEnabled() & StepUpEnabled) != 0.

Реализация по умолчанию вернет (StepUpEnabled | StepDownEnabled), если включено циклическое изменение значений. В противном случае она вернет StepDownEnabled, если значение больше, чем minimum(), или StepUpEnabled, если значение меньше, чем maximum().

Если вы наследуете класс QAbstractSpinBox, вам потребуется переопределить эту функцию.

См. также QSpinBox::minimum(), QSpinBox::maximum() и wrapping().

[override virtual protected] void QAbstractSpinBox::timerEvent(QTimerEvent *event)

Переопределяет: QObject::timerEvent(QTimerEvent *event).

[virtual] QValidator::State QAbstractSpinBox::validate(QString &input, int &pos) const

Эта виртуальная функция вызывается классом QAbstractSpinBox для определения, является ли input допустимым. Параметр pos указывает позицию в строке. Переопределено в различных подклассах.

[override virtual protected] void QAbstractSpinBox::wheelEvent(QWheelEvent *event)

Переопределяет: QWidget::wheelEvent(QWheelEvent *event).