QML-тип Slider

Горизонтальный ползунок. Подробнее...

Строка импорта: import Sailfish.Silica 1.0
Наследуется от: MouseArea

Свойства

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

Тип Slider реализует горизонтальный ползунок.

С помощью ползунка (элемента управления, передвигаемого на экране вдоль линии) пользователь может указывать конкретное значение в пределах допустимого диапазона.

Ниже приведен простого ползунка:

 import Sailfish.Silica 1.0

 Slider {
     width: parent.width
     minimumValue: 100
     maximumValue: 200
     value: 150
 }

Тип Slider можно также использовать в качестве индикатора выполнения некоего процесса. Для этого свойство enabled следует установить в значение false, чтобы блокировать пользовательский ввод.

Slider наследуется от типа QtQuick MouseArea. Поэтому свойства, методы и сигналы MouseArea также доступны для объектов Slider. Полный список доступных свойств, сигналов и методов приведен в документации MouseArea.

Описание свойств

animateValue : bool

Установка значения свойства animateValue в false отключает анимацию изменения значений ползунка.

down : bool

Истинно, если ползунок нажат.

enabled : bool

При значении true (по умолчанию) пользователь может взаимодействовать с элементом Slider путем касания и перемещения ползунка.

При значении false пользователь не может взаимодействовать с элементом Slider. Такое поведение уместно для ползунков, которые являются индикаторами выполнения и не подразумевают взаимодействие с пользователем.

handleVisible : bool

При истинном значении (по умолчанию) ползунок отображается в положении текущего значения. В противном случает ползунок не отображается, вместо него отображается лишь полоса, обозначающая текущее значение.

highlighted : bool

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

label : string

Текстовая метка, которая отображается под ползунком. Этот текст обычно описывает назначение конкретного элемента Slider.

См. также valueText.

maximumValue : real

Минимальное значение ползунка (по умолчанию: 1.0).

minimumValue : real

Минимальное значение ползунка (по умолчанию: 0.0).

[read-only] sliderValue : real

Значение текущего положения в анимации ползунка (между максимальным и минимальным значениями).

См. также value.

stepSize : real

Значение приращения, которое используется для увеличения/уменьшения значений ползунка. Значение свойства stepSize равное 0 (по умолчанию) позволяет задавать значение свойства value с произвольным шагом.

Приращения значений ползунка с помощью stepSize выполняются относительно свойства minimumValue. Например значение stepSize равное 0.5 и значение minimumValue равное 0.25 приведут к последовательности значений ползунка 0.25, 0.75, 1.25, ...

Обратите внимание, что это свойство ограничивает задание значений ползунка только лишь в визуальном режиме. Это свойство не ограничивает задание значений ползунка с помощью свойства value.

value : real

Текущее значение ползунка.

Значение этого свойства можно устанавливать вне границ допустимого диапазона, однако свойство sliderValue всегда будет принимать допустимые значения.

См. также sliderValue.

valueText : string

Текст, который отображается над текущим положением в анимации ползунка. Обычно в это свойство передается текущее значение ползунка.

 import Sailfish.Silica 1.0

 Slider {
     minimumValue: 100
     maximumValue: 200
     value: 150
     valueText: "$" + value
 }

См. также label.