Dial QML Type

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

• 상속된 멤버를 포함한 모든 멤버 목록

속성

• 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

신호

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

방법

• void decrease()
• void increase()

상세 설명

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

다이얼의 값은 ` value ` 속성으로 설정됩니다. 범위는 ` from ` 및 ` to ` 속성으로 설정됩니다. 반복(wrapping) 기능을 활성화하거나 비활성화하려면 ` wrap ` 속성을 사용합니다.

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

다이얼은 세 가지 입력 모드( 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 입니다. endAngle은 startAngle 보다 커야 하며, 720보다 작고, startAngle + 360도 이하이어야 합니다.

이 속성은 Qt 6.6에서 도입되었습니다.

startAngle 및 angle도 참조하십시오 .

from : real

이 속성은 범위의 시작값을 저장합니다. 기본값은 0.0 입니다.

to 및 value도 참조하십시오 .

handle : Item

이 속성은 다이얼의 핸들을 저장합니다.

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

'다이얼 사용자 정의' 항목도 참조하십시오 .

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

이 속성은 입력 모드를 지정합니다.

다이얼은 세 가지 입력 모드( Dial.Circular, Dial.Horizontal, Dial.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 범위 내에서 컨트롤의 각도 범위(핸들을 이동할 수 있는 범위)에 대한 비율로 표현됩니다.

value 및 angle도 참조하십시오 .

pressed : bool

이 속성은 다이얼이 눌려 있는지 여부를 나타냅니다.

마우스가 다이얼 위에서 클릭되거나, Qt.Key_Left 와 같은 키가 길게 눌려지면 다이얼이 눌린 상태가 됩니다. (예를 들어 스타일링상의 이유로) 키를 눌렀을 때 다이얼이 눌린 상태가 되지 않도록 하려면 Keys attached property 를 사용할 수 있습니다:

Dial {
    Keys.onLeftPressed: {}
}

이렇게 하면 마우스 클릭 시에만 ‘ true ’ 상태가 됩니다.

snapMode : enumeration

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

스냅 모드는 다이얼 위치 조정( stepSize )과 연동되어 핸들이 다이얼을 따라 특정 지점에 스냅되도록 합니다.

사용 가능한 값:

stepSize도 참조하십시오 .

startAngle : real [since 6.6]

이 속성은 다이얼의 시작 각도를 도(°) 단위로 저장합니다.

이는 다이얼의 최소값이 될 angle, 즉 from 입니다. startAngle은 endAngle 보다 작아야 하며, -360보다 커야 하고, endAngle - 360도 이상이어야 합니다.

이 속성은 Qt 6.6에서 도입되었습니다.

endAngle 및 angle도 참조하십시오 .

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`로 설정되어 있으면, 다이얼을 시작값과 종료값을 넘어 드래그할 수 없습니다.

기본값은 ` false`입니다.

신호 문서

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

이 신호는 사용자가 터치, 마우스 또는 키를 통해 다이얼을 직접 이동했을 때 발생합니다.

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

[since 6.6] wrapped(Dial.WrapDirection direction)

이 신호는 다이얼이 한 바퀴를 돌 때, 즉 최대값을 넘어 최소값으로 이동하거나 그 반대의 경우 발생합니다. 이 신호는 ` wrap `가 ` true`일 때만 발생합니다. ` direction ` 인수는 전체 회전 방향을 지정하며, 다음 인수 중 하나를 가집니다:

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

메서드 문서

void decrease()

값을 stepSize 만큼 감소시키며, stepSize 가 정의되지 않은 경우에는 0.1 만큼 감소시킵니다.

stepSize도 참조하십시오 .

void increase()

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

stepSize도 참조하십시오 .