文档章节

QStandardItemModel角色控制及QTreeView添加不同的右键菜单

尘中远
 尘中远
发布于 2016/05/12 23:54
字数 3311
阅读 29
收藏 0
点赞 2
评论 0

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定义值,定义如下
//对应ROLE_MARK
# define MARK_PROJECT  1  //这是总项目标记
# define MARK_FOLDER  2  //这是文件夹标记
# define MARK_ITEM  3  //条目标记
 
//对应ROLE_MARK_FOLDER,标记folder种类
# define MARK_FOLDER_H  1  //头文件文件夹标记
# define MARK_FOLDER_CPP  2  //cpp文件文件夹标记
 
//对应ROLE_MARK_ITEM标记item种类
# define MARK_ITEM_H  1  //头文件条目
# define MARK_ITEM_CPP  2  //cpp文件条目

前期做完,下面开始实现程序
简单界面如下:


加上图标文件



树形视图的初始化:
void Widget::init()
{
    QStandardItemModel* model = new QStandardItemModel(ui->treeView);
    model->setHorizontalHeaderLabels(QStringList()<<QStringLiteral("项目"));
    //添加项目文件夹
    QStandardItem* root = new QStandardItem(QIcon(":/icon/icon/p.png"),QStringLiteral("项目"));
    root->setData(MARK_PROJECT,ROLE_MARK);//首先它是项目中目录
    root->setData(MARK_FOLDER,ROLE_MARK_FOLDER);//其次它属于文件夹
    model->appendRow(root);
    QStandardItem* folder = new QStandardItem(QIcon(":/icon/icon/h-f.png"),QStringLiteral("头文件"));
    folder->setData(MARK_FOLDER,ROLE_MARK);//首先它是文件夹
    folder->setData(MARK_FOLDER_H,ROLE_MARK_FOLDER);//其次它属于头文件文件夹
    root->appendRow(folder);
    folder = new QStandardItem(QIcon(":/icon/icon/c-f.png"),QStringLiteral("源文件"));
    folder->setData(MARK_FOLDER,ROLE_MARK);//首先它是文件夹
    folder->setData(MARK_FOLDER_CPP,ROLE_MARK_FOLDER);//其次它属于源文件文件夹
    root->appendRow(folder);
    ui->treeView->setModel(model);
}

在添加条目时,给一些特别的条目设定标志,如头文件文件夹,因为它是文件夹,因此首先给它设定角色为ROLE_MARK的值MARK_FOLDER,其次它在文件夹中属于头文件文件夹,因此再给他设定角色为ROLE_MARK_FOLDER的值MARK_FOLDER_H。这时,这个条目就有两个额外的值用于特殊的判断。
上面代码运行界面如下图所示:



当添加头文件时,需要在头文件文件夹加入条目,按钮“添加h”就是用来模拟添加头文件的过程。
添加头文件时,首先需要找到“头文件”这个文件夹对应的QStandardItem*,实现如函数 getHeaderFolder,此函数实现需要先找到“项目”这个顶层文件夹,具体实现如下:
 
QStandardItemModel* Widget::getTreeModel()
{
    return qobject_cast<QStandardItemModel*>(ui->treeView->model());
}
 
QList<QStandardItem*> Widget::getRoots()
{
    QList<QStandardItem*> roots;
    QStandardItemModel* model = getTreeModel();
    for(int i=0;i < model->rowCount();++i)
    {
        roots.append(model->item(i));
    }
    return roots;
}

QStandardItem* Widget::getProjectFolder()
{
    QList<QStandardItem*> roots = getRoots();
    for(auto i=roots.begin();i!=roots.end();++i){
        if((*i)->data(ROLE_MARK) == MARK_PROJECT){
            return (*i);
        }
    }
    return nullptr;
}

QStandardItem* Widget::getHeaderFolder()
{
    QStandardItem* project = getProjectFolder();
    if(nullptr == project)
        return nullptr;
    for(int i=0;i < project->rowCount();++i)
    {
        QStandardItem* child = project->child(i);
        QVariant var = child->data(ROLE_MARK_FOLDER);
        if(!var.isValid())
            continue;//说明不是ROLE_MARK_FOLDER,有可能是一些项目,对应项目结构树那个xxx.pro就是一个非文件夹条目
        if(MARK_FOLDER_H == var.value<int>())
            return child;
    }
    return nullptr;
}
 
