Тип QML Dial

Цифровая шкала, которая поворачивается для задания значения. Подробнее...

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

Свойства

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

Сигналы

• moved()

Методы

• void decrease()
• void increase()

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

Поворотный переключатель похож на традиционный регулятор, который можно найти на устройствах, таких как стереосистемы или промышленное оборудование. Он позволяет пользователю указать значение в определённом диапазоне.

Значение переключателя устанавливается с помощью свойства value. Диапазон устанавливается с помощью свойств from и to. Чтобы включить или отключить обход, используйте свойство wrap.

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

Переключатель поддерживает три режима ввода: Dial.Circular, Dial.Horizontal и Dial.Vertical. Режим кругового ввода работает с абсолютной системой ввода, где положение курсора на шкале напрямую отражает его значение. Режимы горизонтального и вертикального ввода используют относительную систему ввода, где изменения положения курсора «добавляются» к значению переключателя.

На следующем рисунке показаны направления, по которым различные режимы ввода отслеживают перемещение:

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

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

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

Это свойство содержит угол рычага.

Диапазон от -140 градусов до 140 градусов.

См. также position.

from : real

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

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

handle : Item

Это свойство содержит рычаг переключателя.

Рычаг служит визуальным указателем положения переключателя.

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

[с момента QtQuick.Controls 2.5 (Qt 5.12)] inputMode : перечисление

Это свойство содержит режим ввода.

Переключатель поддерживает три режима ввода: Dial.Circular, Dial.Horizontal и Dial.Vertical. Режим кругового ввода работает с абсолютной системой ввода, где положение курсора на шкале напрямую отражает его значение. Режимы горизонтального и вертикального ввода используют относительную систему ввода, где изменения положения курсора «добавляются» к значению переключателя.

На следующем рисунке показаны направления, по которым различные режимы ввода отслеживают перемещение:

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

Это свойство было введено в QtQuick.Controls 2.5 (Qt 5.12).

[с момента QtQuick.Controls 2.2 (Qt 5.9)] live : bool

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

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

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

См. также value.

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

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

Положение выражается как доля диапазона углов управления (диапазона, в котором можно перемещать рычаг) в диапазоне 0.0 - 1.0.

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

pressed : bool

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

Переключатель будет нажат, когда нажата кнопка мыши или удерживается клавиша, например, Qt.Key_Left. Если вам не нужно, чтобы переключатель нажимался при нажатии клавиш (например, по причинам стилизации), вы можете использовать свойство Прикреплённые клавиши:

Dial {
    Keys.onLeftPressed: {}
}

Это приведёт к тому, что pressed будет true только при нажатии кнопкой мыши.

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

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

Режим привязки работает с stepSize, чтобы разрешить рычагу привязываться к определённым точкам на шкале.

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

См. также stepSize.

stepSize : real

Это свойство содержит размер шага.

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

Размер шага учитывается только при взаимодействии с касанием и мышью, когда snapMode имеет значение, отличное от Dial.NoSnap.

Значение по умолчанию — 0.0, что приводит к эффективному размеру шага 0.1 при взаимодействии с клавиатурой.

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

to : real

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

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

value : real

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

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

wrap : bool

Это свойство указывает, будет ли циклически повторяться значение шкалы при перетаскивании.

Например, когда это свойство установлено в true, перетаскивание шкалы за пределы значения to приведет к позиционированию указателя на значении from, и наоборот:

Когда это свойство равно false, перетаскивание шкалы через значения from и to невозможно.

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

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

[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.