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

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

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

from : real

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

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

handle : Item

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

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

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

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

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