Тип QML RangeSlider

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

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

Свойства

• first
  • first.handle : Элемент
  • 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 : Элемент
  • 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 : перечисление

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

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

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

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

Эта функция может потребоваться для установки начальных и конечных значений после завершения элемента управления, поскольку существует циклическая зависимость между 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.