QStyleOptionViewItem Class

Header：#include < QStyleOptionViewItem >
qmake：QT += widgets
Inherits：QStyleOption

Public Types

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 }

Public Functions

QStyleOptionViewItem(const QStyleOptionViewItem &other)
QStyleOptionViewItem()

Public Variables

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

Detailed Description

QStyleOptionViewItem包含QStyle函数为Qt的模型/视图类绘制项目所需的所有信息。
出于性能考虑，对成员变量的访问是直接的(即，使用。或->运算符)。这种低级的感觉使结构易于使用，并强调这些结构只是样式函数使用的参数。
有关演示如何使用样式选项的示例，请参见Styles示例。
See also QStyleOption and Model/View Programming.

Member Type Documentation

enum QStyleOptionViewItem::Position
	这个枚举描述了物品装饰的位置。
Constant						Value		Description
QStyleOptionViewItem::Left		0			在文本的左边。
QStyleOptionViewItem::Right		1			在文本的右侧。
QStyleOptionViewItem::Top		2			上面的文字。
QStyleOptionViewItem::Bottom	3			在文本下面。

See also decorationPosition.

enum QStyleOptionViewItem::StyleOptionType
	这个枚举用于保存关于样式选项类型的信息，并且为每个QStyleOption子类定义。

Constant					Value			Description
QStyleOptionViewItem::Type	SO_ViewItem		所提供的样式选项的类型（该类的SO_ViewItem）。

	该类型由QStyleOption及其子类和qstyleoption_cast()在内部使用，以确定样式选项的类型。通常你不需要担心这个，除非你想创建你自己的QStyleOption子类和你自己的样式。
See also StyleOptionVersion.

enum QStyleOptionViewItem::StyleOptionVersion
	该枚举用于保存样式选项的版本信息，并为每个QStyleOption子类定义。

Constant						Value	Description
QStyleOptionViewItem::Version	4		4

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

See also StyleOptionType.

enum QStyleOptionViewItem::ViewItemFeature
flags QStyleOptionViewItem::ViewItemFeatures
	这个枚举描述了一个项目可以具有的不同类型的特性。

Constant								Value		Description
QStyleOptionViewItem::None				0x00		正常项。
QStyleOptionViewItem::WrapText			0x01		指示带有换行文本的项。
QStyleOptionViewItem::Alternate			0x02		指示使用alternateBase呈现项目的背景。
QStyleOptionViewItem::HasCheckIndicator	0x04		表示该项目有一个检查状态指示灯。
QStyleOptionViewItem::HasDisplay		0x08		指示该项具有显示角色。
QStyleOptionViewItem::HasDecoration		0x10		指示项目具有装饰角色。

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

enum QStyleOptionViewItem::ViewItemPosition
	此枚举用于表示项在一行中的位置。这可以用于根据物品的位置绘制不同的物品，例如，在开始和结束处放置圆形边缘，在中间放置直边。

Constant						Value	Description
QStyleOptionViewItem::Invalid	0		ViewItemPosition是未知的，应该忽略。
QStyleOptionViewItem::Beginning	1		项目显示在该行的开头。
QStyleOptionViewItem::Middle	2		项目显示在行中间。
QStyleOptionViewItem::End		3		项目显示在行末尾。
QStyleOptionViewItem::OnlyOne	4		该项是行中唯一的项，因此既位于开头，也位于末尾。

Member Function Documentation

QStyleOptionViewItem::QStyleOptionViewItem(const QStyleOptionViewItem &other)
	Constructs a copy of the other style option.

QStyleOptionViewItem::QStyleOptionViewItem()
	构造一个QStyleOptionViewItem，将成员变量初始化为默认值。

Member Variable Documentation

QBrush QStyleOptionViewItem::backgroundBrush
	应该用来绘制视图项目背景的QBrush

Qt::CheckState QStyleOptionViewItem::checkState
	如果这个视图项是可检查的，即ViewItemFeature::HasCheckIndicator为true，如果该视图项被检查，则checkState为true；否则为false。

Qt::Alignment QStyleOptionViewItem::decorationAlignment
	这个变量保存了项目的装饰对齐
	默认值为“Qt::AlignLeft”。

QStyleOptionViewItem::Position QStyleOptionViewItem::decorationPosition
	这个变量保存了物品的装饰位置
	默认值为“左”。
See also Position.

QSize QStyleOptionViewItem::decorationSize
	这个变量保存了物品装饰的大小
	默认值为QSize(-1, -1)，即无效大小。
See also decorationAlignment and decorationPosition.

Qt::Alignment QStyleOptionViewItem::displayAlignment
	该变量保存该项的显示值的对齐方式
	默认值为“Qt::AlignLeft”。

QStyleOptionViewItem::ViewItemFeatures QStyleOptionViewItem::features
	该变量保存描述该视图项的特性的位或
See also ViewItemFeature.

QFont QStyleOptionViewItem::font
	这个变量包含项目使用的字体
	默认情况下，使用应用程序的默认字体。
See also QFont.

QIcon QStyleOptionViewItem::icon
	要在视图项中绘制的图标（如果有的话）。

QModelIndex QStyleOptionViewItem::index
	要绘制的模型索引。

bool QStyleOptionViewItem::showDecorationSelected
	这个变量表示是否应该在选定的项目上突出显示装饰
	如果此选项为真，则所选物品上的分支和任何装饰应突出显示，表明该物品已被选中；否则，不需要突出显示。默认值为false。
See also QStyle::SH_ItemView_ShowDecorationSelected and QAbstractItemView.

QString QStyleOptionViewItem::text
	要在视图项中绘制的文本（如果有的话）。

Qt::TextElideMode QStyleOptionViewItem::textElideMode
	如果文本太长而无法放入条目中，应该在哪些地方添加省略号
	默认值是Qt::ElideMiddle，即省略号出现在文本的中间。
See also Qt::TextElideMode and QStyle::SH_ItemView_EllipsisLocation.

QStyleOptionViewItem::ViewItemPosition QStyleOptionViewItem::viewItemPosition
	给出此视图项相对于其他项的位置。详情请参见ViewItemPosition enum。