QStyleOptionProgressBar Class
QStyleOptionProgressBar 클래스는 진행률 표시줄을 그리는 데 필요한 매개변수를 정의하는 데 사용됩니다. 더 보기...
| 헤더: | #include <QStyleOptionProgressBar> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| 상속: | QStyleOption |
공개 유형
| enum | StyleOptionType { Type } |
| enum | StyleOptionVersion { Version } |
공개 함수
| QStyleOptionProgressBar() | |
| QStyleOptionProgressBar(const QStyleOptionProgressBar &other) | |
| QStyleOptionProgressBar & | operator=(const QStyleOptionProgressBar &) |
공개 변수
| bool | bottomToTop |
| bool | invertedAppearance |
| int | maximum |
| int | minimum |
| int | progress |
| QString | text |
| Qt::Alignment | textAlignment |
| bool | textVisible |
상세 설명
QStyleOptionProgressBar 클래스의 인스턴스는 SO_ProgressBar 유형이며 버전은 2입니다.
이 타입은 QStyleOption, 그 하위 클래스 및 qstyleoption_cast()에서 스타일 옵션의 타입을 결정하기 위해 내부적으로 사용됩니다. 일반적으로 사용자 정의 QStyleOption 하위 클래스와 사용자 정의 스타일을 만들지 않는 한 이 부분에 대해 걱정할 필요가 없습니다. 버전은 QStyleOption 하위 클래스에서 호환성을 해치지 않고 확장을 구현하는 데 사용됩니다. qstyleoption_cast()를 사용하는 경우, 일반적으로 이를 확인할 필요가 없습니다.
성능상의 이유로 멤버 함수는 거의 없으며, 멤버 변수에 대한 접근은 직접적으로 이루어집니다(즉, . 또는 -> 연산자를 사용). 이로 인해 구조체를 사용하기 쉬우며, 이들이 단순히 스타일 함수가 사용하는 매개변수임을 강조합니다.
QStyleOption도 참조하십시오 .
멤버 유형 문서
enum QStyleOptionProgressBar::StyleOptionType
이 열거형은 스타일 옵션의 유형에 대한 정보를 담기 위해 사용되며, 각 QStyleOption 하위 클래스에 대해 정의됩니다.
| 상수 | 상수명 | 상수값 |
|---|---|---|
QStyleOptionProgressBar::Type | SO_ProgressBar | 제공된 스타일 옵션의 유형(이 클래스의 경우SO_ProgressBar ). |
이 유형은 QStyleOption, 그 하위 클래스 및 qstyleoption_cast()에서 스타일 옵션의 유형을 결정하기 위해 내부적으로 사용됩니다. 일반적으로 사용자 정의 QStyleOption 하위 클래스와 사용자 정의 스타일을 만들려는 경우가 아니라면 이 부분에 대해 걱정할 필요가 없습니다.
StyleOptionVersion도 참조하십시오 .
enum QStyleOptionProgressBar::StyleOptionVersion
이 열거형은 스타일 옵션의 버전에 대한 정보를 저장하는 데 사용되며, 각 QStyleOption 하위 클래스에 대해 정의됩니다.
| 상수 | 상수 | 상수값 |
|---|---|---|
QStyleOptionProgressBar::Version | 1 | 2 |
이 버전은 QStyleOption 의 하위 클래스에서 호환성을 해치지 않고 확장을 구현하는 데 사용됩니다. qstyleoption_cast()를 사용하는 경우, 일반적으로 이 값을 확인할 필요가 없습니다.
StyleOptionType도 참조하십시오 .
멤버 함수 문서
QStyleOptionProgressBar::QStyleOptionProgressBar()
QStyleOptionProgressBar 객체를 생성하고, 멤버 변수들을 기본값으로 초기화합니다.
QStyleOptionProgressBar::QStyleOptionProgressBar(const QStyleOptionProgressBar &other)
other 스타일 옵션의 복사본을 생성합니다.
[noexcept default] QStyleOptionProgressBar &QStyleOptionProgressBar::operator=(const QStyleOptionProgressBar &)
other 을 이 QStyleOptionProgressBar 인스턴스에 복사-할당합니다.
멤버 변수 문서
bool QStyleOptionProgressBar::bottomToTop
이 변수는 진행률 표시줄이 세로 방향일 때 텍스트가 아래에서 위로 표시되는지 여부를 나타냅니다.
기본값은 false입니다.
QProgressBar::textDirection도 참조하십시오 .
bool QStyleOptionProgressBar::invertedAppearance
이 변수는 진행률 표시줄의 색상이 반전되는지 여부를 나타냅니다.
기본값은 false입니다.
QProgressBar::invertedAppearance도 참조하십시오 .
int QStyleOptionProgressBar::maximum
이 변수는 진행률 표시줄의 최대값을 저장합니다
이것은 진행률 표시줄의 최대값입니다. 기본값은 0입니다.
QProgressBar::maximum도 참조하십시오 .
int QStyleOptionProgressBar::minimum
이 변수는 진행률 표시줄의 최소 값을 저장합니다.
이것은 진행률 표시줄의 최소값입니다. 기본값은 0입니다.
QProgressBar::minimum도 참조하십시오 .
int QStyleOptionProgressBar::progress
이 변수는 진행률 표시줄의 현재 진행률을 저장합니다.
현재 진행률입니다. 값이 QStyleOptionProgressBar::minimum - 1인 경우 진행이 아직 시작되지 않았음을 나타냅니다. 기본값은 0입니다.
QProgressBar::value도 참조하십시오 .
QString QStyleOptionProgressBar::text
이 변수는 진행률 표시줄에 표시될 텍스트를 저장합니다.
진행률 표시줄의 텍스트는 일반적으로 진행률을 문자열로 표현한 것입니다. 빈 문자열은 진행률 표시줄이 아직 시작되지 않았음을 나타냅니다. 기본값은 빈 문자열입니다.
QProgressBar::text도 참조하십시오 .
Qt::Alignment QStyleOptionProgressBar::textAlignment
이 변수는 진행률 표시줄( QProgressBar) 내 텍스트의 정렬 방식을 저장합니다.
이는 진행률 막대 내에서 텍스트가 위치해야 할 위치를 안내하는 기준으로 사용할 수 있습니다. 기본값은 Qt::AlignLeft 입니다.
bool QStyleOptionProgressBar::textVisible
이 변수는 텍스트가 표시되는지 여부를 나타내는 플래그를 저장합니다.
이 플래그가 true인 경우 텍스트가 표시됩니다. 그렇지 않은 경우 텍스트는 표시되지 않습니다. 기본값은 false입니다.
QProgressBar::textVisible도 참조하십시오 .
© 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.
