Тип QML Dial

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

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

Свойства

• angle : real
• from : real
• handle : Item
• live : bool
• position : real
• pressed : bool
• snapMode : перечисление
• stepSize : real
• to : real
• value : real
• wrap : bool

Сигналы

• void moved()

Методы

• void decrease()
• void increase()

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

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

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

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

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

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

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

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

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

См. также position.

from : real

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

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

handle : Item

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

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

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

live : bool

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

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

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

См. также value.

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

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

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

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

pressed : bool

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

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

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.

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

void moved()

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

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

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

void decrease()

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

См. также stepSize.

void increase()

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

См. также stepSize.