Тип 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.

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

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

from : real

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

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

handle : Item

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

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

[только для чтения, начиная с QtQuick.Controls 2.3 (Qt 5.10)] horizontal : bool

Это свойство содержит информацию о том, является ли слайдер горизонтальным.

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

См. также orientation.

[только для чтения, начиная с QtQuick.Controls 2.5 (Qt 5.12)] implicitHandleHeight : real

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

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

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

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

См. также implicitHandleWidth.

[только для чтения, начиная с QtQuick.Controls 2.5 (Qt 5.12)] implicitHandleWidth : real

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

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

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

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

См. также implicitHandleHeight.

[начиная с QtQuick.Controls 2.2 (Qt 5.9)] live : bool

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

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

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

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

orientation : enumeration

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

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

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

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

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

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

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

pressed : bool

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

snapMode : enumeration

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

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

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

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

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

См. также stepSize.

stepSize : вещественное

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

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

to : вещественное

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

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

[с QtQuick.Controls 2.5 (Qt 5.12)] touchDragThreshold : qreal

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

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

См. также QStyleHints.

value : вещественное

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

См. также position.

[только для чтения, с QtQuick.Controls 2.3 (Qt 5.10)] vertical : логическое

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

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

См. также orientation.

[только для чтения] visualPosition : вещественное

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

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

См. также position.

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

[since QtQuick.Controls 2.2 (Qt 5.9)] moved()

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

Примечание: Соответствующая обработчик — onMoved.

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

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

void decrease()

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

См. также stepSize.

void increase()

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

См. также stepSize.

[since QtQuick.Controls 2.1 (Qt 5.8)] вещественное valueAt(вещественное position)

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

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

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