Класс QAbstractSpinBox

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

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

Типы

Свойства

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

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

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

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

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

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

Сигналы

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

См. также correctionMode.

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

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

    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 = Q_NULLPTR)

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

QAbstractSpinBox::~QAbstractSpinBox()

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

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

Переопределено из QWidget::changeEvent().

[virtual slot] void QAbstractSpinBox::clear()

Очищает поле ввода (lineEdit) от всего текста, кроме префикса и суффикса.

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

Переопределено из QWidget::closeEvent().

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

Переопределено из QWidget::contextMenuEvent().

[signal] void QAbstractSpinBox::editingFinished()

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

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

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

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

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

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

Переопределено из QWidget::focusInEvent().

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

Переопределено из QWidget::focusOutEvent().

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

Переопределено из QWidget::hideEvent().

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

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

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

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

Переопределено из QWidget::inputMethodQuery().

void QAbstractSpinBox::interpretText()

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

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

Переопределено из QWidget::keyPressEvent().

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

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

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

Переопределено из QWidget::keyReleaseEvent().

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

Возвращает указатель на поле ввода (lineEdit) спинбокса.

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

[virtual] QSize QAbstractSpinBox::minimumSizeHint() const

Переопределено из QWidget::minimumSizeHint().

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

Переопределено из QWidget::mouseMoveEvent().

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

Переопределено из QWidget::mousePressEvent().

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

Переопределено из QWidget::mouseReleaseEvent().

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

Переопределено из QWidget::paintEvent().

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

Переопределено из QWidget::resizeEvent().

[slot] void QAbstractSpinBox::selectAll()

Выбирает весь текст в спинбоксе, кроме префикса и суффикса.

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

Устанавливает поле ввода (lineEdit) спинбокса в lineEdit вместо текущего поля ввода. lineEdit не может быть нулевым.

QAbstractSpinBox принимает во владение новый lineEdit

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

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

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

Переопределено из QWidget::showEvent().

[virtual] QSize QAbstractSpinBox::sizeHint() const

Переопределено из QWidget::sizeHint().

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

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

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

[slot] void QAbstractSpinBox::stepDown()

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

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

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

Виртуальный метод, который определяет, разрешено ли выполнение шагов вверх и вниз в любой момент.

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

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

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

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

[slot] void QAbstractSpinBox::stepUp()

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

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

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

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

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

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

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

Переопределено из QWidget::wheelEvent().