Dial QML Type
값을 설정하기 위해 회전하는 원형 다이얼입니다. 더 보기...
Import Statement: | import QtQuick.Controls |
Inherits: |
속성
- angle : real
- endAngle : real
(since 6.6)
- from : real
- handle : Item
- inputMode : enumeration
(since QtQuick.Controls 2.5 (Qt 5.12))
- live : bool
(since QtQuick.Controls 2.2 (Qt 5.9))
- position : real
- pressed : bool
- snapMode : enumeration
- startAngle : real
(since 6.6)
- stepSize : real
- to : real
- value : real
- wrap : bool
신호
방법
상세 설명
다이얼은 스테레오나 산업용 장비와 같은 장치에서 볼 수 있는 기존의 다이얼 노브와 유사합니다. 사용자가 범위 내에서 값을 지정할 수 있습니다.
다이얼의 값은 value 속성으로 설정됩니다. 범위는 from 및 to 속성으로 설정합니다. 래핑을 활성화 또는 비활성화하려면 wrap 속성을 사용합니다.
다이얼은 키보드로 조작할 수 있습니다. 다음 작업을 지원합니다:
동작 | 키 |
---|---|
value 감소 stepSize | Qt.Key_Left |
value 감소 stepSize | Qt.Key_Down |
value 을 from | Qt.Key_Home |
value 증가 stepSize | Qt.Key_Right |
value 증가 stepSize | Qt.Key_Up |
value 를 to | Qt.Key_End |
다이얼은 세 가지 input modes: Dial.Circular
, Dial.Horizontal
, Dial.Vertical
를 지원합니다. 원형 입력 모드는 다이얼 내 커서 위치가 값을 직접 반영하는 절대 입력 시스템에서 작동합니다. 수평 및 수직 입력 모드는 커서 위치의 변화가 다이얼의 값에 "추가"되는 상대 입력 시스템을 사용합니다.
다음 이미지는 다양한 입력 모드가 움직임을 추적하는 방향을 보여줍니다:
속성 문서
angle : real |
이 속성은 핸들의 시계 방향 각도를 도 단위로 저장합니다.
각도는 12시 위치에서 0이며 범위는 startAngle 에서 endAngle
까지입니다.
position, startAngle, endAngle 를참조하세요 .
endAngle : real |
이 속성은 다이얼의 끝 각도를 도 단위로 보유합니다.
다이얼의 최대 값은 angle 입니다(예: to). 끝 각도는 startAngle 보다 크고 720보다 작으며 startAngle + 360도보다 작거나 같아야 합니다.
이 프로퍼티는 Qt 6.6에 도입되었습니다.
endAngle 과 angle도 참조하십시오 .
handle : Item |
inputMode : enumeration |
이 속성은 입력 모드를 보유합니다.
다이얼은 세 가지 입력 모드를 지원합니다: Dial.Circular
, Dial.Horizontal
및 Dial.Vertical
. 원형 입력 모드는 다이얼 내 커서 위치가 값을 직접 반영하는 절대 입력 시스템에서 작동합니다. 수평 및 수직 입력 모드는 커서 위치의 변화가 다이얼의 값에 "추가"되는 상대 입력 시스템을 사용합니다.
다음 이미지는 다양한 입력 모드가 움직임을 추적하는 방향을 보여줍니다:
기본값은 Dial.Circular
입니다.
이 프로퍼티는 QtQuick.Controls 2.5(Qt 5.12)에 도입되었습니다.
live : bool |
position : real |
pressed : bool |
이 속성은 다이얼이 눌렸는지 여부를 보유합니다.
다이얼 위에 마우스를 올리거나 Qt.Key_Left
같은 키를 누르고 있으면 다이얼이 눌립니다. 예를 들어 스타일 등의 이유로 키를 누를 때 다이얼이 눌리지 않도록 하려면 Keys attached property 을 사용하면 됩니다:
Dial { Keys.onLeftPressed: {} }
이렇게 하면 마우스를 누를 때 true
만 눌리게 됩니다.
snapMode : enumeration |
startAngle : real |
stepSize : real |
wrap : bool |
신호 문서
|
이 신호는 사용자가 터치, 마우스 또는 키를 사용하여 다이얼을 대화형으로 움직였을 때 방출됩니다.
참고: 해당 핸들러는 onMoved
입니다.
이 신호는 QtQuick.Controls 2.2(Qt 5.9)에 도입되었습니다.
|
이 신호는 다이얼을 돌릴 때, 즉 최대값을 넘어 최소값으로 이동하거나 그 반대의 경우 방출됩니다. wrap 이 true
일 때만 발생합니다. direction 인수는 전체 회전 방향을 지정하며 다음 인수 중 하나가 될 수 있습니다:
상수 | 설명 |
---|---|
Dial.Clockwise | 다이얼이 시계 방향으로 감겨 있습니다. |
Dial.CounterClockwise | 다이얼이 시계 반대 방향으로 감겨 있습니다. |
참고: 해당 핸들러는 onWrapped
입니다.
이 신호는 Qt 6.6에 도입되었습니다.
메서드 문서
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.