QStyleOptionViewItem Class
QStyleOptionViewItem 클래스는 뷰 위젯에서 항목을 그리는 데 사용되는 매개 변수를 설명하는 데 사용됩니다. 더 보기...
| Header: | #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, HasDecoration } |
| flags | ViewItemFeatures |
| enum | ViewItemPosition { Invalid, Beginning, Middle, End, OnlyOne } |
공용 함수
| QStyleOptionViewItem() | |
| QStyleOptionViewItem(const QStyleOptionViewItem &other) |
공용 변수
| 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
이 열거형은 아이템의 장식 위치를 설명합니다.
| Constant | 값 | 설명 |
|---|---|---|
QStyleOptionViewItem::Left | 0 | 텍스트 왼쪽. |
QStyleOptionViewItem::Right | 1 | 텍스트 오른쪽. |
QStyleOptionViewItem::Top | 2 | 텍스트 위. |
QStyleOptionViewItem::Bottom | 3 | 텍스트 아래에 있습니다. |
decorationPosition 를참조하십시오 .
enum QStyleOptionViewItem::StyleOptionType
이 열거형은 스타일 옵션의 유형에 대한 정보를 저장하는 데 사용되며 각 QStyleOption 하위 클래스마다 정의됩니다.
| Constant | 값 | 설명 |
|---|---|---|
QStyleOptionViewItem::Type | SO_ViewItem | 제공되는 스타일 옵션의 유형입니다(이 클래스의 경우SO_ViewItem ). |
이 유형은 QStyleOption, 그 하위 클래스 및 qstyleoption_cast()에서 스타일 옵션의 유형을 결정하기 위해 내부적으로 사용됩니다. 일반적으로 자체 QStyleOption 하위 클래스와 자체 스타일을 만들려는 경우가 아니라면 이에 대해 걱정할 필요가 없습니다.
StyleOptionVersion 를참조하세요 .
enum QStyleOptionViewItem::StyleOptionVersion
이 열거형은 스타일 옵션의 버전에 대한 정보를 저장하는 데 사용되며 각 QStyleOption 서브클래스에 대해 정의됩니다.
| Constant | 값 | 설명 |
|---|---|---|
QStyleOptionViewItem::Version | 1 | 4 |
이 버전은 호환성을 깨지 않고 확장을 구현하기 위해 QStyleOption 서브클래스에서 사용됩니다. qstyleoption_cast ()를 사용하는 경우 일반적으로 확인할 필요가 없습니다.
StyleOptionType 를참조하세요 .
열거형 Q스타일 옵션 뷰 아이템::뷰 아이템 기능
플래그 Q스타일 옵션 뷰 아이템::뷰 아이템 기능
이 열거형은 항목이 가질 수 있는 다양한 유형의 기능을 설명합니다.
| Constant | 값 | 설명 |
|---|---|---|
QStyleOptionViewItem::None | 0x00 | 일반 항목을 나타냅니다. |
QStyleOptionViewItem::WrapText | 0x01 | 줄 바꿈 텍스트가 있는 항목을 나타냅니다. |
QStyleOptionViewItem::Alternate | 0x02 | 항목의 배경이 대체베이스를 사용하여 렌더링되었음을 나타냅니다. |
QStyleOptionViewItem::HasCheckIndicator | 0x04 | 항목에 체크 상태 표시기가 있음을 나타냅니다. |
QStyleOptionViewItem::HasDisplay | 0x08 | 항목에 표시 역할이 있음을 나타냅니다. |
QStyleOptionViewItem::HasDecoration | 0x10 | 항목에 장식 역할이 있음을 나타냅니다. |
ViewItemFeatures 유형은 QFlags<ViewItemFeature>에 대한 typedef입니다. 뷰아이템기능 값의 OR 조합을 저장합니다.
enum QStyleOptionViewItem::ViewItemPosition
이 열거형은 행에 있는 항목의 배치를 나타내는 데 사용됩니다. 예를 들어 시작과 끝에는 둥근 모서리를, 그 사이에는 직선 모서리를 배치하는 등 항목의 배치에 따라 항목을 다르게 그리는 데 사용할 수 있습니다.
| 상수 | 값 | 설명 |
|---|---|---|
QStyleOptionViewItem::Invalid | 0 | ViewItemPosition은 알 수 없으므로 무시해야 합니다. |
QStyleOptionViewItem::Beginning | 1 | 항목이 행의 시작 부분에 표시됩니다. |
QStyleOptionViewItem::Middle | 2 | 항목이 행의 중간에 표시됩니다. |
QStyleOptionViewItem::End | 3 | 항목이 행 끝에 표시됩니다. |
QStyleOptionViewItem::OnlyOne | 4 | 항목이 행에 있는 유일한 항목이므로 시작과 끝에 모두 표시됩니다. |
멤버 함수 문서
QStyleOptionViewItem::QStyleOptionViewItem()
멤버 변수를 기본값으로 초기화하여 Q스타일옵션뷰아이템을 생성합니다.
QStyleOptionViewItem::QStyleOptionViewItem(const QStyleOptionViewItem &other)
other 스타일 옵션의 복사본을 생성합니다.
멤버 변수 문서
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
이 변수는 항목의 부모 위젯을 보유합니다.
이 멤버에는 예를 들어 QStyledItemDelegate 메서드 내에서 일부 프로퍼티에 액세스할 수 있는 항목의 부모 위젯(itemview)이 포함됩니다.
© 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.
