Класс QAbstractSpinBox

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

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

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

Свойства

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

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

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

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

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

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

Сигналы

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

Статические публичные члены

• 5 статических публичных членов унаследованы от QWidget
• 9 статических публичных членов унаследованы от QObject

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

Переопределённые защищённые функции

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

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

• 1 защищённый слот унаследован от QWidget

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

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

[virtual] QAbstractSpinBox::~QAbstractSpinBox()

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

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

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

[virtual slot] void QAbstractSpinBox::clear()

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

[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

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

См. также 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)

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

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

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

См. также 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() и перематывание().

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