Тип QML Slider

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

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

Свойства

• from : real
• handle : Item
• horizontal : bool
• implicitHandleHeight : real
• implicitHandleWidth : real
• live : bool
• orientation : перечисление
• position : real
• pressed : bool
• snapMode : перечисление
• stepSize : real
• to : real
• touchDragThreshold : qreal
• value : real
• vertical : bool
• visualPosition : real

Сигналы

• moved()

Методы

• void decrease()
• void increase()
• real valueAt(real position)

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

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

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

Slider {
    from: 1
    value: 25
    to: 100
}

Свойство position выражается как дробь от размера элемента управления, в диапазоне 0.0 - 1.0. Свойство visualPosition такое же, но инвертировано в приложениях с направлением «справа налево». Свойство visualPosition полезно для позиционирования ползунка при стилизации Slider. В примере выше visualPosition будет 0.24 в приложениях с направлением «слева направо» и 0.76 в приложениях с направлением «справа налево».

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

См. также Настройка слайдера и Элементы управления вводом.

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

from : real

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

См. также to и value.

handle : Item

Это свойство содержит элемент ползунка.

См. также Настройка слайдера.

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

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

Это свойство было добавлено в QtQuick.Controls 2.3 (Qt 5.10).

См. также orientation.

[только для чтения] implicitHandleHeight : real

Это свойство содержит неявную высоту ползунка.

Значение равно handle ? handle.implicitHeight : 0.

Обычно используется вместе с implicitContentHeight и implicitBackgroundHeight для расчета implicitHeight.

Это свойство было добавлено в QtQuick.Controls 2.5 (Qt 5.12).

См. также implicitHandleWidth.

[только для чтения] implicitHandleWidth : real

Это свойство содержит неявную ширину ползунка.

Значение равно handle ? handle.implicitWidth : 0.

Обычно используется вместе с implicitContentWidth и implicitBackgroundWidth для расчета implicitWidth.

Это свойство было добавлено в QtQuick.Controls 2.5 (Qt 5.12).

См. также implicitHandleHeight.

live : bool

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

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

Это свойство было добавлено в QtQuick.Controls 2.2 (Qt 5.9).

См. также value и valueAt().

orientation : перечисление

Это свойство содержит ориентацию.

Возможные значения:

См. также horizontal и vertical.

[только для чтения] position : real

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

Положение выражается как дробь от размера элемента управления, в диапазоне 0.0 - 1.0. Для визуализации слайдера следует использовать свойство visualPosition, которое учитывает направление «справа налево».

См. также value, visualPosition и valueAt().

pressed : bool

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

snapMode : перечисление

Это свойство содержит режим привязки.

Режим привязки определяет поведение ползунка относительно stepSize.

Возможные значения:

В следующей таблице показаны различные режимы с анимациями. Движение курсора мыши и stepSize (0.2) идентичны в каждой анимации.

Значение	Пример
Slider.NoSnap
Slider.SnapAlways
Slider.SnapOnRelease

См. также stepSize.

stepSize : real

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

См. также snapMode, increase() и decrease().

to : real

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

См. также from и value.

touchDragThreshold : qreal

Это свойство содержит порог (в логических пикселях), при котором будет инициировано событие перетаскивания касанием. Порог перетаскивания мышью не будет затронут. Значение по умолчанию — Qt.styleHints.startDragDistance.

Это свойство было добавлено в QtQuick.Controls 2.5 (Qt 5.12).

См. также QStyleHints.

value : real

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

См. также position.

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

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

Это свойство было добавлено в QtQuick.Controls 2.3 (Qt 5.10).

См. также orientation.

[только для чтения] visualPosition : real

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

Положение выражается как дробь от размера элемента управления в диапазоне 0.0 - 1.0. Если элемент управления отражён, значение равно 1.0 - position. Это делает значение подходящим для визуализации ползунка, учитывая поддержку справа налево.

См. также position.

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

moved()

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

Этот сигнал был добавлен в QtQuick.Controls 2.2 (Qt 5.9).

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

void decrease()

Уменьшает значение на stepSize или 0.1 , если stepSize не определено.

См. также stepSize.

void increase()

Увеличивает значение на stepSize или 0.1 , если stepSize не определено.

См. также stepSize.

real valueAt(real position)

Возвращает значение для данного position.

Этот метод был добавлен в QtQuick.Controls 2.1 (Qt 5.8).

См. также value и position.