Slider QML Type

트랙을 따라 핸들을 슬라이드하여 값을 선택하는 데 사용됩니다. 더 보기...

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

속성

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

신호

• moved() (since QtQuick.Controls 2.2 (Qt 5.9))

방법

• void decrease()
• void increase()
• real valueAt(real position) (since QtQuick.Controls 2.1 (Qt 5.8))

상세 설명

슬라이더는 트랙을 따라 핸들을 슬라이드하여 값을 선택하는 데 사용됩니다.

아래 예제에서는 사용자 정의 from, value 및 to 값이 설정되어 있습니다:

Slider {
    from: 1
    value: 25
    to: 100
}

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

두 개의 핸들을 제공하여 사용자가 범위를 선택할 수 있는 슬라이더에 대해서는 RangeSlider 를 참조하십시오.

'슬라이더 및 입력 컨트롤사용자 지정'도 참조하십시오 .

속성 설명서

from : real

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

to 및 value도 참조하십시오 .

handle : Item

이 속성은 핸들 항목을 저장합니다.

'슬라이더 사용자 정의' 항목도 참조하십시오 .

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

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

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

orientation도 참조하십시오 .

implicitHandleHeight : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]

이 속성은 암시적 핸들의 높이를 저장합니다.

이 값은 handle ? handle.implicitHeight : 0 과 같습니다.

이 속성은 일반적으로 implicitContentHeight 및 implicitBackgroundHeight 와 함께 사용되어 implicitHeight 를 계산합니다.

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

implicitHandleWidth도 참조하십시오 .

implicitHandleWidth : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]

이 속성은 암시적 핸들 너비를 저장합니다.

이 값은 handle ? handle.implicitWidth : 0 과 같습니다.

이 속성은 일반적으로 implicitContentWidth 및 implicitBackgroundWidth 와 함께 사용되어 implicitWidth 를 계산합니다.

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

implicitHandleHeight도 참조하십시오 .

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

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

기본값은 ` true`입니다.

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

value 및 valueAt()도 참조하십시오 .

orientation : enumeration

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

사용 가능한 값:

관련 항목: horizontal 및 vertical.

position : real [read-only]

이 속성은 핸들의 논리적 위치를 나타냅니다.

이 위치는 컨트롤 크기의 비율로 표현되며, 범위는 0.0 - 1.0 입니다. 슬라이더를 시각화할 때는 대신 오른쪽에서 왼쪽으로 방향을 인식하는 visualPosition 를 사용해야 합니다.

value, visualPosition 및 valueAt()도 참조하십시오 .

pressed : bool

이 속성은 슬라이더가 터치, 마우스 또는 키 입력으로 눌렸는지 여부와 관계없이 적용됩니다.

snapMode : enumeration

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

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

사용 가능한 값:

다음 표에서는 다양한 모드를 애니메이션으로 보여줍니다. 각 애니메이션에서 마우스 커서의 움직임과 stepSize (0.2)는 동일합니다.

값	예
Slider.NoSnap
Slider.SnapAlways
Slider.SnapOnRelease

stepSize도 참조하십시오 .

stepSize : real

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

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

to : real

이 속성은 범위의 끝값을 저장합니다. 기본값은 1.0 입니다.

from 및 value도 참조하십시오 .

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

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

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

QStyleHints도 참조하십시오 .

value : real

이 속성의 값은 from - to 범위 내에 있습니다. 기본값은 0.0 입니다.

position도 참조하십시오 .

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

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

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

orientation도 참조하십시오 .

visualPosition : real [read-only]

이 속성은 핸들의 시각적 위치를 나타냅니다.

이 위치는 컨트롤 크기의 비율로 표현되며, 범위는 0.0 - 1.0 입니다. 컨트롤이 ' mirrored' 상태일 때, 이 값은 1.0 - position 와 같습니다. 이를 통해 오른쪽에서 왼쪽으로 읽는 방향을 지원한다는 점을 고려하여 슬라이더를 시각화하는 데 적합한 값이 됩니다.

position도 참조하십시오 .

Signal 문서

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

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

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

메서드 문서

void decrease()

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

stepSize도 참조하십시오 .

void increase()

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

stepSize도 참조하십시오 .

[since QtQuick.Controls 2.1 (Qt 5.8)] real valueAt(real position)

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

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

value 및 position도 참조하십시오 .