转载：https://blog.csdn.net/czyt1988/article/details/26018513
1.概述
QTreeView最长用的一个功能就是作为导航栏，像vs里的项目结构树，word的文档结构图，资源管理器的文档结构，等等都是利用树形结构组织的，在前面已经讲述了Qt中使用标准化项目模型QStandardItemModel对树形控件节点的操作。但有时候，光有节点显示还是不够的，还需要和用户进行交互，如右键点击不同条目会出现不同菜单，这时就需要知道各个节点对应的功能。
在MFC里，树形控件CTreeCtrl是通过SetItemData函数来对节点设置一个指针的值，这个值可以是个指针或者DWORD值，可以设置一个自定义的标志，或者自定义类型的指针。Qt的TreeView比MFC的CTreeCtrl封装的更好，其功能更为强大，以至于它可以给每个节点设定非常非常多的值（只要你内存足够）。
QTreeView只负责显示渲染，数据都是Model来负责管理，Model和Item构成整个结构，具体可见第一篇。
在有了节点后我想对某些进行标记，需要用到setData函数。Qt中的mvc结构非常复杂，setData函数在model和item中都有，功能都一样，就QStandardItemModel来说，setData函数的定义为：
virtual bool setData(const QModelIndex & index, const QVariant & value, int role = Qt::EditRole);
在QStandardItem中setData定义为
virtual void setData(const QVariant & value, int role = Qt::UserRole + 1);
通常使用的是QStandardItem的版本。
下面详细说说这个函数。
2.使用Role对QStandardItem设定值
setData函数就是给这个item设置一个QVariant的值，但是，这个函数有两个参数，第一个QVariant自然是需要设置的值，另一个是一个int型数据，Qt中把这个称为role角色，所谓角色，是指设定进item的这个Qvariant所扮演的角色，实际就是对设定值的标定，因为item可以设置许多值，这就需要一个用以区分的标志，这个区分标志就叫角色。
Qt已经把经常用到的角色内容定义好了，我们可以自己定义角色标志，但不能和定义好的那些冲突，否则会不起作用。如要显示文字用Qt::DisplayRole，要告诉QTreeView需要改变背景颜色，就标定Qt::BackgroundRole，要改变字体就标定Qt::FontRole等等。从中可以看出，role就是一个标示，用来标定存放在item里面的值具体用于什么功能，系统默认的role见Qt::ItemDataRole枚举。
Qt默认role其实就是一组宏（原理和MFC的消息类型一模一样），那怎么知道能不和Qt预先定义好的不起冲突呢，同MFC自定义消息一样，Qt要自定义角色，就从Qt::UserRole开始往上加。
例如，我做个类似于vs或Qt Creator的项目结构树，结构树里许多节点的功能不一样有节点代表文件夹，有的节点是cpp文件，有的节点是.h文件，如果要知道用户点击的当前节点是什么内容，就需要给节点一些额外的标志。
下面用个例子来演示。
此例子用来复现Qt Creator的项目结构树
项目结构树节点主要有“根节点”，“文件夹节点”，“条目节点”这三种，于是可以定义一个role来对这三种情况做判别。
另外，“文件夹节点”又分为“cpp文件夹”，“h文件夹”等节点，这个也可以使用一个role作为区分。
“条目节点”有可能也会有h文件，cpp文件，或者其他文件之分，这里也可以使用一个role进行区分。
于是，这里就建立三个自定义role
#define ROLE_MARK Qt::UserRole + 1
#define ROLE_MARK_FOLDER Qt::UserRole + 2
#define ROLE_MARK_ITEM Qt::UserRole + 3
这三个role中，ROLE_MARK用于区分 “根节点”，“文件夹节点”，“条目节点”这三种情况。
ROLE_MARK_FOLDER用于区分“cpp文件夹”，“h文件夹”等情况。
ROLE_MARK_ITEM用于区分“条目节点”有可能出现的种类。
当然，对于这种比较少的区分，用一个int型变量进行位的或与操作来判断也是可以的，但这里主要为了演示role的使用方法。
下面在为三种role定义值，定义如下