Back to Qt.io
Contact Us Blog Download Qt

Slider QML Type

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

Import Statement: import QtQuick.Controls
Inherits:

Control

속성

신호

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

방법

상세 설명

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

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

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

position 속성은 0.0 - 1.0 범위에서 컨트롤 크기의 일부분으로 표현됩니다. visualPosition 속성은 오른쪽에서 왼쪽 애플리케이션에서 반전된다는 점을 제외하면 동일합니다. visualPosition 은 슬라이더를 스타일링할 때 핸들의 위치를 지정하는 데 유용합니다. 위의 예에서 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

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

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

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

horizontal 및 vertical 을참조하세요 .


position : real [read-only]

이 속성은 핸들의 논리적 위치를 보유합니다.

위치는 0.0 - 1.0 범위에서 컨트롤 크기의 일부분으로 표현됩니다. 슬라이더를 시각화하려면 오른쪽에서 왼쪽을 인식하는 visualPosition 을 대신 사용해야 합니다.

value, visualPosition, valueAt()도 참조하세요 .


pressed : bool

이 속성은 슬라이더가 터치, 마우스 또는 키 중 어느 것으로 눌렀는지 여부를 보유합니다.


snapMode : enumeration

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

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

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

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

다음 표에서는 다양한 모드를 애니메이션으로 설명합니다. 마우스 커서의 움직임과 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 를참조하세요 .


신호 문서

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

이 신호는 사용자가 터치, 마우스, 휠 또는 키를 사용하여 슬라이더를 대화형으로 움직였을 때 발생합니다.

참고: 해당 핸들러는 onMoved 입니다.

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


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