Тип QML Dial

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

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

Свойства

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

Сигналы

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

Методы

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

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

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

Значение шкалы устанавливается с помощью свойства значение. Диапазон устанавливается с помощью свойств от и до. Чтобы включить или выключить обёртывание, используйте свойство обёртывание.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Значение по умолчанию равно 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.

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

обёртывание : логический

Это свойство указывает, обёртывается ли шкала при перетаскивании.

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

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

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

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

перемещен()

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

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

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

void decrease()

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

См. также stepSize.

void increase()

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

См. также stepSize.