Тип QML ползунок

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

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

Свойства

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

Сигналы

• moved()

Методы

• void decrease()
• void increase()
• real valueAt(real position)

Подробное описание

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

В примере ниже устанавливаются пользовательские значения from, value и to:

Slider {
    from: 1
    value: 25
    to: 100
}

Свойство position выражается как дробь от размера элемента управления в диапазоне 0.0 - 1.0. Свойство visualPosition такое же, но инвертировано в приложениях с направлением справа налево. Свойство visualPosition полезно для позиционирования ползунка при стилизации ползунка. В приведенном выше примере visualPosition будет 0.24 в приложениях слева направо и 0.76 в приложениях справа налево.

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

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

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

from : real

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

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

handle : Item

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

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

[только для чтения] horizontal : bool

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

Это свойство было добавлено в QtQuick.Controls 2.3 (Qt 5.10).

См. также orientation.

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.

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(real position)

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

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

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