Тип QML RangeSlider

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

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

Свойства

• 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 : Item

См. также 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.

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