Тип 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 : Элемент

Это свойство содержит ручку диска.

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

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

[с 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 : логическое значение

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

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

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

См. также value.

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

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

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

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

pressed : логическое значение

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

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

Dial {
    Keys.onLeftPressed: {}
}

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

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

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

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

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

См. также stepSize.

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

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

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

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

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

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

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

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

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

значение : вещественное

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

См. также позиция и в режиме реального времени.

переносить : логическое

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

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

Когда это свойство false, перетаскивание циферблата через значения от и до недоступно.

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

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

[since QtQuick.Controls 2.2 (Qt 5.9)] перемещение()

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

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

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

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

void уменьшить()

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

См. также шаг.

void увеличить()

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

См. также шаг.