文章目录
- 一、模型角色
- 1、角色的分类
- 2、角色的使用
- 3、示例
前言:
在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)