Класс 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 и Пример Spin Boxes.

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

перечисление QAbstractSpinBox::ButtonSymbols

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

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

перечисление QAbstractSpinBox::CorrectionMode

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

См. также correctionMode.

перечисление флагов QAbstractSpinBox::StepEnabledFlag QAbstractSpinBox::StepEnabled

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

перечисление 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 со свойствами wrapping и alignment по умолчанию.

[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).

[virtual 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).