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

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

См. также Настройка ползунка.

[только для чтения, начиная с 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 : перечисление

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

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

См. также 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 : вещественное

Это свойство содержит размер шага. Значение по умолчанию равно 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 : bool

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

Это свойство было введено в 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.