Класс QAbstractSpinBox

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

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

Открытые типы

Свойства

• 59 свойств, унаследованных от QWidget
• 1 свойство, унаследованное от QObject

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

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

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

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

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

Сигналы

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

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

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

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

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

• 1 публичная переменная унаследованная от QObject
• 5 статические публичные члены унаследованные от QWidget
• 10 статических публичных членов унаследованных от QObject
• 1 защищённый слот унаследованный от QWidget
• 2 защищённых переменных унаследованных от QObject
• 1 защищённый тип унаследованный от QPaintDevice

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

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

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

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

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

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

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

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

См. также correctionMode.

Перечисление QAbstractSpinBox::StepEnabledFlagflags QAbstractSpinBox::StepEnabled

Тип StepEnabled — это псевдоним для QFlags<StepEnabledFlag>. Он хранит комбинацию значений StepEnabledFlag, объединённых операцией OR.

    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 и выравнивания.

[virtual] QAbstractSpinBox::~QAbstractSpinBox()

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

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

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

[virtual slot] void QAbstractSpinBox::clear()

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

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

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

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

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

[signal] void QAbstractSpinBox::editingFinished()

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

void QAbstractSpinBox::interpretText()

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

[slot] void QAbstractSpinBox::selectAll()

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

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

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

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

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

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

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

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

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

[slot] void QAbstractSpinBox::stepDown()

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

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

[virtual protected] QAbstractSpinBox::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().

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

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

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

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

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

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