QStyleOptionSlider Class
QStyleOptionSlider 클래스는 슬라이더를 그리는 데 필요한 매개변수를 정의하는 데 사용됩니다. 더 보기...
| 헤더: | #include <QStyleOptionSlider> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| 상속: | QStyleOptionComplex |
공개 유형
| enum | StyleOptionType { Type } |
| enum | StyleOptionVersion { Version } |
공개 함수
| QStyleOptionSlider() | |
| QStyleOptionSlider(const QStyleOptionSlider &other) | |
| QStyleOptionSlider & | operator=(const QStyleOptionSlider &) |
공개 변수
| bool | dialWrapping |
| int | maximum |
| int | minimum |
| qreal | notchTarget |
| Qt::Orientation | orientation |
| int | pageStep |
| int | singleStep |
| int | sliderPosition |
| int | sliderValue |
| int | tickInterval |
| QSlider::TickPosition | tickPosition |
| bool | upsideDown |
상세 설명
QStyleOptionSlider는 QStyle 함수가 QSlider 및 QScrollBar 를 그리는 데 필요한 모든 정보를 포함합니다.
성능상의 이유로 멤버 함수는 거의 없으며, 멤버 변수에 대한 액세스는 직접적으로 이루어집니다(즉, . 또는 -> 연산자를 사용). 이로 인해 구조를 사용하기 쉬우며, 이들이 단순히 스타일 함수가 사용하는 매개변일 뿐임을 강조합니다.
QStyleOptionComplex, QSlider 및 QScrollBar도 참조하십시오 .
멤버 유형 문서
enum QStyleOptionSlider::StyleOptionType
이 열거형은 스타일 옵션의 유형에 대한 정보를 담기 위해 사용되며, 각 QStyleOption 하위 클래스에 대해 정의됩니다.
| 상수 | 상수명 | 설명 |
|---|---|---|
QStyleOptionSlider::Type | SO_Slider | 제공된 스타일 옵션의 유형(이 클래스의 경우SO_Slider ). |
이 유형은 QStyleOption, 그 하위 클래스 및 qstyleoption_cast()에서 스타일 옵션의 유형을 결정하기 위해 내부적으로 사용됩니다. 일반적으로 사용자 정의 QStyleOption 하위 클래스와 사용자 정의 스타일을 만들려는 경우가 아니라면 이에 대해 신경 쓸 필요가 없습니다.
StyleOptionVersion도 참조하십시오 .
enum QStyleOptionSlider::StyleOptionVersion
이 열거형은 스타일 옵션의 버전에 대한 정보를 저장하는 데 사용되며, 각 ` QStyleOption ` 하위 클래스에 대해 정의됩니다.
| 상수 | 상수 | 상수값 |
|---|---|---|
QStyleOptionSlider::Version | 1 | 1 |
이 버전은 QStyleOption 의 하위 클래스에서 호환성을 해치지 않고 확장을 구현하는 데 사용됩니다. qstyleoption_cast()를 사용하는 경우, 일반적으로 이 값을 확인할 필요가 없습니다.
StyleOptionType도 참조하십시오 .
멤버 함수 설명서
QStyleOptionSlider::QStyleOptionSlider()
QStyleOptionSlider 객체를 생성하고, 멤버 변수들을 기본값으로 초기화합니다.
QStyleOptionSlider::QStyleOptionSlider(const QStyleOptionSlider &other)
other 스타일 옵션의 복사본을 생성합니다.
[noexcept default] QStyleOptionSlider &QStyleOptionSlider::operator=(const QStyleOptionSlider &)
other 를 이 QStyleOptionSlider 인스턴스에 복사 할당합니다.
멤버 변수 문서
bool QStyleOptionSlider::dialWrapping
이 변수는 다이얼을 줄바꿈할지 여부를 지정합니다.
기본값은 false이며, 즉 다이얼이 줄바꿈되지 않습니다.
QDial::wrapping()도 참조하십시오 .
int QStyleOptionSlider::maximum
이 변수는 슬라이더의 최대값을 저장합니다
기본값은 0입니다.
int QStyleOptionSlider::minimum
이 변수는 슬라이더의 최소값을 저장합니다
기본값은 0입니다.
qreal QStyleOptionSlider::notchTarget
이 변수는 노치 사이의 픽셀 수를 저장합니다.
기본값은 0.0입니다.
QDial::notchTarget()도 참조하십시오 .
Qt::Orientation QStyleOptionSlider::orientation
이 변수는 슬라이더의 방향(가로 또는 세로)을 저장합니다.
기본 방향은 Qt::Horizontal 입니다.
Qt::Orientation도 참조하십시오 .
int QStyleOptionSlider::pageStep
이 변수는 슬라이더의 페이지 단위 크기를 저장합니다.
기본값은 0입니다.
QAbstractSlider::pageStep도 참조하십시오 .
int QStyleOptionSlider::singleStep
이 변수는 슬라이더의 한 단계 크기를 저장합니다.
기본값은 0입니다.
QAbstractSlider::singleStep도 참조하십시오 .
int QStyleOptionSlider::sliderPosition
이 변수는 슬라이더 핸들의 위치를 저장합니다.
슬라이더에 활성 피드백이 설정된 경우(즉, ` QAbstractSlider::tracking `가 `true`인 경우), 이 값은 ` sliderValue`와 동일합니다. 그렇지 않은 경우, 핸들의 현재 위치를 가집니다. 기본값은 0입니다.
QAbstractSlider::tracking 및 sliderValue도 참조하십시오 .
int QStyleOptionSlider::sliderValue
이 변수는 슬라이더의 값을 저장합니다.
슬라이더에 활성 피드백이 설정되어 있는 경우(즉, ` QAbstractSlider::tracking `가 `true`인 경우), 이 값은 ` sliderPosition`와 동일합니다. 그렇지 않은 경우, 이 값은 마우스 버튼이 눌리기 직전에 슬라이더가 가졌던 값이 됩니다.
기본값은 0입니다.
QAbstractSlider::tracking 및 sliderPosition도 참조하십시오 .
int QStyleOptionSlider::tickInterval
이 변수는 눈금 사이에 그려져야 할 간격을 저장합니다.
기본값은 0입니다.
QSlider::TickPosition QStyleOptionSlider::tickPosition
이 변수는 슬라이더의 눈금(있는 경우) 위치를 저장합니다.
기본값은 QSlider::NoTicks 입니다.
QSlider::TickPosition도 참조하십시오 .
bool QStyleOptionSlider::upsideDown
이 변수는 슬라이더 컨트롤의 방향을 저장합니다.
일반적으로 슬라이더는 위쪽이나 오른쪽으로 이동할수록 값이 증가하지만, upsideDown이 설정된 경우 그 반대로(아래쪽이나 왼쪽으로 이동할수록 값이 증가) 동작합니다. 기본값은 false이며, 즉 슬라이더는 위쪽이나 오른쪽으로 이동할수록 값이 증가합니다.
QStyle::sliderPositionFromValue(), QStyle::sliderValueFromPosition() 및 QAbstractSlider::invertedAppearance도 참조하십시오 .
© 2026 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.
