Класс QDoubleSpinBox

Класс QDoubleSpinBox предоставляет виджет спин-бокса, принимающий значения типа double. Подробнее...

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

Свойства

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

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

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

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

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

• 4 общедоступных слота унаследованы от QAbstractSpinBox
• 19 общедоступных слотов унаследованы от QWidget
• 1 общедоступный слот унаследован от QObject

Сигналы

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

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

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

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

Класс QDoubleSpinBox предоставляет виджет спин-бокса, принимающий значения типа double.

QDoubleSpinBox позволяет пользователю выбирать значение, нажимая кнопки вверх и вниз или клавиши со стрелками вверх и вниз на клавиатуре для увеличения или уменьшения отображаемого значения. Пользователь также может ввести значение вручную. Спин-бокс поддерживает значения типа double, но может быть расширен для использования различных строк с помощью validate(), textFromValue() и valueFromText().

Каждый раз, когда значение изменяется, QDoubleSpinBox излучает два сигнала valueChanged(), один принимающий double, а другой — QString. Перегрузка с QString предоставляет значение с префиксом prefix() и суффиксом suffix(). Текущее значение можно получить с помощью value() и установить с помощью setValue().

Примечание: QDoubleSpinBox будет округлять числа, чтобы они могли быть отображены с текущей точностью. В QDoubleSpinBox с десятичными знаками, установленным в 2, вызов setValue(2.555) приведет к тому, что value() вернёт 2.56.

Нажатие кнопок вверх и вниз или использование клавиш со стрелками вверх и вниз на клавиатуре увеличит или уменьшит текущее значение на величину singleStep(). Если вы хотите изменить это поведение, вы можете переопределить виртуальную функцию stepBy(). Минимальное и максимальное значение и шаг могут быть установлены с помощью одного из конструкторов и изменены позже с помощью setMinimum(), setMaximum() и setSingleStep(). Спин-бокс имеет точность по умолчанию в 2 десятичных знака, но это можно изменить с помощью setDecimals().

Большинство спин-боксов имеют направление, но QDoubleSpinBox также может работать как циклический спин-бокс, т.е. если диапазон равен 0,0-99,9, а текущее значение равно 99,9, нажатие «вверх» даст 0, если wrapping() установлено в true. Используйте setWrapping(), если вам нужно циклическое поведение.

Отображаемое значение может быть дополнено и завершено произвольными строками, указывающими, например, валюту или единицу измерения. См. setPrefix() и setSuffix(). Текст в поле редактирования спин-бокса извлекается с помощью text() (который включает любой префикс() и суффикс()), или с помощью cleanText() (который не имеет префикса(), не имеет суффикса() и не имеет начальных или конечных пробелов).

Часто желательно предоставить пользователю специальный (часто по умолчанию) выбор в дополнение к диапазону числовых значений. См. setSpecialValueText() для того, как это сделать с помощью QDoubleSpinBox.

Примечание: Отображаемое значение QDoubleSpinBox ограничено 18 символами в дополнение к возможному префиксу и суффиксу. Это ограничение используется для поддержания удобства использования двойного спин-бокса даже с очень большими значениями.

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

spinbox->setPrefix("$");

spinbox->setSuffix(" km");

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

QDoubleSpinBox::QDoubleSpinBox(QWidget *parent = Q_NULLPTR)

Конструирует спин-бокс с минимальным значением 0.0 и максимальным значением 99.99, значением шага 1.0 и точностью 2 десятичных знака. Значение по умолчанию 0.00. Спин-бокс имеет заданного parent.

См. также setMinimum(), setMaximum() и setSingleStep().

QDoubleSpinBox::~QDoubleSpinBox()

Деструктор.

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

Переопределено из QAbstractSpinBox::fixup().

void QDoubleSpinBox::setRange(double minimum, double maximum)

Функция-утилита для установки минимального и максимального значений с помощью одной функции.

Примечание: Максимальные и минимальные значения будут округляться в соответствии со свойством decimals.

setRange(minimum, maximum);

эквивалентно:

setMinimum(minimum);
setMaximum(maximum);

См. также minimum и maximum.

[virtual] QString QDoubleSpinBox::textFromValue(double value) const

Эта виртуальная функция используется спинбоксом всякий раз, когда ему нужно отобразить заданное значение value. По умолчанию реализация возвращает строку, содержащую value, напечатанное с использованием QWidget::locale().toString(value, QLatin1Char('f'), decimals()) и удалит разделитель тысяч, если не установлено setGroupSeparatorShown(). Переопределения могут возвращать любые значения.

Примечание: QDoubleSpinBox не вызывает эту функцию для specialValueText(), и ни prefix(), ни suffix() не должны включаться в возвращаемое значение.

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

См. также valueFromText() и QLocale::groupSeparator().

[virtual] QValidator::State QDoubleSpinBox::validate(QString &text, int &pos) const

Переопределено из QAbstractSpinBox::validate().

[signal] void QDoubleSpinBox::valueChanged(double d)

Этот сигнал испускается всякий раз, когда изменяется значение спинбокса. Новое значение передаётся в d.

Примечание: Сигнал valueChanged перегружен в этом классе. Чтобы подключиться к этому сигналу с использованием синтаксиса указателя на функцию, необходимо указать тип сигнала в явном приведении, как показано в этом примере:

connect(doubleSpinBox, static_cast<void(QDoubleSpinBox::*)(double)>(&QDoubleSpinBox::valueChanged),
    [=](double d){ /* ... */ });

Примечание: Сигнал уведомления для свойства value.

[signal] void QDoubleSpinBox::valueChanged(const QString &text)

Это перегруженная функция.

Новое значение передаётся в text с prefix() и suffix().

Примечание: Сигнал valueChanged перегружен в этом классе. Чтобы подключиться к этому сигналу с использованием синтаксиса указателя на функцию, необходимо указать тип сигнала в явном приведении, как показано в этом примере:

connect(doubleSpinBox, static_cast<void(QDoubleSpinBox::*)(const QString &)>(&QDoubleSpinBox::valueChanged),
    [=](const QString &text){ /* ... */ });

Примечание: Сигнал уведомления для свойства value.

[virtual] double QDoubleSpinBox::valueFromText(const QString &text) const

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

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

Примечание: QDoubleSpinBox обрабатывает specialValueText() отдельно; эта функция занимается только другими значениями.

См. также textFromValue() и validate().