Тип QML RangeSlider

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

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

Свойства

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

Методы

• void first.decrease()
• void first.increase()
• void first.moved()
• void second.decrease()
• void second.increase()
• void second.moved()
• 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 2.

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

first.value : вещественное

См. также 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 : перечисление

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

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

См. также horizontal и vertical.

second.value : вещественное

См. также 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 : булево

Это свойство содержит информацию о том, является ли слайдер вертикальным.

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

См. также orientation.

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

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

Эта документация была добавлена в QtQuick.Controls 2.5.

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

пусто first.decrease()

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

См. также first.

пусто first.increase()

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

См. также first.

пусто second.decrease()

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

См. также second.

пусто second.increase()

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

См. также second.

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

Устанавливает first.value и second.value с указанными аргументами.

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

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

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

См. также stepSize.

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

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

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

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