QStyleOptionViewItem 类

QStyleOptionViewItem 类用于描述在视图小部件中绘制项目时使用的参数。更多信息...

头文件	#include <QStyleOptionViewItem>
CMake	find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake	QT += widgets
继承	QStyleOption

包含所有成员的列表，包括继承的成员

公共类型

枚举	Position { Left, Right, Top, Bottom }
枚举	StyleOptionType { Type }
枚举	StyleOptionVersion { Version }
枚举	ViewItemFeature { None, WrapText, Alternate, HasCheckIndicator, HasDisplay, HasDecoration }
标志	ViewItemFeatures
枚举	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
bool	showDecorationSelected
QString	text
Qt::TextElideMode	textElideMode
QStyleOptionViewItem::ViewItemPosition	viewItemPosition

详细描述

QStyleOptionViewItem 包含了 QStyle 函数为 Qt 的模型/视图类绘制项目所需的所有信息。

出于性能原因，成员函数较少，成员变量访问是直接的（即使用 . 或 -> 操作符）。这使得结构的使用变得简单，并强调了这些只是由样式函数使用的参数。

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

成员类型文档

枚举 QStyleOptionViewItem::Position

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

常量	值	描述
`QStyleOptionViewItem::Left`	`0`	在文本的左侧。
`QStyleOptionViewItem::Right`	`1`	在文本的右侧。
`QStyleOptionViewItem::Top`	`2`	在文本上方。
`QStyleOptionViewItem::Bottom`	`3`	文本下面。

另请参见decorationPosition。

枚举 QStyleOptionViewItem::StyleOptionType

此枚举用于存储有关样式选项类型的信息，并且为每个 QStyleOption 子类定义。

常量	值	描述
`QStyleOptionViewItem::Type`	`SO_ViewItem`	提供的样式选项类型（对于此类是 SO_ViewItem）。

该类型由 QStyleOption、其子类和 qstyleoption_cast() 内部使用，以确定样式选项的类型。通常你不需要担心这一点，除非你想创建自己的 QStyleOption 子类和自定义样式。

另请参见StyleOptionVersion。

枚举 QStyleOptionViewItem::StyleOptionVersion

此枚举用于存储有关样式选项版本的信息，并且为每个 QStyleOption 子类定义。

常量	值	描述
`QStyleOptionViewItem::Version`	`1`	4

版本由 QStyleOption 子类用于在不破坏兼容性的情况下实现扩展。如果你使用 qstyleoption_cast()，通常你不需要检查它。

另请参见StyleOptionType。

枚举 QStyleOptionViewItem::ViewItemFeature
标志 QStyleOptionViewItem::ViewItemFeatures

此枚举描述了项目可以具有的不同类型的功能。

常量	值	描述
`QStyleOptionViewItem::None`	`0x00`	表示一个普通项目。
`QStyleOptionViewItem::WrapText`	`0x01`	表示具有换行文本的项目。
`QStyleOptionViewItem::Alternate`	`0x02`	表示使用 alternateBase 渲染项目背景。
`QStyleOptionViewItem::HasCheckIndicator`	`0x04`	表示项目具有复选状态指示器。
`QStyleOptionViewItem::HasDisplay`	`0x08`	表示项目具有显示角色。
`QStyleOptionViewItem::HasDecoration`	`0x10`	表示项目具有装饰角色。

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

枚举 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 样式选项的副本。

成员变量文档

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

此变量保存描述此视图项目的特征的按位或操作

另请参阅ViewItemFeature。

QFont QStyleOptionViewItem::font

此变量保存用于项目的字体

默认情况下，使用应用程序的默认字体。

另请参阅QFont。

QIcon QStyleOptionViewItem::icon

要在视图项目中绘制的图标（如果有的话）。

QModelIndex QStyleOptionViewItem::index

要绘制的模型索引。

bool QStyleOptionViewItem::showDecorationSelected

此变量保存装饰是否应在选中项上突出显示

如果此选项为真，则应突出显示分支和选中项上的任何装饰，表示该项目被选中；否则，不需要突出显示。默认值为假。

另请参阅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 枚举。