RangeSlider QML Type

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

Import Statement:	`import QtQuick.Controls`
Inherits:	Control

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

속성

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.handle : Item
first.hovered : bool
first.implicitHandleHeight : real
first.implicitHandleWidth : real
first.position : real
first.pressed : bool
first.value : real
first.visualPosition : real

속성	설명
value	이 속성은 `from` - `to` 범위의 첫 번째 핸들 값을 보유합니다. from 이 to 보다 큰 경우 첫 번째 핸들의 값은 두 번째 핸들보다 커야 하며, 그 반대도 마찬가지입니다. 기본값은 `0.0` 입니다.
handle	이 속성은 첫 번째 핸들 항목을 보유합니다.
visualPosition	이 속성은 첫 번째 핸들의 시각적 위치를 저장합니다. 위치는 `0.0 - 1.0` 범위에서 컨트롤 크기의 일부분으로 표현됩니다. 컨트롤이 mirrored 인 경우 값은 `1.0 - position` 과 같습니다. 이 값은 슬라이더를 시각화하는 데 적합하며 오른쪽에서 왼쪽으로 지원되는 것을 고려합니다.
위치	이 속성은 첫 번째 핸들의 논리적 위치를 보유합니다. 위치는 `0.0 - 1.0` 범위에서 컨트롤 크기의 일부분으로 표현됩니다. 슬라이더를 시각화하려면 오른쪽에서 왼쪽을 인식하는 visualPosition 을 대신 사용해야 합니다.
눌렀음	이 속성은 첫 번째 핸들이 터치, 마우스 또는 키 중 하나로 눌렀는지 여부를 보유합니다.
hovered	이 속성은 첫 번째 핸들을 가리켰는지 여부를 저장합니다. 이 프로퍼티는 QtQuick.Controls 2.1에 도입되었습니다.
implicitHandleWidth	이 속성은 첫 번째 핸들의 암시적 너비를 보유합니다. 이 속성은 QtQuick.Controls 2.5에 도입되었습니다.
implicitHandleHeight	이 속성은 첫 번째 핸들의 암시적 높이를 보유합니다. 이 속성은 QtQuick.Controls 2.5에 도입되었습니다.

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

이 속성은 방향을 유지합니다.

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

Constant	설명
`Qt.Horizontal`	가로(기본값)
`Qt.Vertical`	수직

horizontal 및 vertical 을참조하세요 .

second group
second.handle : Item
second.hovered : bool
second.implicitHandleHeight : real
second.implicitHandleWidth : real
second.position : real
second.pressed : bool
second.value : real
second.visualPosition : real

Property	설명
value	이 속성은 `from` - `to` 범위의 두 번째 핸들 값을 보유합니다. from 이 to 보다 큰 경우 첫 번째 핸들의 값은 두 번째 핸들보다 커야 하며, 그 반대의 경우도 마찬가지입니다. 기본값은 `0.0` 입니다.
handle	이 속성은 두 번째 핸들 항목을 보유합니다.
visualPosition	이 속성은 두 번째 핸들의 시각적 위치를 저장합니다. 위치는 `0.0 - 1.0` 범위에서 컨트롤 크기의 일부분으로 표현됩니다. 컨트롤이 mirrored 인 경우 값은 `1.0 - position` 과 같습니다. 이 값은 오른쪽에서 왼쪽 지원을 고려하여 슬라이더를 시각화하는 데 적합합니다.
위치	이 속성은 두 번째 핸들의 논리적 위치를 보유합니다. 위치는 `0.0 - 1.0` 범위에서 컨트롤 크기의 일부분으로 표현됩니다. 슬라이더를 시각화하려면 오른쪽에서 왼쪽을 인식하는 visualPosition 을 대신 사용해야 합니다.
눌렀음	이 속성은 두 번째 핸들이 터치, 마우스 또는 키 중 하나로 눌렀는지 여부를 보유합니다.
hovered	이 속성은 두 번째 핸들이 마우스오버되었는지 여부를 저장합니다. 이 프로퍼티는 QtQuick.Controls 2.1에 도입되었습니다.
implicitHandleWidth	이 속성은 두 번째 핸들의 암시적 너비를 보유합니다. 이 속성은 QtQuick.Controls 2.5에 도입되었습니다.
implicitHandleHeight	이 속성은 두 번째 핸들의 암시적 높이를 보유합니다. 이 속성은 QtQuick.Controls 2.5에 도입되었습니다.

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

snapMode : enumeration

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

스냅 모드는 stepSize 에 대한 슬라이더 핸들의 동작 방식을 결정합니다.

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

Constant	설명
`RangeSlider.NoSnap`	슬라이더가 스냅되지 않습니다(기본값).
`RangeSlider.SnapAlways`	핸들을 드래그하는 동안 슬라이더가 스냅됩니다.
`RangeSlider.SnapOnRelease`	슬라이더를 드래그하는 동안에는 스냅되지 않고 핸들을 놓은 후에만 스냅됩니다.

다양한 모드에 대한 시각적 설명은 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도 참조하십시오 .

신호 문서

[since QtQuick.Controls 2.5] void first.moved()

[since QtQuick.Controls 2.5] void second.moved()

이 신호는 사용자가 터치, 마우스 또는 키를 사용하여 첫 번째 또는 두 번째 핸들을 대화형으로 움직였을 때 발생합니다.

이 QML 신호는 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 를참조하십시오 .

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