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

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

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

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

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

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

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

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

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

См. также position.

from : real

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

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

handle : Item

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

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

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

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

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

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

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.

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.