Тип RangeSlider QML

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

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

Свойства

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

Сигналы

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

Методы

• 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.

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

first.handle : Item

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

from : real

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

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

[только для чтения, начиная с QtQuick.Controls 2.3 (Qt 5.10)] horizontal : bool

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

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

См. также orientation.

[начиная с QtQuick.Controls 2.2 (Qt 5.9)] live : bool

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

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

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

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

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

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

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

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

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.

[с QtQuick.Controls 2.5 (Qt 5.12)] touchDragThreshold : qreal

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

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

См. также QStyleHints.

[только для чтения, с QtQuick.Controls 2.3 (Qt 5.10)] vertical : булево

Это свойство показывает, является ли слайдер вертикальным.

Это свойство было добавлено в 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.

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

См. также stepSize.

[since QtQuick.Controls 2.5 (Qt 5.12)] вещественное valueAt(вещественное position)

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

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

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