Тип SpinBox QML

Элемент управления спинбоксом. Подробнее...

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

Свойства

• down
  • down.pressed : bool
  • down.indicator : Item
• from : int
• stepSize : int
• textFromValue : функция
• to : int
• up
  • up.pressed : bool
  • up.indicator : Item
• validator : Validator
• value : int
• valueFromText : функция

Методы

• void decrease()
• void increase()

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

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

По умолчанию, SpinBox предоставляет дискретные значения в диапазоне [0-99] с stepSize в 1.

SpinBox {
    value: 50
}

Пользовательские значения

Несмотря на то, что SpinBox работает с целыми числами, его можно настроить для приема произвольных значений. Следующий фрагмент кода демонстрирует, как можно использовать validator, textFromValue и valueFromText для настройки стандартного поведения.

SpinBox {
    from: 0
    to: items.length - 1
    value: 1 // "Medium"

    property var items: ["Small", "Medium", "Large"]

    validator: RegExpValidator {
        regExp: new RegExp("(Small|Medium|Large)", "i")
    }

    textFromValue: function(value) {
        return items[value];
    }

    valueFromText: function(text) {
        for (var i = 0; i < items.length; ++i) {
            if (items[i].toLowerCase().indexOf(text.toLowerCase()) === 0)
                return i
        }
        return sb.value
    }
}

Примечание: Типы в модуле Qt.labs не гарантируют сохранение совместимости в будущих версиях.

См. также Tumbler и Настройка SpinBox.

Документация по свойствам

down.pressed : bool

Эти свойства содержат элемент индикатора вниз и значение, указывающее, нажат ли он.

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

from : int

Это свойство содержит начальное значение диапазона. Значение по умолчанию — 0.

См. также to и value.

stepSize : int

Это свойство содержит размер шага. Значение по умолчанию — 1.

См. также increase() и decrease().

textFromValue : функция

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

Подпись функции обратного вызова: string function(value, locale). Функция может иметь один или два аргумента, где первый аргумент — значение, подлежащее преобразованию, а необязательный второй аргумент — область, которая должна использоваться для преобразования, если применимо.

Стандартная реализация выполняет преобразование с помощью Number.toLocaleString():

textFromValue: function(value, locale) { return Number(value).toLocaleString(locale, 'f', 0); }

См. также valueFromText, validator и locale.

to : int

Это свойство содержит конечное значение диапазона. Значение по умолчанию — 99.

См. также from и value.

up.pressed : bool

Эти свойства содержат элемент индикатора вверх и значение, указывающее, нажат ли он.

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

validator : Validator

Это свойство содержит валидатор текста ввода. По умолчанию, SpinBox использует IntValidator для приема ввода целых чисел.

validator: IntValidator {
    locale: control.locale.name
    bottom: Math.min(control.from, control.to)
    top: Math.max(control.from, control.to)
}

См. также textFromValue, valueFromText и locale.

value : int

Это свойство содержит значение в диапазоне from - to. Значение по умолчанию — 0.

valueFromText : функция

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

Подпись функции обратного вызова: int function(text, locale). Функция может иметь один или два аргумента, где первый аргумент — текст, подлежащий преобразованию, а необязательный второй аргумент — область, которая должна использоваться для преобразования, если применимо.

Стандартная реализация выполняет преобразование с помощью Number.fromLocaleString():

valueFromText: function(text, locale) { return Number.fromLocaleString(locale, text); }

См. также textFromValue, validator и locale.

Документация по методам

void decrease()

Уменьшает значение на stepSize.

См. также stepSize.

void increase()

Увеличивает значение на stepSize.

См. также stepSize.