数据项角色的理解
数据项角色通俗来说就是数据项中保存的属性(如文本和图标)或者样式(字体和对齐方式)的类别，可以将其当做键-值对中的键，从而为对应的值赋值。
QStandardItemModel中的每一个数据项为QStandardItem。举个例子，人有很多属性，如性别：男；身高：180cm；体重：80kg；民族：藏族等，构建Person对象时可能使用struct来存储。
QStandardItem中也有很多属性可供设置，如设置显示文本(DisplayRole)、提示(ToolTipRole)、w文本前的图标(DecorationRole)等。
除了上述可以保存的属性外，还有部分属性用于设置QStandardItem显示的样式，如字体(FontRole)、文本对齐方式(TextAlignmentRole)等。
Qt资料领取→「链接」
数据项角色的分类
Qt帮助文档中将数据项角色分为三类：
- 内容设置
类型 | 功能 |
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 | 用于应用程序的特定目的(自己定义用途).用户自己决定使用什么数据,如何处理数据 |
数据项角色的测试
#include "mainwindow.h"
#include "ui_mainwindow.h"
#include
#include
MainWindow::MainWindow(QWidget *parent)
: QMainWindow(parent)
, ui(new Ui::MainWindow)
{
ui->setupUi(this);
theModel = new QStandardItemModel(1, 2, this);
ui->tableView->setModel(theModel);
QPixmap pix;
pix.load("C:\\Users\\wsw\\Desktop\\2.png");
pix.scaledToWidth(20);
pix.scaledToHeight(20);
QModelIndex index = theModel->index(0, 0);
theModel->setData(index, "124", Qt::DisplayRole);//设置文本
theModel->setData(index, pix, Qt::DecorationRole);//设置标签图片
theModel->setData(index, "tips", Qt::ToolTipRole);//设置提示
theModel->setData(index, Qt::AlignRight, Qt::TextAlignmentRole);//设置文本对齐方式
QStandardItem* item = theModel->itemFromIndex(index);//设置数据项中包含勾选框
item->setCheckable(true);
item->setData(Qt::Checked, Qt::CheckStateRole);
// item->setWhatsThis("what'sThis");
// item->setData("what?", Qt::WhatsThisRole); //在Dialog中能起作用，Dialog标题栏中有?，点击?后鼠标变为问号鼠标，再点击当前项会出现黄色框
//设置字体
QFont font;
font.setBold(true);
font.setPixelSize(24);
font.setFamily("Microsoft YaHei");
font.setItalic(true);
theModel->setData(index, font, Qt::FontRole);
}
MainWindow::~MainWindow()
{
delete ui;
}
文章转自博客园（YueLiGo）：https://www.cnblogs.com/wsw2022/p/17078613.html
Qt资料领取→「链接」