QStyleOptionHeader Class
QStyleOptionHeader 클래스는 헤더를 그리는 데 필요한 매개변수를 정의하는 데 사용됩니다. 더 보기...
| 헤더: | #include <QStyleOptionHeader> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| 상속: | QStyleOption |
| 상속받는 클래스: |
공개 유형
| enum | SectionPosition { Beginning, Middle, End, OnlyOneSection } |
| enum | SelectedPosition { NotAdjacent, NextIsSelected, PreviousIsSelected, NextAndPreviousAreSelected } |
| enum | SortIndicator { None, SortUp, SortDown } |
| enum | StyleOptionType { Type } |
| enum | StyleOptionVersion { Version } |
공개 함수
| QStyleOptionHeader() | |
| QStyleOptionHeader(const QStyleOptionHeader &other) | |
| QStyleOptionHeader & | operator=(const QStyleOptionHeader &) |
공용 변수
| QIcon | icon |
| Qt::Alignment | iconAlignment |
| Qt::Orientation | orientation |
| QStyleOptionHeader::SectionPosition | position |
| int | section |
| QStyleOptionHeader::SelectedPosition | selectedPosition |
| QStyleOptionHeader::SortIndicator | sortIndicator |
| QString | text |
| Qt::Alignment | textAlignment |
상세 설명
QStyleOptionHeader에는 QStyle 함수가 항목 뷰의 헤더 패널, 헤더 정렬 화살표 및 헤더 레이블을 그리는 데 필요한 모든 정보가 포함되어 있습니다.
성능상의 이유로 멤버 함수는 거의 없으며, 멤버 변수에 대한 액세스는 직접적으로 이루어집니다(즉, . 또는 -> 연산자를 사용). 이로 인해 구조체를 사용하기 쉬우며, 이들이 단순히 스타일 함수가 사용하는 매개변일 뿐임을 강조합니다.
QStyleOption도 참조하십시오 .
멤버 유형 문서
enum QStyleOptionHeader::SectionPosition
이 열거형을 통해 해당 섹션이 다른 섹션들에 비해 어디에 위치하는지 알 수 있습니다.
| 상수 | 값 | 설명 |
|---|---|---|
QStyleOptionHeader::Beginning | 0 | 헤더의 시작 부분 |
QStyleOptionHeader::Middle | 1 | 헤더의 중간 |
QStyleOptionHeader::End | 2 | 헤더 끝부분 |
QStyleOptionHeader::OnlyOneSection | 3 | 헤더 섹션이 하나뿐인 경우 |
position도 참조하십시오 .
enum QStyleOptionHeader::SelectedPosition
이 열거형을 통해 해당 섹션이 선택된 섹션에 비해 어디에 위치하는지 알 수 있습니다.
| 상수 | 값 | 설명 |
|---|---|---|
QStyleOptionHeader::NotAdjacent | 0 | 선택된 섹션과 인접하지 않음 |
QStyleOptionHeader::NextIsSelected | 1 | 다음 섹션이 선택됨 |
QStyleOptionHeader::PreviousIsSelected | 2 | 이전 섹션이 선택됨 |
QStyleOptionHeader::NextAndPreviousAreSelected | 3 | 다음 섹션과 이전 섹션이 모두 선택됨 |
selectedPosition도 참조하십시오 .
enum QStyleOptionHeader::SortIndicator
정렬 표시기가 그려져야 할 방향을 나타냅니다
| 상수 | 값 | 설명 |
|---|---|---|
QStyleOptionHeader::None | 0 | 정렬 표시기가 필요 없음 |
QStyleOptionHeader::SortUp | 1 | 위쪽 방향 표시를 그립니다. |
QStyleOptionHeader::SortDown | 2 | 하향 표시기 그리기 |
sortIndicator도 참조하십시오 .
enum QStyleOptionHeader::StyleOptionType
이 열거형은 스타일 옵션의 유형에 대한 정보를 담는 데 사용되며, 각 ` QStyleOption ` 하위 클래스마다 정의됩니다.
| 상수 | 상수명 | 설명 |
|---|---|---|
QStyleOptionHeader::Type | SO_Header | 제공된 스타일 옵션의 유형(이 클래스의 경우SO_Header ). |
이 유형은 QStyleOption, 그 하위 클래스 및 qstyleoption_cast()에서 스타일 옵션의 유형을 결정하기 위해 내부적으로 사용됩니다. 일반적으로 사용자 정의 QStyleOption 하위 클래스와 사용자 정의 스타일을 만들려는 경우가 아니라면 이 부분에 대해 걱정할 필요가 없습니다.
StyleOptionVersion도 참조하십시오 .
enum QStyleOptionHeader::StyleOptionVersion
이 열거형은 스타일 옵션의 버전에 대한 정보를 저장하는 데 사용되며, 각 QStyleOption 하위 클래스에 대해 정의됩니다.
| 상수 | 상수 | 상수값 |
|---|---|---|
QStyleOptionHeader::Version | 1 | 1 |
이 버전은 QStyleOption 의 하위 클래스에서 호환성을 해치지 않고 확장을 구현하는 데 사용됩니다. qstyleoption_cast()을 사용하는 경우, 일반적으로 이 값을 확인할 필요가 없습니다.
StyleOptionType도 참조하십시오 .
멤버 함수 문서
QStyleOptionHeader::QStyleOptionHeader()
QStyleOptionHeader 객체를 생성하고, 멤버 변수들을 기본값으로 초기화합니다.
QStyleOptionHeader::QStyleOptionHeader(const QStyleOptionHeader &other)
other 스타일 옵션의 복사본을 생성합니다.
[noexcept default] QStyleOptionHeader &QStyleOptionHeader::operator=(const QStyleOptionHeader &)
other 를 이 QStyleOptionHeader 인스턴스에 복사 할당합니다.
멤버 변수 문서
QIcon QStyleOptionHeader::icon
이 변수는 헤더의 아이콘을 저장합니다.
기본값은 빈 아이콘, 즉 픽스맵이나 파일 이름이 모두 없는 아이콘입니다.
Qt::Alignment QStyleOptionHeader::iconAlignment
이 변수는 헤더 아이콘의 정렬 플래그를 저장합니다.
기본값은 ` Qt::AlignLeft`입니다.
Qt::Orientation QStyleOptionHeader::orientation
이 변수는 헤더의 방향(가로 또는 세로)을 저장합니다.
기본 방향은 Qt::Horizontal
QStyleOptionHeader::SectionPosition QStyleOptionHeader::position
이 변수는 다른 섹션에 대한 해당 섹션의 위치를 저장합니다.
기본값은 QStyleOptionHeader::Beginning 입니다.
int QStyleOptionHeader::section
이 변수는 헤더의 어느 부분이 그려지고 있는지를 나타냅니다
기본값은 0입니다.
QStyleOptionHeader::SelectedPosition QStyleOptionHeader::selectedPosition
이 변수는 선택된 섹션에 대한 해당 섹션의 위치를 저장합니다.
기본값은 QStyleOptionHeader::NotAdjacent
QStyleOptionHeader::SortIndicator QStyleOptionHeader::sortIndicator
이 변수는 정렬 표시기가 그려져야 할 방향을 지정합니다.
기본값은 ` QStyleOptionHeader::None`입니다.
QString QStyleOptionHeader::text
이 변수는 헤더의 텍스트를 저장합니다.
기본값은 빈 문자열입니다.
Qt::Alignment QStyleOptionHeader::textAlignment
이 변수는 헤더 텍스트의 정렬 플래그를 저장합니다.
기본값은 Qt::AlignLeft 입니다.
© 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.
