Тип RangeSlider QML

Используется для выбора диапазона значений, перемещая две ручки по направляющей. Подробнее...

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

Свойства

• first
  • first.value : real
  • first.position : real
  • first.visualPosition : real
  • first.handle : Item
  • first.pressed : bool
  • first.hovered : bool
• from : real
• live : bool
• orientation : перечисление
• second
  • second.value : real
  • second.position : real
  • second.visualPosition : real
  • second.handle : Item
  • second.pressed : bool
  • second.hovered : bool
• snapMode : перечисление
• stepSize : real
• to : real

Методы

• void first.decrease()
• void first.increase()
• void second.decrease()
• void second.increase()
• void setValues(real firstValue, real secondValue)

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

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

В примере ниже устанавливаются пользовательские значения from и to, а также начальные позиции ручек first и second:

RangeSlider {
    from: 1
    to: 100
    first.value: 25
    second.value: 75
}

Для выполнения действия при изменении значения конкретной ручки используйте следующий синтаксис:

first.onValueChanged: console.log("first.value changed to " + first.value)

Свойства first.position и second.position выражаются как доли размера элемента управления, в диапазоне 0.0 - 1.0. Свойства first.visualPosition и second.visualPosition аналогичны, за исключением того, что они меняют порядок в приложениях с направлением справа налево. visualPosition полезно для позиционирования ручек при стилизации RangeSlider. В приведенном выше примере first.visualPosition будет 0.24 в приложениях с направлением слева направо и 0.76 в приложениях с направлением справа налево.

См. также Настройка RangeSlider и Элементы управления вводом.

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

first.value : real

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

from : real

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

См. также to, first.value и second.value.

live : bool

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

Значение по умолчанию — true.

Это свойство QML было добавлено в QtQuick.Controls 2.2 (Qt 5.9).

См. также first.value и second.value.

orientation : перечисление

Это свойство содержит значение ориентации.

Возможные значения:

second.value : real

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

snapMode : перечисление

Это свойство содержит режим привязки.

Возможные значения:

Для визуального объяснения различных режимов см. документацию snapMode для Slider.

См. также stepSize.

stepSize : вещественное

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

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

to : вещественное

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

См. также from, first.value и second.value.

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

void first.decrease()

Уменьшает значение ползунка на stepSize, или на 0.1 если stepSize не определено.

См. также first.

void first.increase()

Увеличивает значение ползунка на stepSize, или на 0.1 если stepSize не определено.

См. также first.

void second.decrease()

Уменьшает значение ползунка на stepSize, или на 0.1 если stepSize не определено.

См. также second.

void second.increase()

Увеличивает значение ползунка на stepSize, или на 0.1 если stepSize не определено.

См. также second.

void setValues(вещественное firstValue, вещественное secondValue)

Устанавливает first.value и second.value заданными значениями.

Если to больше, чем from, и firstValue больше, чем secondValue, firstValue будет ограничено значением secondValue.

Если from больше, чем to, и secondValue больше, чем firstValue, secondValue будет ограничено значением firstValue.

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

См. также stepSize.