RangeSlider QML Type

트랙을 따라 두 개의 핸들을 밀어서 값의 범위를 선택하는 데 사용됩니다. 더 보기...

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

속성

• crossingEnabled : bool (since QtQuick.Controls 6.12)
• effectiveFirstValue : real (since QtQuick.Controls 6.12)
• effectiveSecondValue : real (since QtQuick.Controls 6.12)
• first
  • first.handle : Item
  • first.hovered : bool
  • first.implicitHandleHeight : real
  • first.implicitHandleWidth : real
  • first.position : real
  • first.pressed : bool
  • first.value : real
  • first.visualPosition : real
• from : real
• handlesCrossed : bool (since QtQuick.Controls 6.12)
• horizontal : bool (since QtQuick.Controls 2.3 (Qt 5.10))
• live : bool (since QtQuick.Controls 2.2 (Qt 5.9))
• orientation : enumeration
• second
  • second.handle : Item
  • second.hovered : bool
  • second.implicitHandleHeight : real
  • second.implicitHandleWidth : real
  • second.position : real
  • second.pressed : bool
  • second.value : real
  • second.visualPosition : real
• snapMode : enumeration
• stepSize : real
• to : real
• touchDragThreshold : real (since QtQuick.Controls 2.5 (Qt 5.12))
• vertical : bool (since QtQuick.Controls 2.3 (Qt 5.10))

신호

• void first.moved() (since QtQuick.Controls 2.5)
• void handlesCrossedChanged() (since QtQuick.Controls 6.12)
• void second.moved() (since QtQuick.Controls 2.5)

방법

• void first.decrease()
• void first.increase()
• void second.decrease()
• void second.increase()
• void setValues(real firstValue, real secondValue)
• real valueAt(real position) (since QtQuick.Controls 2.5 (Qt 5.12))

상세 설명

RangeSlider는 트랙을 따라 각 핸들을 슬라이드하여 두 값으로 지정된 범위를 선택하는 데 사용됩니다.

아래 예제에서는 사용자 정의 ` from ` 및 ` to ` 값이 설정되어 있으며, ` first ` 및 ` second ` 핸들의 초기 위치도 설정되어 있습니다:

RangeSlider {
    from: 1
    to: 100
    first.value: 25
    second.value: 75
}

특정 핸들의 값이 변경될 때 작업을 수행하려면 다음 구문을 사용합니다:

first.onMoved: console.log("first.value changed to " + first.value)

first.position 및 second.position 속성은 0.0 - 1.0 범위 내에서 컨트롤 크기의 비율로 표현됩니다. first.visualPosition 및 second.visualPosition 속성도 동일하지만, 오른쪽에서 왼쪽으로 읽는 애플리케이션에서는 순서가 반대로 적용됩니다. visualPosition 는 RangeSlider의 스타일을 지정할 때 핸들의 위치를 조정하는 데 유용합니다. 위의 예시에서, first.visualPosition 는 좌에서 우로 진행되는 애플리케이션에서는 0.24 가 되고, 우에서 좌로 진행되는 애플리케이션에서는 0.76 가 됩니다.

사용자가 단일 값을 선택할 수 있는 슬라이더에 대해서는 Slider 를 참조하십시오.

Qt Quick Controls 의‘RangeSlider, 입력 컨트롤 및 포커스 관리사용자 지정’항목도 참조하십시오 .

속성 설명서

crossingEnabled : bool [since QtQuick.Controls 6.12]

이 속성은 슬라이더 핸들이 서로 교차할 수 있는지 여부를 결정합니다.

false (기본값)인 경우, 첫 번째 핸들은 두 번째 핸들을 지나서 이동할 수 없으며, 그 반대의 경우도 마찬가지입니다. 값은 일반 범위에서는 first.value <= second.value, 반전 범위에서는 first.value >= second.value 가 되도록 제한됩니다.

handlesCrossed 속성을 사용하여 핸들이 서로 바뀌었는지 감지할 수 있습니다.

기본값은 false 입니다.

교차 표시가 비활성화된 상태에서 핸들이 교차되어 있었다면 핸들의 값이 서로 바뀝니다.

이 속성은 QtQuick.Controls 6.12에서 도입되었습니다.

handlesCrossed, first.value 및 second.value도 참조하십시오 .

effectiveFirstValue : real [read-only, since QtQuick.Controls 6.12]

이 속성은 핸들이 교차했는지 여부와 관계없이, 원래 “첫 번째” 핸들로 생성된 핸들의 값을 유지합니다.

crossingEnabled 가 ` false `이거나 핸들이 교차하지 않은 경우, 이 값은 ` first.value`과 같습니다. 핸들이 교차한 경우, 이 값은 시각적으로 "첫 번째" 위치(가로 방향에서는 가장 왼쪽, 세로 방향에서는 가장 아래쪽)에 있는 핸들의 값을 나타냅니다.

이 속성은 QtQuick.Controls 6.12에서 도입되었습니다.

effectiveSecondValue, first.value, handlesCrossed 및 crossingEnabled도 참조하십시오 .

effectiveSecondValue : real [read-only, since QtQuick.Controls 6.12]

이 속성은 시각적 “두 번째” 위치(가로 방향에서는 가장 오른쪽, 세로 방향에서는 가장 위쪽)에 있는 핸들의 값을 저장합니다.

crossingEnabled 가 ` false `이거나 핸들이 교차하지 않은 경우, 이 값은 ` second.value`과 같습니다. 핸들이 교차한 경우, 이 값은 시각적으로 "두 번째" 위치(가로 방향에서는 가장 오른쪽, 세로 방향에서는 가장 위쪽)에 있는 핸들의 값을 나타냅니다.

이 속성은 QtQuick.Controls 6.12에서 도입되었습니다.

