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

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

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

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

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

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

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

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

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

См. также position.

from : real

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

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

handle : Item

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

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

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

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

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

Это свойство содержит значение в диапазоне 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 если шаг не определен.

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