Тип QML Slider

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

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

Свойства

• from : real
• handle : Item
• horizontal : bool
• implicitHandleHeight : real
• implicitHandleWidth : real
• live : bool
• orientation : enumeration
• position : real
• pressed : bool
• snapMode : enumeration
• 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 : 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 : 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()

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

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

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