effectiveFirstValue, second.value, handlesCrossed 및 crossingEnabled도 참조하십시오 .

first group

first.moved(), first.increase(), first.decrease()도 참조하십시오 .

from : real

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

to, first.value 및 second.value항목도 참조하십시오 .

handlesCrossed : bool [read-only, since QtQuick.Controls 6.12]

이 속성은 핸들이 서로 교차했는지 여부를 나타냅니다.

이 속성은 ' crossingEnabled '가 ' true'로 설정된 경우에만 적용됩니다. 핸들이 교차하면, 첫 번째와 두 번째가 각각 하한과 상한을 나타내는 의미적 의미를 유지하기 위해 핸들의 내부 역할이 서로 바뀝니다.

이 속성은 핸들이 교차된 상태일 때 시각적 피드백을 제공하는 데 사용할 수 있습니다.

이 속성은 QtQuick.Controls 6.12에서 도입되었습니다.

crossingEnabled 및 handlesCrossedChanged()도 참조하십시오 .

horizontal : bool [read-only, since QtQuick.Controls 2.3 (Qt 5.10)]

이 속성은 슬라이더가 가로 방향인지 여부를 나타냅니다.

이 속성은 QtQuick.Controls 2.3(Qt 5.10)에서 도입되었습니다.

orientation도 참조하십시오 .

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

이 속성은 각 핸들을 드래그하는 동안 슬라이더가 ` first.value ` 및 ` second.value ` 속성에 대한 실시간 업데이트를 제공하는지 여부를 나타냅니다.

기본값은 true 입니다.

이 속성은 QtQuick.Controls 2.2(Qt 5.9)에서 도입되었습니다.

first.value 및 second.value도 참조하십시오 .

orientation : enumeration

이 속성은 방향을 나타냅니다.

사용 가능한 값:

관련 항목: horizontal 및 vertical.

second group

second.moved(), second.increase(), second.decrease()도 참조하십시오 .

snapMode : enumeration

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

스냅 모드는 슬라이더 핸들이 ' stepSize'에 대해 어떻게 동작할지 결정합니다.

사용 가능한 값:

다양한 모드에 대한 시각적 설명은 Slider 의 ‘ snapMode ’ 문서를 참조하십시오.

stepSize도 참조하십시오 .

stepSize : real

이 속성은 단계 크기를 지정합니다. 기본값은 0.0 입니다.

snapMode, first.increase() 및 first.decrease()도 참조하십시오 .

to : real

이 속성은 범위의 끝값을 나타냅니다. 기본값은 1.0 입니다.

from, first.value 및 second.value도 참조하십시오 .

touchDragThreshold : real [since QtQuick.Controls 2.5 (Qt 5.12)]

이 속성은 터치 드래그 이벤트가 시작되는 임계값(논리 픽셀 단위)을 저장합니다. 마우스 드래그 임계값에는 영향을 미치지 않습니다. 기본값은 ` Application.styleHints.startDragDistance`입니다.

이 속성은 QtQuick.Controls 2.5(Qt 5.12)에서 도입되었습니다.

QStyleHints도 참조하십시오 .

vertical : bool [read-only, since QtQuick.Controls 2.3 (Qt 5.10)]

이 속성은 슬라이더가 수직인지 여부를 나타냅니다.

이 속성은 QtQuick.Controls 2.3(Qt 5.10)에서 도입되었습니다.

orientation도 참조하십시오 .

신호 문서

이 신호는 사용자가 터치, 마우스 또는 키를 통해 첫 번째 또는 두 번째 핸들을 직접 이동시켰을 때 발생합니다.

이 신호들은 QtQuick.Controls 2.5에서 도입되었습니다.

first 및 second도 참조하십시오 .

[since QtQuick.Controls 6.12] void handlesCrossedChanged()

이 신호는 핸들이 서로 교차하여 handlesCrossed 속성이 변경될 때 발생합니다.

이 신호는 QtQuick.Controls 6.12에서 도입되었습니다.

crossingEnabled도 참조하십시오 .

메서드 문서

void first.decrease()

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

first도 참조하십시오 .

void first.increase()

핸들의 값을 ` stepSize`만큼 증가시키거나, ` stepSize `가 정의되지 않은 경우 ` 0.1 `만큼 증가시킵니다.

first도 참조하십시오 .

void second.decrease()

핸들의 값을 ` stepSize`만큼 감소시킵니다. 단, ` stepSize `이 정의되지 않은 경우에는 ` 0.1 `만큼 감소시킵니다.

second도 참조하십시오 .

void second.increase()

핸들의 값을 ` stepSize`만큼 증가시키거나, ` stepSize `가 정의되지 않은 경우 ` 0.1 `만큼 증가시킵니다.

second도 참조하십시오 .

void setValues(real firstValue, real secondValue)

지정된 인수를 사용하여 first.value 및 second.value 를 설정합니다.

to 가 from 보다 크고, firstValue 가 secondValue 보다 큰 경우, firstValue는 secondValue로 제한됩니다.

from 가 to 보다 크고 secondValue가 firstValue보다 큰 경우, secondValue는 firstValue로 클램핑됩니다.

firstValue와 secondValue 사이에는 순환 의존성이 존재하여 할당된 값이 서로 클램핑될 수 있으므로, 컨트롤이 완료된 후 첫 번째 및 두 번째 값을 설정할 때 이 함수가 필요할 수 있습니다.

stepSize도 참조하십시오 .

[since QtQuick.Controls 2.5 (Qt 5.12)] real valueAt(real position)

지정된 ` position`에 대한 값을 반환합니다.

이 메서드는 QtQuick.Controls 2.5(Qt 5.12)에서 도입되었습니다.

first.value, second.value, first.position, second.position 및 live도 참조하십시오 .