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