Тип QML ползунка

Предоставляет элемент управления ползунком вертикального или горизонтального типа. Подробнее...

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

Свойства

• activeFocusOnPress : bool
• hovered : bool
• maximumValue : real
• minimumValue : real
• orientation : int
• pressed : bool
• stepSize : real
• style : Component
• tickmarksEnabled : bool
• updateValueWhileDragging : bool
• value : real

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

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

Slider {
    value: 0.5
}

Значение ползунка по умолчанию находится в диапазоне [0, 1]. Если требуются целочисленные значения, можно установить свойство stepSize.

Можно создать пользовательский вид для ползунка, назначив стиль SliderStyle.

Документация свойств

activeFocusOnPress : bool

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

[только для чтения] hovered : bool

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

maximumValue : real

Это свойство содержит максимальное значение ползунка. Значение по умолчанию — 1.0.

minimumValue : real

Это свойство содержит минимальное значение ползунка. Значение по умолчанию — 0.0.

orientation : int

Это свойство содержит ориентацию макета ползунка. Значение по умолчанию — Qt.Horizontal.

[только для чтения] pressed : bool

Это свойство указывает, нажат ли ползунок.

stepSize : real

Это свойство указывает шаг ползунка.

Значение 0 указывает, что значение ползунка изменяется в непрерывном диапазоне между minimumValue и maximumValue.

Любое ненулевое значение указывает дискретный шаг stepSize. Следующий пример создаст ползунок с целочисленными значениями в диапазоне [0-5].

Slider {
    maximumValue: 5.0
    stepSize: 1.0
}

Значение по умолчанию — 0.0.

style : Component

Стиль Component для этого элемента управления.

См. также Типы QML Qt Quick Controls Styles.

tickmarksEnabled : bool

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

Значение по умолчанию — false.

Примечание: Это свойство может быть проигнорировано на некоторых платформах при использовании родного стиля (например, Android).

updateValueWhileDragging : bool

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

Значение по умолчанию — true.

value : real

Это свойство содержит текущее значение ползунка. Значение по умолчанию — 0.0.