Dial QML Type

값을 설정하기 위해 회전하는 원형 다이얼입니다. 더 보기...

Import Statement: import QtQuick.Controls
Inherits:

Control

속성

신호

  • moved() (since QtQuick.Controls 2.2 (Qt 5.9))
  • wrapped(Dial.WrapDirection direction) (since 6.6)

방법

상세 설명

다이얼은 스테레오나 산업용 장비와 같은 장치에서 볼 수 있는 기존의 다이얼 노브와 유사합니다. 사용자가 범위 내에서 값을 지정할 수 있습니다.

다이얼의 값은 value 속성으로 설정됩니다. 범위는 fromto 속성으로 설정합니다. 래핑을 활성화 또는 비활성화하려면 wrap 속성을 사용합니다.

다이얼은 키보드로 조작할 수 있습니다. 다음 작업을 지원합니다:

동작
value 감소 stepSizeQt.Key_Left
value 감소 stepSizeQt.Key_Down
valuefromQt.Key_Home
value 증가 stepSizeQt.Key_Right
value 증가 stepSizeQt.Key_Up
valuetoQt.Key_End

다이얼은 세 가지 input modes: Dial.Circular, Dial.Horizontal, Dial.Vertical 를 지원합니다. 원형 입력 모드는 다이얼 내 커서 위치가 값을 직접 반영하는 절대 입력 시스템에서 작동합니다. 수평 및 수직 입력 모드는 커서 위치의 변화가 다이얼의 값에 "추가"되는 상대 입력 시스템을 사용합니다.

다음 이미지는 다양한 입력 모드가 움직임을 추적하는 방향을 보여줍니다:

다이얼입력 컨트롤사용자 지정하기를참조하세요 .

속성 문서

angle : real [read-only]

이 속성은 핸들의 시계 방향 각도를 도 단위로 저장합니다.

각도는 12시 위치에서 0이며 범위는 startAngle 에서 endAngle 까지입니다.

position, startAngle, endAngle참조하세요 .


endAngle : real [since 6.6]

이 속성은 다이얼의 끝 각도를 도 단위로 보유합니다.

다이얼의 최대 값은 angle 입니다(예: to). 끝 각도는 startAngle 보다 크고 720보다 작으며 startAngle + 360도보다 작거나 같아야 합니다.

이 프로퍼티는 Qt 6.6에 도입되었습니다.

endAngle 과 angle도 참조하십시오 .


from : real

이 프로퍼티는 범위의 시작 값을 보유합니다. 기본값은 0.0 입니다.

tovalue도 참조하십시오 .


handle : Item

이 속성은 다이얼의 핸들을 보유합니다.

핸들은 다이얼의 위치를 시각적으로 표시하는 역할을 합니다.

다이얼 사용자 지정을참조하십시오 .


inputMode : enumeration [since QtQuick.Controls 2.5 (Qt 5.12)]

이 속성은 입력 모드를 보유합니다.

다이얼은 세 가지 입력 모드를 지원합니다: Dial.Circular, Dial.HorizontalDial.Vertical. 원형 입력 모드는 다이얼 내 커서 위치가 값을 직접 반영하는 절대 입력 시스템에서 작동합니다. 수평 및 수직 입력 모드는 커서 위치의 변화가 다이얼의 값에 "추가"되는 상대 입력 시스템을 사용합니다.

다음 이미지는 다양한 입력 모드가 움직임을 추적하는 방향을 보여줍니다:

기본값은 Dial.Circular 입니다.

이 프로퍼티는 QtQuick.Controls 2.5(Qt 5.12)에 도입되었습니다.


live : bool [since QtQuick.Controls 2.2 (Qt 5.9)]

이 속성은 핸들을 드래그하는 동안 다이얼이 value 속성에 대한 실시간 업데이트를 제공할지 여부를 유지합니다.

기본값은 true 입니다.

이 프로퍼티는 QtQuick.Controls 2.2 (Qt 5.9)에 도입되었습니다.

value참조하십시오 .


position : real [read-only]

이 속성은 핸들의 논리적 위치를 보유합니다.

위치는 0.0 - 1.0 범위에서 컨트롤의 각도 범위(핸들을 움직일 수 있는 범위)의 분수로 표현됩니다.

valueangle참조하십시오 .


pressed : bool

이 속성은 다이얼이 눌렸는지 여부를 보유합니다.

