QStyleOptionViewItem Class
QStyleOptionViewItem 클래스는 뷰 위젯에서 항목을 그리는 데 사용되는 매개변수를 정의하는 데 사용됩니다. 더 보기...
| 헤더: | #include <QStyleOptionViewItem> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| 상속: | QStyleOption |
공개 유형
| enum | Position { Left, Right, Top, Bottom } |
| enum | StyleOptionType { Type } |
| enum | StyleOptionVersion { Version } |
| enum | ViewItemFeature { None, WrapText, Alternate, HasCheckIndicator, HasDisplay, …, IsDecorationForRootColumn } |
| flags | ViewItemFeatures |
| enum | ViewItemPosition { Invalid, Beginning, Middle, End, OnlyOne } |
공개 함수
| QStyleOptionViewItem() | |
| QStyleOptionViewItem(const QStyleOptionViewItem &other) | |
| QStyleOptionViewItem & | operator=(const QStyleOptionViewItem &) |
공개 변수
| QBrush | backgroundBrush |
| Qt::CheckState | checkState |
| Qt::Alignment | decorationAlignment |
| QStyleOptionViewItem::Position | decorationPosition |
| QSize | decorationSize |
| Qt::Alignment | displayAlignment |
| QStyleOptionViewItem::ViewItemFeatures | features |
| QFont | font |
| QIcon | icon |
| QModelIndex | index |
| QLocale | locale |
| bool | showDecorationSelected |
| QString | text |
| Qt::TextElideMode | textElideMode |
| QStyleOptionViewItem::ViewItemPosition | viewItemPosition |
| const QWidget * | widget |
상세 설명
QStyleOptionViewItem은 QStyle 함수가 Qt의 모델/뷰 클래스에 대한 항목을 그리는 데 필요한 모든 정보를 포함합니다.
성능상의 이유로 멤버 함수는 거의 없으며, 멤버 변수에 대한 액세스는 직접적으로 이루어집니다(즉, . 또는 -> 연산자를 사용). 이로 인해 구조를 사용하기 쉽고, 이 구조들이 단순히 스타일 함수가 사용하는 매개변일 뿐임을 강조합니다.
QStyleOption 및 모델/뷰 프로그래밍항목도 참조하십시오 .
멤버 유형 문서
enum QStyleOptionViewItem::Position
이 열거형은 항목의 장식 위치에 대해 설명합니다.
| 상수 | 값 | 설명 |
|---|---|---|
QStyleOptionViewItem::Left | 0 | 텍스트의 왼쪽. |
QStyleOptionViewItem::Right | 1 | 텍스트의 오른쪽. |
QStyleOptionViewItem::Top | 2 | 텍스트 위. |
QStyleOptionViewItem::Bottom | 3 | 텍스트 아래. |
decorationPosition도 참조하십시오 .
enum QStyleOptionViewItem::StyleOptionType
이 열거형은 스타일 옵션의 유형에 대한 정보를 담기 위해 사용되며, 각 ` QStyleOption ` 하위 클래스에 대해 정의됩니다.
| 상수 | 상수명 | 설명 |
|---|---|---|
QStyleOptionViewItem::Type | SO_ViewItem | 제공된 스타일 옵션의 유형(이 클래스의 경우SO_ViewItem ). |
이 유형은 QStyleOption, 그 하위 클래스 및 qstyleoption_cast()에서 스타일 옵션의 유형을 결정하기 위해 내부적으로 사용됩니다. 일반적으로 사용자 정의 QStyleOption 하위 클래스와 사용자 정의 스타일을 만들려는 경우가 아니라면 이 부분에 대해 신경 쓸 필요가 없습니다.
StyleOptionVersion도 참조하십시오 .
enum QStyleOptionViewItem::StyleOptionVersion
이 열거형은 스타일 옵션의 버전에 대한 정보를 저장하는 데 사용되며, 각 QStyleOption 하위 클래스에 대해 정의됩니다.
| 상수 | 상수 | 상수값 |
|---|---|---|
QStyleOptionViewItem::Version | 1 | 4 |
이 버전은 QStyleOption 의 하위 클래스에서 호환성을 해치지 않고 확장 기능을 구현하는 데 사용됩니다. qstyleoption_cast()를 사용하는 경우, 일반적으로 이 값을 확인할 필요가 없습니다.
StyleOptionType도 참조하십시오 .
enum QStyleOptionViewItem::ViewItemFeature
flags QStyleOptionViewItem::ViewItemFeatures
이 열거형은 항목이 가질 수 있는 다양한 유형의 특징을 설명합니다.
| 상수 | 값 | 설명 |
|---|---|---|
QStyleOptionViewItem::None | 0x00 | 일반 아이템을 나타냅니다. |
QStyleOptionViewItem::WrapText | 0x01 | 텍스트가 감싸진 아이템을 나타냅니다. |
QStyleOptionViewItem::Alternate | 0x02 | 항목의 배경이 alternateBase를 사용하여 렌더링됨을 나타냅니다. |
QStyleOptionViewItem::HasCheckIndicator | 0x04 | 항목에 선택 상태 표시기가 있음을 나타냅니다. |
QStyleOptionViewItem::HasDisplay | 0x08 | 항목에 표시 역할이 있음을 나타냅니다. |
QStyleOptionViewItem::HasDecoration | 0x10 | 항목에 장식 역할이 있음을 나타냅니다. |
QStyleOptionViewItem::IsDecoratedRootColumn (since Qt 6.9) | 0x20 | 항목에 그리기용 트리 뷰 브랜치 부분이 있음을 나타냅니다. |
QStyleOptionViewItem::IsDecorationForRootColumn (since Qt 6.9) | 0x40 | 항목에 트리 뷰 브랜치 부분을 그리는 데 필요한 정보가 포함되어 있음을 나타냅니다. |
ViewItemFeatures 유형은 QFlags<ViewItemFeature>에 대한 typedef입니다. 이 유형은 ViewItemFeature 값들의 OR 조합을 저장합니다.
enum QStyleOptionViewItem::ViewItemPosition
이 열거형은 행에서 항목의 위치를 나타내는 데 사용됩니다. 이를 통해 항목의 위치에 따라 서로 다른 방식으로 항목을 그릴 수 있습니다. 예를 들어, 시작과 끝 부분에는 둥근 모서리를, 그 사이에는 직선 모서리를 적용하는 식입니다.
| 상수 | 값 | 설명 |
|---|---|---|
QStyleOptionViewItem::Invalid | 0 | ViewItemPosition은 알 수 없으므로 무시해야 합니다. |
QStyleOptionViewItem::Beginning | 1 | 항목이 행의 맨 앞에 나타납니다. |
QStyleOptionViewItem::Middle | 2 | 항목이 행의 중간에 표시됩니다. |
QStyleOptionViewItem::End | 3 | 항목이 행의 끝에 표시됩니다. |
QStyleOptionViewItem::OnlyOne | 4 | 이 항목은 행에 유일한 항목이므로 행의 시작과 끝 모두에 위치합니다. |
멤버 함수 문서
QStyleOptionViewItem::QStyleOptionViewItem()
QStyleOptionViewItem 객체를 생성하고, 멤버 변수들을 기본값으로 초기화합니다.
QStyleOptionViewItem::QStyleOptionViewItem(const QStyleOptionViewItem &other)
other 스타일 옵션의 복사본을 생성합니다.
[noexcept default] QStyleOptionViewItem &QStyleOptionViewItem::operator=(const QStyleOptionViewItem &)
other 를 이 QStyleOptionViewItem 인스턴스에 복사-할당합니다.
멤버 변수 문서
QBrush QStyleOptionViewItem::backgroundBrush
뷰 항목의 배경을 채우는 데 사용해야 하는 QBrush 입니다.
Qt::CheckState QStyleOptionViewItem::checkState
이 뷰 항목이 선택 가능한 경우, 즉 ` ViewItemFeature::HasCheckIndicator `가 참인 경우, 항목이 선택되어 있으면 ` checkState `가 참이고, 그렇지 않으면 거짓입니다.
Qt::Alignment QStyleOptionViewItem::decorationAlignment
이 변수는 항목의 장식 정렬 방식을 저장합니다.
기본값은 ` Qt::AlignLeft`입니다.
QStyleOptionViewItem::Position QStyleOptionViewItem::decorationPosition
이 변수는 아이템의 장식 위치를 저장합니다.
기본값은 Left 입니다.
Position도 참조하십시오 .
QSize QStyleOptionViewItem::decorationSize
이 변수는 아이템의 장식 크기를 저장합니다.
기본값은 QSize(-1, -1)이며, 이는 유효하지 않은 크기입니다.
decorationAlignment 및 decorationPosition도 참조하십시오 .
Qt::Alignment QStyleOptionViewItem::displayAlignment
이 변수는 항목의 표시 값 정렬 방식을 저장합니다.
기본값은 Qt::AlignLeft 입니다.
QStyleOptionViewItem::ViewItemFeatures QStyleOptionViewItem::features
이 변수는 이 뷰 항목을 설명하는 특징들의 비트별 OR 연산 결과를 저장합니다.
ViewItemFeature도 참조하십시오 .
QFont QStyleOptionViewItem::font
이 변수는 항목에 사용되는 글꼴을 저장합니다.
기본적으로 응용 프로그램의 기본 글꼴이 사용됩니다.
QFont도 참조하십시오 .
QIcon QStyleOptionViewItem::icon
뷰 항목에 그려질 아이콘(있는 경우).
QModelIndex QStyleOptionViewItem::index
그릴 모델 인덱스입니다.
QLocale QStyleOptionViewItem::locale
이 변수는 텍스트, 숫자 및 날짜를 표시할 때 사용할 로케일을 저장합니다.
이를 통해 스타일은 예를 들어, 애플리케이션의 기본 로케일과 다른 로케일로 날짜를 표시할 수 있습니다.
bool QStyleOptionViewItem::showDecorationSelected
이 변수는 선택된 항목의 장식 요소를 강조 표시할지 여부를 나타냅니다.
이 옵션이 true인 경우, 선택된 항목의 분기 및 모든 장식 요소가 강조 표시되어 해당 항목이 선택되었음을 나타내야 하며, 그렇지 않은 경우 강조 표시가 필요하지 않습니다. 기본값은 false입니다.
QStyle::SH_ItemView_ShowDecorationSelected 및 QAbstractItemView도 참조하십시오 .
QString QStyleOptionViewItem::text
뷰 항목에 그려질 텍스트(있는 경우).
Qt::TextElideMode QStyleOptionViewItem::textElideMode
항목에 들어갈 수 없을 정도로 긴 텍스트의 경우, 해당 위치에 줄임표를 추가해야 합니다.
기본값은 Qt::ElideMiddle 이며, 즉 텍스트 중간에 줄임표가 표시됩니다.
Qt::TextElideMode 및 QStyle::SH_ItemView_EllipsisLocation도 참조하십시오 .
QStyleOptionViewItem::ViewItemPosition QStyleOptionViewItem::viewItemPosition
이 뷰 항목의 다른 항목에 대한 상대적 위치를 반환합니다. 자세한 내용은 ` ViewItemPosition ` 열거형을 참조하십시오.
const QWidget *QStyleOptionViewItem::widget
이 변수는 해당 항목의 상위 위젯을 저장합니다.
이 멤버는 해당 항목의 상위 위젯(itemview)을 포함하며, 이를 통해 예를 들어 ` QStyledItemDelegate ` 메서드 내에서 특정 속성에 접근할 수 있습니다.
© 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.
