Qt 实战（10）模型视图 | 10.4、模型角色

前言：

在Qt的模型/视图架构中，模型中的每个数据元素都不仅仅包含数据本身，还包含多种角色（Role）。角色可以理解为数据项中保存的属性或样式的类别，可以将其视为键-值对中的键，用于存储和检索数据的不同方面。Qt通过提供丰富的角色来支持数据的多样化表示和编辑。

一、模型角色

1、角色的分类

当视图View向模型Model索要数据时，不仅要提供索引 index，还必须要提供角色role。index和role共同决定出视图到底在向Model请求哪个数据。Qt当前提供了22个角色，下面介绍下这些角色的用法，如下：

内容设置：

类型	功能
DisplayRole	主要用于以文本的形式显示数据 QString
EditRole	可用于文本数据的编辑 (QString)
DecorationRole	可以将数据通过图标的方式呈现出来 (QColor、QIcon、QPixmap)
ToolTipRole	实现当鼠标处于选中的数据时，显示出数据的相关提示(QString)
StatusTipRole	在状态栏显示提示的数据(QString)
WhatsThisRole	可以通过选中数据摁下快捷键shift+F1来显示提示(QString)
SizeHintRole	可以提示相应大小(QSize)

样式设置：

类型	功能
FontRole	可以改变数据的字体
TextAlignmentRole	可以将文本的位置进行居中、居左居右调整
BackgroundColorRole	可以改变背景色
TextColorRole	设置文字颜色
ForegroundRole	可以改变前景色
CheckStateRole	在某列中设置了CheckStateRole角色后，设置的列则可以显示出一个CheckBox
InitialSortOrderRole	标题视图初始排序顺序

其他：

类型	功能
AccessibleTextRole	用于辅助功能和插件扩展的文本(如屏幕阅读器)
AccessibleDescriptionRole	用于无障碍项目的描述
UserRole	用于应用程序的特定目的(自己定义用途).用户自己决定使用什么数据,如何处理数据

2、角色的使用

在Qt的模型/视图架构中，角色通过模型的setData()和data()等函数与视图进行交互。视图通过指定索引和角色来请求或设置模型中的数据。模型则根据请求返回相应的数据或执行相应的操作。如下：

// 获取模型数据
virtual QVariant QAbstractItemModel::data(const QModelIndex &index, int role = Qt::DisplayRole) const = 0

// 修改模型数据
virtual bool QAbstractItemModel::setData(const QModelIndex &index, const QVariant &value, int role = Qt::EditRole)

3、示例