Тип 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(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(position)

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

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

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