Тип 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(firstValue, real secondValue)
• real 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 : Item

См. также first.moved(), 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.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 : логический

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

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

См. также orientation.

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

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

Данная документация была добавлена в 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.