Тип QML Slider

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

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

Свойства

• from : real
• handle : Item
• live : bool
• orientation : перечисление
• position : real
• pressed : bool
• snapMode : перечисление
• stepSize : real
• to : real
• value : real
• visualPosition : real

Сигналы

• void 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 в приложениях справа налево.

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

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

from : real

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

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

handle : Item

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

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

live : bool

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

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

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

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

orientation : перечисление

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

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

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

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

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

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

pressed : bool

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

snapMode : перечисление

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

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

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

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

См. также stepSize.

stepSize : real

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

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

to : real

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

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

value : real

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

См. также position.

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

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

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

См. также position.

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

void moved()

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

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

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

void decrease()

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

См. также stepSize.

void increase()

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

См. также stepSize.

вещественное valueAt(вещественное position)

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

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

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