Тип RangeSlider QML

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

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

Свойства

• first
  • first.value : real
  • first.position : real
  • first.visualPosition : real
  • first.handle : Item
  • first.pressed : bool
  • first.hovered : bool
• 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
• snapMode : перечисление
• stepSize : real
• to : real
• vertical : bool

Методы

• void first.decrease()
• void first.increase()
• void second.decrease()
• void second.increase()
• void setValues(real firstValue, real secondValue)

Подробное описание

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

В приведенном ниже примере задаются пользовательские значения from и to, и задаются начальные позиции ползунков first и second:

RangeSlider {
    from: 1
    to: 100
    first.value: 25
    second.value: 75
}

Для выполнения действия при изменении значения для конкретного ползунка используйте следующий синтаксис:

first.onValueChanged: 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 : real

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

[только для чтения] 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.

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

См. также stepSize.