Тип RangeSlider QML

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

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

Свойства

• first
  • first.handle : Элемент
  • first.hovered : bool
  • first.implicitHandleHeight : вещественное
  • first.implicitHandleWidth : вещественное
  • first.position : вещественное
  • first.pressed : bool
  • first.value : вещественное
  • first.visualPosition : вещественное
• from : вещественное
• horizontal : bool
• live : bool
• orientation : перечисление
• second
  • second.handle : Элемент
  • second.hovered : bool
  • second.implicitHandleHeight : вещественное
  • second.implicitHandleWidth : вещественное
  • second.position : вещественное
  • second.pressed : bool
  • second.value : вещественное
  • second.visualPosition : вещественное
• snapMode : перечисление
• stepSize : вещественное
• to : вещественное
• touchDragThreshold : qreal
• vertical : bool

Сигналы

• void first.moved()
• void second.moved()

Методы

• void first.decrease()
• void first.increase()
• void second.decrease()
• void second.increase()
• void setValues(вещественное firstValue, вещественное secondValue)
• вещественное valueAt(вещественное position)

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

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

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

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

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

first.onMoved: 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 в приложениях с расположением справа налево.

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

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

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

first.handle : Элемент

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

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

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

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

[только для чтения] horizontal : bool

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

Это свойство было добавлено в QtQuick.Controls 2.3 (Qt 5.10).

См. также orientation.

live : bool

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

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

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

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

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

Это свойство хранит ориентацию.

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

См. также горизонталь и вертикаль.

second.handle : Элемент

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

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

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

Режим привязки определяет, как элементы управления ползунком ведут себя относительно stepSize.

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

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

См. также stepSize.

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

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

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

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

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

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

touchDragThreshold : qreal

Это свойство хранит порог (в логических пикселях), при котором будет инициировано событие перетаскивания касанием. Порог перетаскивания мышью не повлияет. Значение по умолчанию — Qt.styleHints.startDragDistance.

Это свойство было введено в QtQuick.Controls 2.5 (Qt 5.12).

См. также QStyleHints.

[только для чтения] vertical : bool

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

Это свойство было введено в QtQuick.Controls 2.3 (Qt 5.10).

См. также orientation.

Документация по сигналам

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

Этот QML-сигнал был введен в QtQuick.Controls 2.5.

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

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

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.

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

См. также stepSize.

вещественное valueAt(вещественное position)

Возвращает значение для данного position.

Этот метод был введен в QtQuick.Controls 2.5 (Qt 5.12).

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