다이얼 위에 마우스를 올리거나 Qt.Key_Left 같은 키를 누르고 있으면 다이얼이 눌립니다. 예를 들어 스타일 등의 이유로 키를 누를 때 다이얼이 눌리지 않도록 하려면 Keys attached property 을 사용하면 됩니다:

Dial {
    Keys.onLeftPressed: {}
}

이렇게 하면 마우스를 누를 때 true 만 눌리게 됩니다.


snapMode : enumeration

이 속성은 스냅 모드를 유지합니다.

스냅 모드는 stepSize 과 함께 작동하여 다이얼의 특정 지점에 핸들을 스냅할 수 있습니다.

가능한 값은 다음과 같습니다:

상수설명
Dial.NoSnap다이얼이 스냅되지 않습니다(기본값).
Dial.SnapAlways핸들을 드래그하는 동안 다이얼이 스냅됩니다.
Dial.SnapOnRelease다이얼을 드래그하는 동안에는 스냅되지 않고 핸들을 놓은 후에만 스냅됩니다.

stepSize참조하십시오 .


startAngle : real [since 6.6]

이 속성은 다이얼의 시작 각도를 도 단위로 보유합니다.

다이얼의 최소값은 angle 입니다(예: from). 시작 각도는 endAngle 보다 작고 -360 보다 크며 endAngle - 360도보다 크거나 같아야 합니다.

이 프로퍼티는 Qt 6.6에 도입되었습니다.

endAngleangle도 참조하십시오 .


stepSize : real

이 프로퍼티는 스텝 크기를 보유합니다.

스텝 크기는 키보드를 통해 상호작용할 때 다이얼의 값이 증가하거나 감소하는 양을 결정합니다. 예를 들어 단계 크기가 0.2 인 경우 다이얼의 값은 0.2 단위로 증가 및 감소합니다.

단계 크기는 snapModeDial.NoSnap 이외의 값으로 설정된 경우에만 터치 및 마우스 상호 작용에 적용됩니다.

기본값은 0.0 이며, 키보드 상호 작용에 대한 유효 단계 크기는 0.1 입니다.

snapMode, increase() 및 decrease()도 참조하세요 .


to : real

이 속성은 범위의 끝값을 보유합니다. 기본값은 1.0 입니다.

fromvalue도 참조 하세요.


value : real

이 속성은 from - to 범위의 값을 보유합니다. 기본값은 0.0 입니다.

positionlive도 참조하십시오 .


wrap : bool

이 속성은 다이얼을 드래그할 때 줄 바꿈 여부를 저장합니다.

예를 들어 이 속성이 true 로 설정된 경우 다이얼을 to 위치 뒤로 드래그하면 핸들이 from 위치에 배치되고 그 반대의 경우도 마찬가지입니다:

이 속성이 false 인 경우 다이얼을 다음 및 다음 값 사이로 드래그할 수 없습니다.

기본값은 false 입니다.


신호 문서

[since QtQuick.Controls 2.2 (Qt 5.9)] moved()

이 신호는 사용자가 터치, 마우스 또는 키를 사용하여 다이얼을 대화형으로 움직였을 때 방출됩니다.

참고: 해당 핸들러는 onMoved 입니다.

이 신호는 QtQuick.Controls 2.2(Qt 5.9)에 도입되었습니다.


[since 6.6] wrapped(Dial.WrapDirection direction)

이 신호는 다이얼을 돌릴 때, 즉 최대값을 넘어 최소값으로 이동하거나 그 반대의 경우 방출됩니다. wraptrue 일 때만 발생합니다. direction 인수는 전체 회전 방향을 지정하며 다음 인수 중 하나가 될 수 있습니다:

상수설명
Dial.Clockwise다이얼이 시계 방향으로 감겨 있습니다.
Dial.CounterClockwise다이얼이 시계 반대 방향으로 감겨 있습니다.

참고: 해당 핸들러는 onWrapped 입니다.

이 신호는 Qt 6.6에 도입되었습니다.


메서드 문서

void decrease()

값을 stepSize 만큼 감소시키거나 stepSize 가 정의되지 않은 경우 0.1 만큼 감소시킵니다.

stepSize도 참조하십시오 .


void increase()

stepSize, 또는 stepSize 가 정의되지 않은 경우 0.1 만큼 값을 증가시킵니다.

stepSize도 참조하십시오 .


© 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.