QSlider Class
Q슬라이더 위젯은 수직 또는 수평 슬라이더를 제공합니다. 더 보기...
| 헤더: | #include <QSlider> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| 상속합니다: | QAbstractSlider |
공용 유형
| enum | TickPosition { NoTicks, TicksBothSides, TicksAbove, TicksBelow, TicksLeft, TicksRight } |
속성
- tickInterval : int
- tickPosition : TickPosition
공용 함수
| QSlider(QWidget *parent = nullptr) | |
| QSlider(Qt::Orientation orientation, QWidget *parent = nullptr) | |
| virtual | ~QSlider() |
| void | setTickInterval(int ti) |
| void | setTickPosition(QSlider::TickPosition position) |
| int | tickInterval() const |
| QSlider::TickPosition | tickPosition() const |
재구현된 공용 함수
| virtual bool | event(QEvent *event) override |
| virtual QSize | minimumSizeHint() const override |
| virtual QSize | sizeHint() const override |
보호된 함수
| virtual void | initStyleOption(QStyleOptionSlider *option) const |
재구현된 보호 함수
| virtual void | mouseMoveEvent(QMouseEvent *ev) override |
| virtual void | mousePressEvent(QMouseEvent *ev) override |
| virtual void | mouseReleaseEvent(QMouseEvent *ev) override |
| virtual void | paintEvent(QPaintEvent *ev) override |
상세 설명
슬라이더는 한정된 값을 제어하기 위한 고전적인 위젯입니다. 사용자가 수평 또는 수직 홈을 따라 슬라이더 핸들을 움직이고 핸들의 위치를 법적 범위 내의 정수 값으로 변환할 수 있습니다.
QSlider에는 자체 함수가 거의 없으며 대부분의 기능은 QAbstractSlider 에 있습니다. 가장 유용한 함수는 슬라이더를 직접 어떤 값으로 설정하는 setValue(), 클릭 효과를 시뮬레이션하는 triggerAction()(단축키에 유용), 단계를 설정하는 setSingleStep(), setPageStep(), 스크롤 바의 범위를 정의하는 setMinimum() 및 setMaximum() 등이 있습니다.
Q슬라이더는 체크 표시를 제어하는 메서드를 제공합니다. setTickPosition ()를 사용하여 틱마크의 위치를 지정하고 setTickInterval()를 사용하여 원하는 틱마크의 개수를 지정할 수 있으며, tickPosition() 및 tickInterval() 함수를 사용하여 현재 설정된 틱 위치와 간격을 각각 쿼리할 수 있습니다.
Q슬라이더는 포괄적인 신호 세트를 상속합니다:
| 신호 | 설명 |
|---|---|
| valueChanged() | 슬라이더의 값이 변경되었을 때 발생합니다. 추적()은 사용자 상호 작용 중에 이 신호가 방출되는지 여부를 결정합니다. |
| sliderPressed() | 사용자가 슬라이더를 드래그하기 시작할 때 발생합니다. |
| sliderMoved() | 사용자가 슬라이더를 드래그할 때 발생합니다. |
| sliderReleased() | 사용자가 슬라이더를 놓을 때 발생합니다. |
Q슬라이더는 정수 범위만 제공합니다. Q슬라이더는 매우 큰 숫자를 처리하지만 사용자가 매우 큰 범위에서 슬라이더를 정확하게 사용하기가 어렵다는 점에 유의하세요.
슬라이더는 Tab에 초점을 맞추고 마우스 휠과 키보드 인터페이스를 모두 제공합니다. 키보드 인터페이스는 다음과 같습니다:
- 왼쪽/오른쪽은 수평 슬라이더를 한 단계씩 이동합니다.
- 위/아래는 수직 슬라이더를 한 단계씩 이동합니다.
- 페이지업은 한 페이지 위로 이동합니다.
- 페이지다운은 한 페이지 아래로 이동합니다.
- 홈은 시작(최소)으로 이동합니다.
- 끝은 끝으로 이동합니다(최대).
QScrollBar, QSpinBox, QDial 및 슬라이더 예시를참조하세요 .
회원 유형 문서
enum QSlider::TickPosition
이 열거형은 슬라이더의 홈과 사용자가 이동하는 핸들을 기준으로 눈금 표시를 그릴 위치를 지정합니다.
| Constant | 값 | 설명 |
|---|---|---|
QSlider::NoTicks | 0 | 눈금선을 그리지 않습니다. |
QSlider::TicksBothSides | 3 | 홈의 양쪽에 눈금선을 그립니다. |
QSlider::TicksAbove | 1 | (수평) 슬라이더 위에 눈금 표시를 그립니다. |
QSlider::TicksBelow | 2 | (가로) 슬라이더 아래에 눈금 표시를 그립니다. |
QSlider::TicksLeft | TicksAbove | (세로) 슬라이더의 왼쪽에 눈금 표시를 그립니다. |
QSlider::TicksRight | TicksBelow | (세로) 슬라이더의 오른쪽에 눈금 표시를 그립니다. |
속성 문서
tickInterval : int
이 속성은 체크 표시 사이의 간격을 유지합니다.
이것은 픽셀 간격이 아닌 값 간격입니다. 0인 경우 슬라이더는 singleStep과 pageStep 중에서 선택합니다.
기본값은 0입니다.
함수에 액세스합니다:
| int | tickInterval() const |
| void | setTickInterval(int ti) |
tickPosition, singleStep, pageStep 를참조하세요 .
tickPosition : TickPosition
이 속성은 이 슬라이더의 틱마크 위치를 보유합니다.
유효한 값은 QSlider::TickPosition 열거형에 설명되어 있습니다.
기본값은 QSlider::NoTicks 입니다.
함수에 액세스합니다:
| QSlider::TickPosition | tickPosition() const |
| void | setTickPosition(QSlider::TickPosition position) |
tickInterval 를참조하세요 .
멤버 함수 문서
[explicit] QSlider::QSlider(QWidget *parent = nullptr)
주어진 parent 으로 수직 슬라이더를 생성합니다.
[explicit] QSlider::QSlider(Qt::Orientation orientation, QWidget *parent = nullptr)
주어진 parent 으로 슬라이더를 생성합니다. orientation 매개변수는 슬라이더가 가로인지 세로인지를 결정하며, 유효한 값은 Qt::Vertical 과 Qt::Horizontal 입니다.
[virtual noexcept] QSlider::~QSlider()
이 슬라이더를 파괴합니다.
[override virtual] bool QSlider::event(QEvent *event)
다시 구현합니다: QAbstractSlider::event(QEvent *e).
[virtual protected] void QSlider::initStyleOption(QStyleOptionSlider *option) const
QSlider 의 값으로 option 을 초기화합니다. 이 메서드는 하위 클래스에 QStyleOptionSlider 이 필요하지만 모든 정보를 직접 채우고 싶지 않을 때 유용합니다.
QStyleOption::initFrom()도 참조하세요 .
[override virtual] QSize QSlider::minimumSizeHint() const
속성에 대한 액세스 함수를 다시 구현합니다: QWidget::minimumSizeHint.
[override virtual protected] void QSlider::mouseMoveEvent(QMouseEvent *ev)
다시 구현합니다: QWidget::mouseMoveEvent(QMouseEvent * 이벤트).
[override virtual protected] void QSlider::mousePressEvent(QMouseEvent *ev)
다시 구현합니다: QWidget::mousePressEvent(QMouseEvent * 이벤트).
[override virtual protected] void QSlider::mouseReleaseEvent(QMouseEvent *ev)
다시 구현합니다: QWidget::mouseReleaseEvent(QMouseEvent * 이벤트).
[override virtual protected] void QSlider::paintEvent(QPaintEvent *ev)
다시 구현합니다: QWidget::paintEvent(QPaintEvent * 이벤트).
[override virtual] QSize QSlider::sizeHint() const
속성에 대한 액세스 함수를 다시 구현합니다: QWidget::sizeHint.
© 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.
