Тип RangeSlider QML

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

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

Свойства

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

Методы

• void first.decrease()
• void first.increase()
• void second.decrease()
• void second.increase()
• void setValues(real firstValue, real secondValue)
• real valueAt(real 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 : real

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

from : real

Это свойство содержит начальное значение для диапазона. Значение по умолчанию — 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.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.

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

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.