Тип QML Dial

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

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

Свойства

• угол : вещественное
• от : вещественное
• ручка : Элемент
• режимВвода : перечисление
• живой : логическое
• позиция : вещественное
• нажатый : логическое
• режимПривязки : перечисление
• шаг : вещественное
• до : вещественное
• значение : вещественное
• обернуть : логическое

Сигналы

• перемещено()

Методы

• void уменьшить()
• void увеличить()

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

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

Значение циферблата устанавливается свойством значение. Диапазон устанавливается свойствами от и до. Для включения или отключения обёртки используйте свойство обернуть.

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

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

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

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

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

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

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

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

См. также позиция.

от : вещественное

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

См. также до и значение.

ручка : Элемент

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

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

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

режимВвода : перечисление

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

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

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

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

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

живой : логическое

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

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

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

См. также значение.

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

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

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

См. также значение и угол.

нажатый : логическое

Это свойство указывает, нажат ли циферблат.

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

Dial {
    Keys.onLeftPressed: {}
}

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

режимПривязки : перечисление

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

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

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

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

шаг : вещественное

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

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

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

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

См. также режимПривязки, увеличить() и уменьшить().

до : вещественное

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

См. также от и значение.

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

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

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

wrap : bool

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

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

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

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

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

moved()

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

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

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

void decrease()

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

См. также stepSize.

void increase()

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

См. также stepSize.