RangeSlider QML Type

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

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

속성

• 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
• 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 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))

상세 설명

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

아래 예시에서는 사용자 지정 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 에서범위 슬라이더, 입력 컨트롤 및 초점 관리사용자 지정하기를참조하세요 .

속성 문서

first group

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

from : real

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

to, first.value, second.value도 참조하세요 .

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 를참조하십시오 .

메서드 문서

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 에 클램핑됩니다.

이 함수는 첫 번째 값과 두 번째 값 사이에 순환 종속성이 있어 할당된 값이 서로 클램핑될 수 있으므로 제어가 완료된 후 첫 번째 값과 두 번째 값을 설정하는 데 필요할 수 있습니다.

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 를참조하십시오 .