QStandardItem* Widget::getSrcFolder()
{
    QStandardItem* project = getProjectFolder();
    if(nullptr == project)
        return nullptr;
    for(int i=0;i < project->rowCount();++i)
    {
        QStandardItem* child = project->child(i);
        QVariant var = child->data(ROLE_MARK_FOLDER);
        if(!var.isValid())
            continue;//说明不是ROLE_MARK_FOLDER,有可能是一些项目,对应项目结构树那个xxx.pro就是一个非文件夹条目
        if(MARK_FOLDER_CPP == var.value<int>())
            return child;
    }
    return nullptr;
}

getTreeModel用于获取treeView的model;
getRoots用于获取所有根节点;
getProjectFolder用于获取“项目文件夹”;
getHeaderFolder用于获取“头文件文件夹”;
getSrcFolder用于获取“源文件文件夹”;
主要使用了 data函数,函数声明如下:
QVariant QStandardItem : :data( int role  = Qt : :UserRole  +  1const
它会根据role,返回对应的QVariant,如果没有这个role,返回的 QVariant会是不可用,可以通过 QVariant的函数 isValid进行判断。
QVariant函数内部的值需要先转换,转换可以使用toInt函数或者使用一个通用的模板函数value。

下面看看按钮“添加头文件”的实现:
void Widget::on_pushButton_clicked()
{
    static int s_header_count = 1;
    //找到头文件文件夹
    QStandardItem* headerFolder = getHeaderFolder();
    if(headerFolder)
    {
        QStandardItem* item = new QStandardItem(QIcon(":/icon/icon/i.png")
                                                ,QStringLiteral("%1.h").arg(s_header_count));
        item->setData(MARK_ITEM,ROLE_MARK);//首先标定条目的类型 - 文件夹、项目、条目…
        item->setData(MARK_ITEM_H,ROLE_MARK_ITEM);//再次标定项目的类型
        headerFolder->appendRow(item);
        ++s_header_count;
    }
}

首先找到对应的头文件文件夹,然后再在这问件夹下添加文件。运行效果如下图:

3.给树形视图设置右键菜单

树形视图最大的优点是有清晰的逻辑关系,可以明显的看出每个条目的父子关系,对于大型工程来说显得尤为重要。由于条目之间功能不同,对条目的操作也会有不同的响应。例如,Qt Creator的项目结构树,对顶层跟项目点右键和对其它节点点右键是弹出不同的菜单的,如下图所示


这里涉及到两个方面,一个是给QTreeView添加菜单,另一个是对右击的节点进行判断。
给QtreeView添加右键菜单,首先需要把contextMenuPolicy属性设置为:CustomContextMenu。

在ui 编辑器中右击QTreeView,选择转到槽

选择customContextMenuRequested(QPointpos)信号

这时,会自动添加对应的槽函数:
void Widget::on_treeView_customContextMenuRequested(const QPoint &pos)
{
 
}

当然也可以使用代码添加!
此槽函数接收一个点坐标,用于标定点击的方位,可以使用 indexAt函数来获取具体点击的条目。
virtual QModelIndex    indexAt( const QPoint  & point)  const
在添加Menu前先要创建menu。声明两个menu的成员变量,记得添加对应的头文件
# include  <QMenu >
# include  <QAction >

QMenu * m_projectMenu;
QMenu * m_itemMenu;
在构造函数中创建menu
m_projectMenu = new QMenu(this);
    m_itemMenu = new QMenu(this);
 
    QAction* ac = nullptr;
    ac = new QAction(QStringLiteral("构建"),this);
    m_projectMenu->addAction(ac);
 
    ac = new QAction(QStringLiteral("执行qmake"),this);
    m_projectMenu->addAction(ac);
 
    ac = new QAction(QStringLiteral("部署"),this);
    ac->setEnabled(false);
    m_projectMenu->addAction(ac);
 
    ac = new QAction(QStringLiteral("运行"),this);
    m_projectMenu->addAction(ac);
 
    m_projectMenu->addSeparator();
 
    ac = new QAction(QStringLiteral("重新构建"),this);
    m_projectMenu->addAction(ac);
 
    ac = new QAction(QStringLiteral("清除"),this);
    m_projectMenu->addAction(ac);
 
    m_projectMenu->addSeparator();
 
    ac = new QAction(QStringLiteral("添加新文件……"),this);
    m_projectMenu->addAction(ac);
 
    ac = new QAction(QStringLiteral("余下的省略……"),this);
    m_projectMenu->addAction(ac);
 
    //
 
    ac = new QAction(QStringLiteral("打开文件"),this);
    m_itemMenu->addAction(ac);
    ac = new QAction(QStringLiteral("在explorer中显示"),this);
    m_itemMenu->addAction(ac);
    ac = new QAction(QStringLiteral("在此弹出命令提示"),this);
    m_itemMenu->addAction(ac);
 
    QMenu* itemChildMenu = new QMenu(m_itemMenu);
    itemChildMenu->setTitle(QStringLiteral("用…打开"));
    ac = new QAction(QStringLiteral("C++编辑器"),this);
    itemChildMenu->addAction(ac);
    ac = new QAction(QStringLiteral("普通文本编辑器"),this);
    itemChildMenu->addAction(ac);
    ac = new QAction(QStringLiteral("二进制编辑器"),this);
    itemChildMenu->addAction(ac);
    ac = new QAction(QStringLiteral("System Editor"),this);
    itemChildMenu->addAction(ac);
 
    m_itemMenu->addAction(itemChildMenu->menuAction());
 
    ac = new QAction(QStringLiteral("余下省略n条"),this);
    m_itemMenu->addAction(ac);

on_treeView_customContextMenuRequested槽函数具体实现代码如下:
void Widget::on_treeView_customContextMenuRequested(const QPoint &pos)
{
    QModelIndex index = ui->treeView->indexAt(pos);
    QVariant var = index.data(ROLE_MARK);
    if(var.isValid())
    {
        if(MARK_PROJECT == var.toInt())
            m_projectMenu->exec(QCursor::pos());//弹出右键菜单,菜单位置为光标位置
        else if(MARK_ITEM == var.toInt())
            m_itemMenu->exec(QCursor::pos());
    }
}

首先用indexAt获取当前点击条目的QModelIndex。通过QModelIndex获取条目的data,QTreeView的data可以通过model,item,index三者任意一个获取,非常方便。
之前对项目和条目通过ROLE_MARK角色做过标记,只要判断ROLE_MARK角色,就可以区分点击的是根节点项目还是任意一个条目。具体效果见下图





4.系统role的使用

在设定data时,需要制定角色,而自定义角色都是从 Qt::UserRole开始往上延伸的,那么 Qt::UserRole之前的那些内容是什么呢。Qt为我们定义了一些常用的角色,在 Qt::ItemDataRole枚举中。在Qt说明文档中有详细说明(比较懒不想copy,截了一个图)



我们最常用的就是Qt::DisplayRole,也许你用QStandardItemModel从来都不会在代码中用到它,但是,在显示文字过程中,都会调用此role的值。
只要给这些系统role复制,在视图上就会有对应的效果。
如Qt::BackgroundRole用于设置背景色,只要调用setData时把role设置为 Qt::BackgroundRole,同时传入的值为一个颜色值,那么它就会在设置背景颜色。
void Widget::on_pushButton_3_clicked()
{
    QModelIndex index = ui->treeView->currentIndex();
    if(!index.isValid())
        return;
    getTreeModel()->itemFromIndex(index)->setData(QColor(232,209,57,200),Qt::BackgroundRole);
}

效果如下:


Qt::ToolTipRole用于给条目添加额外的说明
在根节点加入一个额外说明如下:
void Widget::init()
{
    QStandardItemModel* model = new QStandardItemModel(ui->treeView);
    model->setHorizontalHeaderLabels(QStringList()<<QStringLiteral("项目"));
 
    //添加项目文件夹
    QStandardItem* root = new QStandardItem(QIcon(":/icon/icon/p.png"),QStringLiteral("项目"));
    root->setData(MARK_PROJECT,ROLE_MARK);//首先它是项目中目录
    root->setData(MARK_FOLDER,ROLE_MARK_FOLDER);//其次它属于文件夹
    root->setData(
                QStringLiteral("这是关于QStandardItemModel设定角色的教程\n详细介绍见:http://blog.csdn.net/czyt1988/article/details/26018513")
                ,Qt::ToolTipRole
                );
 ……
 }

效果如图所示:

Qt::TextColorRole用于改变文字颜色,Qt::TextAlignmentRole改变对齐方式,Qt::FontRole控制字体等等,这里不一一介绍。

ps:
高亮背景后需要把高亮取消,就需要遍历所有子节点,并把设置有Qt::BackgroundRole角色的data设置为QVariant();具体遍历见 http://blog.csdn.net/czyt1988/article/details/21093451使用了C++11的一些新特性。
void Widget::on_pushButton_4_clicked()
{
    //涉及到遍历,因此使用回调函数,把遍历需要执行的函数传给封装好的遍历
    StandardItemModelEx::ergodicAllItem(getTreeModel()
                   ,std::bind(&Widget::callback_clearColor,this,std::placeholders::_1));
}
 
void Widget::callback_clearColor(QStandardItem* item)
{
    item->setData(QVariant(),Qt::BackgroundRole);
}

demo代码: http://download.csdn.net/detail/czyt1988/7368399



© 著作权归作者所有

共有 人打赏支持
尘中远
粉丝 1
博文 26
码字总数 47436
作品 0
朝阳
程序员
QListView,QTreeView和 QStandardItemModel的简单使用 (转...

include "testqstandarditemmodel.h" #include <QtGui/QApplication> //int main(int argc, char *argv[]) //{ // QApplication a(argc, argv); // testQStandardItemModel w; // w.show(); ......

王敬哲 ⋅ 2013/08/26 ⋅ 0

Qt实现QTreeView的index Clicked事件

重新实现了QSplitter, 给这个控件添加了一个QListView和QTreeView,把QSplitter作为 QMainWindow的CentralWidget; 现在实现一个类似于资源管理器的界面,单击左边的QTreeView 的item可以实现...

yuan1024 ⋅ 2013/05/11 ⋅ 1

PyQt5系列教程(30): 文本输入栏(QLineEdit)4

这期我们继续介绍一下文本输入栏(QLineEdit),我们已经介绍了其常用属性、信号、函数还有自定义密码输入框,今天是最后一章,文本框自动补全。 若我们想用到QLineEdit自动补全的功能,必须...

学点编程吧 ⋅ 03/02 ⋅ 0

QT开发(四)—— 项目实战:学生管理系统,QMessageBox,QTableView和QFile的使用

Hello,大家好,我们又开始来学习新的QT小项目了,这个项目就是学生管理系统,我也是在网易云的课堂上学习的哦,如果想看效果图的直接滑到文章的最下面即可 我们首先说一下,这个项目的组成是...

qq_26787115 ⋅ 04/12 ⋅ 0

基于DotNet构件技术的企业级敏捷软件开发平台 - AgileEAS.NET平台开发指南 - 系统管理使用教程

前言 所谓AgileEAS.NET平台系统管理即指AgiLeEAS.NET平台中用于完成插件的发现、安装、配置及组织管理功能的一组具体应用,以及提供的基于AgileEAS.NET平台的应用系统所提供的一组基础应用如...

agilelab ⋅ 2010/09/09 ⋅ 0

Qt控件上下布局,根据数据量自己扩充功能。

我要在固定大小的窗口里添加两个QTreeView控件,用QVBoxLayout进行上下布局。 要求两个QTreeView控件都要展开,以便用户查阅。而展开的时候每个控制不够显示全部内容。 现在有一个需求就是,...

临峰不畏 ⋅ 2013/12/24 ⋅ 2

Windows Server 2012共享文件夹应用设置

Windows Server 2012共享文件夹应用设置 作者:lhjdark 发布日期:2013-06-20 08:36:38 目标: 建立一个共享文件夹,在这个文件夹内对应每个用户分别建立各自子文件夹,每人只访问自己有权限...

studyid ⋅ 2016/06/06 ⋅ 0

Winform开发框架之权限管理系统功能介绍

权限管理系统的重要特性总结: 1) 高度集成的权限系统、独立模块,能快速整合使用。 2) 符合权限的国际通用标准,基于RBAC(基于角色的访问控制)的角色权限控制。 3) 多数据库架构支持,...

