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 속성으로 설정합니다. 래핑을 활성화 또는 비활성화하려면 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). 끝 각도는 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은 세 가지 입력 모드를 지원합니다: 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). 시작 각도는 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도 참조하세요 .