Тип 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()

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

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

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

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

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

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

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

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

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

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

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

См. также position.

from : real

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

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

handle : Item

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

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

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

inputMode : enumeration

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

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

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

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

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

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. Если вам не нужно, чтобы шкала была нажата при нажатии клавиш (например, по причинам форматирования), вы можете использовать свойство Keys attached property:

Dial {
    Keys.onLeftPressed: {}
}

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

snapMode : enumeration

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

Режим привязки работает со свойством 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.

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

moved()

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

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

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

void decrease()

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

См. также stepSize.

void increase()

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

См. также stepSize.