walb呀 ⋅ 2017/12/04 ⋅ 0

【JEECG技术文档】JEECG部门管理员操作手册

功能介绍 使用部门管理员设置需要完成以下步骤: 1. 在“部门管理员设置”菜单配置权限以及分配管理员。 2. 在“部门角色管理”菜单配置角色,以及权限。 3. 在“部门用户角色授权”菜单分配...

Jeecg ⋅ 02/05 ⋅ 0

【JEECG技术文档】JEECG部门管理员操作手册

功能介绍 使用部门管理员设置需要完成以下步骤: 1. 在“部门管理员设置”菜单配置权限以及分配管理员。 2. 在“部门角色管理”菜单配置角色,以及权限。 3. 在“部门用户角色授权”菜单分配...

Jeecg ⋅ 02/05 ⋅ 0

没有更多内容

加载失败,请刷新页面

加载更多

下一页

常见数据结构(二)-树(二叉树,红黑树,B树)

本文介绍数据结构中几种常见的树:二分查找树,2-3树,红黑树,B树 写在前面 本文所有图片均截图自coursera上普林斯顿的课程《Algorithms, Part I》中的Slides 相关命题的证明可参考《算法(第...

浮躁的码农 ⋅ 昨天 ⋅ 0

android -------- 混淆打包报错 (warning - InnerClass ...)

最近做Android混淆打包遇到一些问题,Android Sdutio 3.1 版本打包的 错误如下: Android studio warning - InnerClass annotations are missing corresponding EnclosingMember annotation......

切切歆语 ⋅ 昨天 ⋅ 0

eclipse酷炫大法之设置主题、皮肤

eclipse酷炫大法 目前两款不错的eclipse 1.系统设置 Window->Preferences->General->Appearance 2.Eclipse Marketplace下载【推荐】 Help->Eclipse Marketplace->搜索‘theme’进行安装 比如......

anlve ⋅ 昨天 ⋅ 0

vim编辑模式、vim命令模式、vim实践

vim编辑模式 编辑模式用来输入或修改文本内容,编辑模式除了Esc外其他键几乎都是输入 如何进入编辑模式 一般模式输入以下按键,均可进入编辑模式,左下角提示 insert(中文为插入) 字样 i ...

蛋黄Yolks ⋅ 昨天 ⋅ 0

大数据入门基础:SSH介绍

什么是ssh 简单说,SSH是一种网络协议,用于计算机之间的加密登录。 如果一个用户从本地计算机,使用SSH协议登录另一台远程计算机,我们就可以认为,这种登录是安全的,即使被中途截获,密码...

董黎明 ⋅ 昨天 ⋅ 0

web3j教程

web3j是一个轻量级、高度模块化、响应式、类型安全的Java和Android类库提供丰富API,用于处理以太坊智能合约及与以太坊网络上的客户端(节点)进行集成。 汇智网最新发布的web3j教程,详细讲解...

汇智网教程 ⋅ 昨天 ⋅ 0

谷歌:安全问题机制并不如你想象中安全

腾讯科技讯 5月25日,如今的你或许已经对许多网站所使用的“安全问题机制”习以为常了,但你真的认为包括“你第一个宠物的名字是什么?”这些问题能够保障你的帐户安全吗? 根据谷歌(微博)安...

问题终结者 ⋅ 昨天 ⋅ 0

聊聊spring cloud gateway的RedisRateLimiter

序 本文主要研究下spring cloud gateway的RedisRateLimiter GatewayRedisAutoConfiguration spring-cloud-gateway-core-2.0.0.RELEASE-sources.jar!/org/springframework/cloud/gateway/con......

go4it ⋅ 昨天 ⋅ 0

169. Majority Element - LeetCode

Question 169. Majority Element Solution 思路:构造一个map存储每个数字出现的次数,然后遍历map返回出现次数大于数组一半的数字. 还有一种思路是:对这个数组排序,次数超过n/2的元素必然在中...

yysue ⋅ 昨天 ⋅ 0

NFS

14.1 NFS介绍 NFS是Network File System的缩写 NFS最早由Sun公司开发,分2,3,4三个版本,2和3由Sun起草开发,4.0开始Netapp公司参与并主导开发,最新为4.1版本 NFS数据传输基于RPC协议,RPC...

派派菠菜 ⋅ 昨天 ⋅ 0

没有更多内容

加载失败,请刷新页面

加载更多

下一页

返回顶部
顶部