QML-тип Slider

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

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

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

Свойства

animateValue : bool
down : bool
enabled : bool
handleVisible : bool
highlighted : bool
label : string
maximumValue : real
minimumValue : real
sliderValue : real
stepSize : real
value : real
valueText : string

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

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

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

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

import Sailfish.Silica 1.0

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

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

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

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

animateValue : bool

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

down : bool

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

enabled : bool

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

При ложном значении пользователь не может взаимодействовать с элементом 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.