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, …, IsDecorationForRootColumn }
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 的模型/视图类绘制项目所需的所有信息。

出于性能方面的考虑,QStyleOptionViewItem 的成员函数很少,而且对成员变量的访问是直接的(即使用.-> 操作符)。这使得这些结构使用起来非常简单,并强调这些结构只是样式函数使用的参数。

另请参阅 QStyleOption模型/视图编程

成员类型文档

enum QStyleOptionViewItem::Position

该枚举描述了项目装饰的位置。

常数说明
QStyleOptionViewItem::Left0在文本左侧
QStyleOptionViewItem::Right1在文本的右侧。
QStyleOptionViewItem::Top2文本上方。
QStyleOptionViewItem::Bottom3文本下方。

另请参见 decorationPosition

enum QStyleOptionViewItem::StyleOptionType

该枚举用于保存有关样式选项类型的信息,并为每个QStyleOption 子类定义。

常量描述
QStyleOptionViewItem::TypeSO_ViewItem提供的样式选项的类型(SO_ViewItem 适用于该类)。

QStyleOption 及其子类和qstyleoption_cast() 内部使用该类型来确定样式选项的类型。一般来说,除非您想创建自己的QStyleOption 子类和自己的样式,否则不需要担心这个问题。

另请参见 StyleOptionVersion

enum QStyleOptionViewItem::StyleOptionVersion

该枚举用于保存有关样式选项版本的信息,并为每个QStyleOption 子类定义。

常量说明
QStyleOptionViewItem::Version14

QStyleOption 子类使用该版本实现扩展而不会破坏兼容性。如果使用qstyleoption_cast() ,通常不需要检查它。

另请参阅 StyleOptionType

枚举 QStyleOptionViewItem::ViewItemFeature
flags QStyleOptionViewItem::ViewItemFeatures

该枚举描述了一个项目可以具有的不同类型的特征。

常量说明
QStyleOptionViewItem::None0x00表示普通项目。
QStyleOptionViewItem::WrapText0x01表示带有包装文本的项目。
QStyleOptionViewItem::Alternate0x02表示项目的背景是使用 alternateBase 渲染的。
QStyleOptionViewItem::HasCheckIndicator0x04表示项目具有检查状态指示器。
QStyleOptionViewItem::HasDisplay0x08表示该项目具有显示角色。
QStyleOptionViewItem::HasDecoration0x10表示该项目具有装饰作用。
QStyleOptionViewItem::IsDecoratedRootColumn (since Qt 6.9)0x20表示该项目具有树形视图分支部分,用于绘制。
QStyleOptionViewItem::IsDecorationForRootColumn (since Qt 6.9)0x40表示该项目包含绘制树形视图分支部分的信息。

ViewItemFeatures 类型是QFlags<ViewItemFeature> 的类型定义。它存储 ViewItemFeature 值的 OR 组合。

enum QStyleOptionViewItem::ViewItemPosition

该枚举用于表示项目在一行中的位置。这可用于根据项目的位置以不同的方式绘制项目,例如在开头和结尾放置圆边,在中间放置直边。

常数说明
QStyleOptionViewItem::Invalid0ViewItemPosition 未知,应忽略。
QStyleOptionViewItem::Beginning1项目出现在行的开头。
QStyleOptionViewItem::Middle2项目出现在行的中间。
QStyleOptionViewItem::End3项目出现在行尾。
QStyleOptionViewItem::OnlyOne4该项目是行中唯一的项目,因此既在行首也在行尾。

成员函数文档

QStyleOptionViewItem::QStyleOptionViewItem()

构造一个 QStyleOptionViewItem,将成员变量初始化为默认值。

QStyleOptionViewItem::QStyleOptionViewItem(const QStyleOptionViewItem &other)

构建other 样式选项的副本。

成员变量文档

QBrush QStyleOptionViewItem::backgroundBrush

用于绘制视图项背景的QBrush

Qt::CheckState QStyleOptionViewItem::checkState

如果该视图项目是可选中的(即 ViewItemFeature::HasCheckIndicator 为 true),则checkState 在项目被选中时为 true;否则为 false。

Qt::Alignment QStyleOptionViewItem::decorationAlignment

该变量用于保存项目装饰的对齐方式。

默认值为Qt::AlignLeft

QStyleOptionViewItem::Position QStyleOptionViewItem::decorationPosition

该变量用于保存项目装饰的位置。

默认值为Left

另请参阅 Position

QSize QStyleOptionViewItem::decorationSize

该变量用于保存项目装饰的大小。

默认值为QSize(-1, -1), 即无效大小。

另请参阅 decorationAlignmentdecorationPosition

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",则应高亮显示选中项上的分支和任何装饰,以表明该项目已被选中;否则,无需高亮显示。默认值为假。

另请参阅 QStyle::SH_ItemView_ShowDecorationSelectedQAbstractItemView

QString QStyleOptionViewItem::text

要在视图项中绘制的文本(如果有)。

Qt::TextElideMode QStyleOptionViewItem::textElideMode

如果文本太长,无法放入项目中,则应在此处添加省略号

默认值为Qt::ElideMiddle ,即省略号出现在文本中间。

另请参阅 Qt::TextElideModeQStyle::SH_ItemView_EllipsisLocation

QStyleOptionViewItem::ViewItemPosition QStyleOptionViewItem::viewItemPosition

给出该视图项目相对于其他项目的位置。详情请查看ViewItemPosition 枚举。

const QWidget *QStyleOptionViewItem::widget

该变量包含项目的父窗口部件

该成员包含项目的父窗口部件(itemview),以便在QStyledItemDelegate 方法中访问某些属性。

© 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.