Тип QML Dial

Цифровой циферблат, который вращается для установки значения. Подробнее...

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

Свойства

• angle : вещественное число
• from : вещественное число
• handle : Элемент
• inputMode : перечисление
• live : булево значение
• position : вещественное число
• pressed : булево значение
• snapMode : перечисление
• stepSize : вещественное число
• to : вещественное число
• value : вещественное число
• wrap : булево значение

Сигналы

• moved()

Методы

• void decrease()
• void increase()

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

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

Значение циферблата задается свойством value. Диапазон задается свойствами from и to. Для включения или выключения циклического режима используйте свойство wrap.

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

Циферблат поддерживает три режима ввода: Dial.Circular, Dial.Horizontal и Dial.Vertical. Режим ввода кругового типа использует абсолютную систему ввода, где положение курсора на циферблате напрямую отражает его значение. Горизонтальный и вертикальный режимы ввода используют относительную систему ввода, где изменения положения курсора "добавляются" к значению циферблата.

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

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

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

[только для чтения] angle : вещественное число

Это свойство содержит угол рукоятки.

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

См. также position.

from : вещественное число

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

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

handle : Элемент

Это свойство содержит рукоятку циферблата.

Рукоятка действует как визуальный индикатор положения циферблата.

См. также Настройка циферблата.

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

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

Циферблат поддерживает три режима ввода: Dial.Circular, Dial.Horizontal и Dial.Vertical. Режим ввода кругового типа использует абсолютную систему ввода, где положение курсора на циферблате напрямую отражает его значение. Горизонтальный и вертикальный режимы ввода используют относительную систему ввода, где изменения положения курсора "добавляются" к значению циферблата.

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

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

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

live : булево значение

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

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

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

См. также value.

[только для чтения] position : вещественное число

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

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

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

pressed : булево значение

Это свойство содержит информацию о том, нажата ли кнопка циферблата.

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

Dial {
    Keys.onLeftPressed: {}
}

Это приведет к тому, что нажатие будет происходить только при нажатии мышью.

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

Это свойство содержит режим "прилипания" к точкам.

Режим "прилипания" работает со свойством stepSize, чтобы рукоятка могла прилипать к определенным точкам на циферблате.

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

См. также stepSize.

stepSize : вещественное число

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

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

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

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

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

to : вещественное число

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

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

value : вещественное число

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

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

wrap : bool

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

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

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

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

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

moved()

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

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

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

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

void decrease()

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

См. также stepSize.

void increase()

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

См. также stepSize.