树控件QTreeWidget

已于 2024-10-11 18:49:36 修改
阅读量1.5k 收藏 10
点赞数 39
分类专栏： QT控件 文章标签： qt c++
于 2024-10-09 20:49:51 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/sc_o_r_pio/article/details/142699236
版权

树控件跟表格控件类似，也可以有多列，也可以只有1列，可以有多行，只不过每一行都是一个QTreeWidgetItem，每一行都是一个可以展开的树

常用属性和方法

显示和隐藏标题栏

树控件只有水平标题栏

//获取和设置标题栏的显隐
bool isHeaderHidden() const
void setHeaderHidden(bool hide)

//隐藏标题栏
tree->setHeaderHidden(true);

 还可以先获取到树控件的标题栏，然后调用标题栏的方法，来设置标题栏是否可见

//设置标题栏是否可见
void QHeaderView::setVisible(bool v)

//隐藏标题栏
tree->header()->setVisible(false);

点击标题栏排序

//获取和设置标题栏是否开启了排序
bool isSortingEnabled() const
void setSortingEnabled(bool enable)

//开启排序
tree->setSortingEnabled(true);

 开启点击标题栏会出现一个排序箭头，点击标题栏，就会根据当前列排序

动画效果

开启树控件里面的条目展开时会有一个缓冲效果，而不是立即展开

//获取和设置动画效果
bool isAnimated() const
void setAnimated(bool enable)


//开启动画效果
tree->setAnimated(true);

没开启：

开启了，条目的展开有一定的缓冲：

 滚动条的显示和隐藏

//设置和获取水平滚动条的显隐
Qt::ScrollBarPolicy horizontalScrollBarPolicy() const
void setHorizontalScrollBarPolicy(Qt::ScrollBarPolicy)

//设置和获取垂直滚动条的显隐
Qt::ScrollBarPolicy verticalScrollBarPolicy() const
void setVerticalScrollBarPolicy(Qt::ScrollBarPolicy)


//隐藏水平和垂直滚动条
tree->setVerticalScrollBarPolicy(Qt::ScrollBarAlwaysOff);
tree->setHorizontalScrollBarPolicy(Qt::ScrollBarAlwaysOff);

Qt::ScrollBarPolicy有三种取值：

  • Qt::ScrollBarAsNeeded，控件宽高太小导致内容显示不全时滚动条会出现
  • Qt::ScrollBarAlwaysOff，总是关闭
  • Qt::ScrollBarAlwaysOn，总是开启

开启：

选择模式

单选、多选、按住ctrl键多选，shift键多选...

//获取和设置控件的选择模式
QAbstractItemView::SelectionMode selectionMode() const
void setSelectionMode(QAbstractItemView::SelectionMode mode)


//设置为多选，既可以按shift也可以按ctrl键选择
tree->setSelectionMode(QAbstractItemView::ExtendedSelection);

 mode有5种取值：

  • QAbstractItemView::SingleSelection，只能但选
  • QAbstractItemView::ContiguousSelection，按住ctrl键可以多选
  • QAbstractItemView::ExtendedSelection，按住ctrl或者shift键可以多选
  • QAbstractItemView::MultiSelection，只要点击就能多选
  • QAbstractItemView::NoSelection，不能选择

按住ctrl或者shift键可以多选：

选择行为

选择时是选择单个条目、或者一整行 ，一整列

//获取和设置控件的选择行为
QAbstractItemView::SelectionBehavior selectionBehavior() const
void setSelectionBehavior(QAbstractItemView::SelectionBehavior behavior)


//设置为选择时只能选择单个
tree->setSelectionBehavior(QAbstractItemView::SelectItems);

behavior有三种取值：

  • QAbstractItemView::SelectItems，每次点击时只能选中单个
  • QAbstractItemView::SelectRows，每次点击时选中整行
  • QAbstractItemView::SelectColumns，每次点击时选中整列

QTreeWidgetItem

树形控件里面的条目是QTreeWidgetItem，是一个树形结构，我们对树控件增删改查就是在操作这个类，先说一下他里面的方法

  • 文本
//获取和设置item里面某一列的文本
QString QTreeWidgetItem::text(int column) const
void QTreeWidgetItem::setText(int column, const QString &text)
  •  获取和添加子节点
//添加和获取子节点
QTreeWidgetItem *QTreeWidgetItem::takeChild(int index)
void QTreeWidgetItem::addChild(QTreeWidgetItem *child)
  •  通过构造函数直接指定其父节点
QTreeWidgetItem(QTreeWidgetItem *parent, int type = Type)
QTreeWidgetItem(QTreeWidgetItem *parent, const QStringList &strings, int type = Type)
  •  通过构造函数直接指定所在树控件
QTreeWidgetItem(QTreeWidget *parent, int type = Type)
QTreeWidgetItem(QTreeWidget *parent, const QStringList &strings, int type = Type)
  •  插入子节点
//插在第几个子节点的前面
void QTreeWidgetItem::insertChild(int index, QTreeWidgetItem *child)
  •  通过构造函数直接指定插在哪个父节点的子节点前面
//插在parent节点的preceding子节点的前面
QTreeWidgetItem(QTreeWidgetItem *parent, QTreeWidgetItem *preceding, int type = Type)
  •  通过构造函数直接指定插在哪个树控件的顶级条目的前面
//插在parent树控件的preceding条目之前
QTreeWidgetItem(QTreeWidget *parent, QTreeWidgetItem *preceding, int type = Type)
  • 设置图标
//可以给每一列都设置图标
void QTreeWidgetItem::setIcon(int column, const QIcon &icon)
  •  获取子节点和子节点的数量
//根据索引获取子节点
QTreeWidgetItem *QTreeWidgetItem::child(int index) const

//获取子节点的数量
int QTreeWidgetItem::childCount() const
  •  获取父节点
QTreeWidgetItem *QTreeWidgetItem::parent() const
  • 获取所在树控件
QTreeWidget *QTreeWidgetItem::treeWidget() const

设置标题栏

  • 方法1：调用QTreeWidget的方法
//设置标题，一次性可以设置多列
void QTreeWidget::setHeaderLabels(const QStringList &labels)

//举例：
tree->setHeaderLabels({"编号","内容"});
  • 方法二：先设置一个空的标题栏，再获取到其标题栏对象（标题栏也是QTreeWidgetItem类），调用QTreeWidgetItem的方法
//设置标题栏的条目
void QTreeWidget::setHeaderItem(QTreeWidgetItem *item)
//获取标题栏
QTreeWidgetItem *QTreeWidget::headerItem() const

//QTreeWidgetItem设置文本
void QTreeWidgetItem::setText(int column, const QString &text)


//举例：
tree->setHeaderItem(new QTreeWidgetItem());//设置一个空的标题栏
tree->headerItem()->setText(0,"编号");//设置标题栏第1列的文本
tree->headerItem()->setText(1,"内容");//设置标题栏第2列的文本
//还可以继续添加

新增条目

  •  方法1：addTopLevelItem接口
//新增顶级条目
void QTreeWidget::addTopLevelItem(QTreeWidgetItem *item)


//举例：
//1、先创建条目
//新增条目
QTreeWidgetItem* item_1=new QTreeWidgetItem();
item_1->setText(0,"1");
item_1->setText(1,"清华大学");
//添加子节点
QTreeWidgetItem* item_11=new QTreeWidgetItem();
item_11->setText(0,"1001");
item_11->setText(1,"计算机学院");
item_1->addChild(item_11);
QTreeWidgetItem* item_12=new QTreeWidgetItem();
item_12->setText(0,"1002");
item_12->setText(1,"建筑学院");
item_1->addChild(item_12);
//2.添加条目
tree->addTopLevelItem(item_1);
  •  方法2：在QTreeWidgetItem的构造函数中指定父TreeWidget
//QTreeWidgetItem的构造函数中可以指定其所在树控件
QTreeWidgetItem(QTreeWidget *parent, int type = Type)


//举例：
//2.构造函数
QTreeWidgetItem* item_2=new QTreeWidgetItem(tree);
item_2->setText(0,"2");
item_2->setText(1,"北京大学");
//添加子节点
QTreeWidgetItem* item_21=new QTreeWidgetItem(item_2,{"2001","经管学院"});
QTreeWidgetItem* item_22=new QTreeWidgetItem(item_2,{"2002","理学院"});

插入条目

在指定索引处的前面插入顶级条目，如果是头插，那么index为0，如果是尾插，那么index为树控件的顶级条目数（topLevelItemCount()该方法获取）

//在指定索引处的前面插入顶级条目
void QTreeWidget::insertTopLevelItem(int index, QTreeWidgetItem *item)


//举例：
//尾部插入条目
QTreeWidgetItem* item_3=new QTreeWidgetItem({"3","复旦大学"});
QTreeWidgetItem* item_31=new QTreeWidgetItem(item_3,{"3001","文学院"});
QTreeWidgetItem* item_32=new QTreeWidgetItem(item_3,{"3002","外国语学院"});
//头插入：index为0，尾部插入：index为条目count
tree->insertTopLevelItem(tree->topLevelItemCount(),item_3);

 获取顶级条目的数目

int topLevelItemCount() const

获取顶级条目

可以根据索引获取顶级条目

QTreeWidgetItem *QTreeWidget::topLevelItem(int index) const


//举例：临时往第一个顶级条目下面添加子节点
tree->topLevelItem(0)->addChild(new QTreeWidgetItem({"1003","医学院"}));

 

给条目的某一列设置图标

//举例：给第一个顶级条目的第二列添加图标
tree->topLevelItem(0)->setIcon(1,QIcon(":/11.png"));

 

 给条目的某一列设置为控件（比如一个按钮，一个下拉列表）

//参数1：哪个节点
//参数2：哪一列
//参数3：要设置的Widget
void QTreeWidget::setItemWidget(QTreeWidgetItem *item, int column, QWidget *widget)


//举例：将清华大学设置为下拉列表
QComboBox* cbo=new QComboBox(this);
cbo->addItems({"清华大学","清华","大学"});
tree->setItemWidget(tree->topLevelItem(0),1,cbo);

设置选中状态

同样地，我们也可以设置选中状态，来实现选中父节点，子节点也被勾选的效果

//获取和设置条目某一列的选中状态
Qt::CheckState QTreeWidgetItem::checkState(int column) const
void QTreeWidgetItem::setCheckState(int column, Qt::CheckState state)


//举例：
        //初始化第一个条目和其子条目为未选中状态
        tree->topLevelItem(0)->setCheckState(0,Qt::Unchecked);
        for(int i=0;i<tree->topLevelItem(0)->childCount();++i)
        {
            tree->topLevelItem(0)->child(i)->setCheckState(0,Qt::Unchecked);
        }
        //绑定条目点击信号
        connect(tree,&QTreeWidget::itemClicked,tree,[=](QTreeWidgetItem* clicked_item,int i){
            //第1列被点击
            if(i==0)
            {
                //如果被点击的是顶层条目
                if(clicked_item->parent()==nullptr)
                {
                    //获取点击后的状态
                    auto check_state=clicked_item->checkState(0);

                    int child_cnt=clicked_item->childCount();
                    for(int i=0;i<child_cnt;++i)
                    {
                        if(check_state==Qt::Checked)
                        {
                            //选中后将他的子节点都选中
                            clicked_item->child(i)->setCheckState(0,Qt::Checked);
                        }
                        else if(check_state==Qt::Unchecked)
                        {
                            //未选中后将他的子节点都不选中
                            clicked_item->child(i)->setCheckState(0,Qt::Unchecked);
                        }

                    }
                }
                else//被点击的是顶层条目的子节点
                {
                    //子节点被选中的个数
                    int checked_cnt=0;

                    //遍历父节点的所有子节点
                    int child_cnt=clicked_item->parent()->childCount();
                    for(int i=0;i<child_cnt;++i)
                    {
                        if(clicked_item->parent()->child(i)->checkState(0)==Qt::Checked)
                        {
                            ++checked_cnt;
                        }
                    }

                    if(checked_cnt==0)
                    {
                        //子节点都没选中，父节点设置为未选中
                        clicked_item->parent()->setCheckState(0,Qt::Unchecked);
                    }
                    else if(checked_cnt==clicked_item->parent()->childCount())
                    {
                        //都选中了，父节点设置为选中
                        clicked_item->parent()->setCheckState(0,Qt::Checked);
                    }
                    else
                    {
                        //部分选中，父节点设置为半选
                        clicked_item->parent()->setCheckState(0,Qt::PartiallyChecked);
                    }
                }
            }
        });

 

获取选中的节点 

能够获取到上面被选中的节点

QList<QTreeWidgetItem *> QTreeWidget::selectedItems() const

常用信号

英文名的意思很清晰了

/*
1、currentItemChanged()
2、itemActivated()
3、itemChanged()
4、itemClicked()
5、itemCollapsed()收起
6、itemDoubleClicked
7、itemEntered
8、itemExpanded展开，展开后动态生成子节点，需要先遍历条目清空原来的子节点
9、itemPressed
*/

常用槽函数

//收缩条目
[slot] void QTreeWidget::collapseItem(const QTreeWidgetItem *item)

//展开条目
[slot] void QTreeWidget::expandItem(const QTreeWidgetItem *item)


//举例：鼠标移到条目上面，展开条目
//需要打开鼠标追踪
tree->setMouseTracking(true);
//绑定进入条目信号
connect(tree,&QTreeWidget::itemEntered,tree,[=](QTreeWidgetItem* item){
     tree->expandItem(item);
});

 样式表

/*
1、行列样式（交替背景行）
setAlternatingRowColors(true);先要打开这个属性
alternate-background-color:
2、条目通常样式、条目被选中、鼠标悬停样式
QTreeWidget::item{}
QTreeWidget::item:hover{}
QTreeWidget::item:select{}
3、条目收缩和展开时图片替换
3.1 QTreeWidget::branch:has-siblings:!adjoins-item {border-image: url(vline.png)}
3.2 QTreeWidget::branch:has-siblings:adjoins-item {border-image:url(branch-more.png)}
3.3 QTreeWidget::branch:!has-children:!has-siblings:adjoins-item{border-image: url(branch-end.png)}
3.4 QTreeWidget::branch:has-children:!has-siblings:closed,QTreeWidget::branch:closed:has-children:has-siblings {border-image:none;image:url(branch-closed.png)}
3.5 QTreeWidget::branch:open:has-children:!has-siblings,QTreeWidget::branch:open:has-children:has-siblings {border-image:none;image:url(branch-open.png)}
4、标题样式
QHeaderView::section{}
*/

说一下3的样式

美工提供这些图

 学习链接：https://github.com/0voice

姆路
关注
专栏目录
Qt界面篇：Qt停靠控件QDockWidget、树控件QTreeWidget及属性控件QtTreePropertyBrowser的使用
欧特GO
01-04 2751
Qt界面篇：Qt停靠控件QDockWidget、树控件QTreeWidget及属性控件QtTreePropertyBrowser的使用
QTreeWidget
wuchalilun的专栏
09-22 766
1.树结构的实现 关于这点网上例子很多，也很简单，简单说一下：这个也是自己在网上随便找的一个TreeWidget::TreeWidget() { tree = new QTreeWidget(this); tree->setColumnCount(2); QStringList headers; headers <<
Qt5学习笔记（4）——树形控件QtreeWidget（续）
weixin_30384217的博客
01-09 588
QTreeWidget顾名思义，这是用来展示树型结构（也就是层次结构）的。Qt中实现树形结构可以使用QTreeWidget类，也可以使QTreeView类，QTreeWidget继承自QTreeView类。这个类需要同另外一个辅助类QTreeWidgetItem一同使用。不过，既然是提供方面的封装类，即便是看上去很复杂的树，在使用这个类的时候也是显得比较简单的。当不需要使用复杂的QTree...
Qt控件用法：QDockWidget、树控件QTreeWidget及属性控件QtTreePropertyBrowser
01-04
主要使用Qt停靠控件QDockWidget、树控件QTreeWidget及Qt属性控件QtTreePropertyBrowser来搭建一个实用的主界面布局。 具体详细介绍实现效果可查看：https://blog.csdn.net/m0_37251750/article/details/135378454
PyQt5 树控件QTreeWidget
最新发布
08-21
图标文件，解压至当前py文件所在目录即可。
PyQt5树控件QTreeWidget的图标配置教程
资源摘要信息:"PyQt5 树控件QTreeWidget" 知识点: 1. PyQt5概述： PyQt5是一个用于创建图形用户界面的工具包，它是基于Qt应用程序框架的Python模块。PyQt5支持包括但不限于信号和槽机制、事件处理、各种控件和容器...
pyqt5 treewidget图标_PyQt5入门（十四）树控件QTreeWidget
weixin_28863429的博客
02-19 1242
目录一.凡心所向，素履所往二.树控件(QTreeWidget)基本用法三.为树节点添加响应时间四.增加，修改和删除树控件的节点五.QTreeView控件与系统定制模式一.凡心所向，素履所往二.树控件(QTreeWidget)基本用法代码：import sysfrom PyQt5.QtWidgets import *from PyQt5.QtCore import *from PyQt5.QtGui...
QTreeWidget简单使用
12-28
代码示例演示了QTreeWidget的简单使用（最顶层的项用addTopLevelItem()函数来加入，每个项的子项用addChild()函数来加入），结合使用这两个API构建属于自己的树控件。使用QTreeWidgetItem的setIcon()函数可以给每个项设置图标，界面更美观。。。
QTreeWidget详细设置
11-23
QTreeWidget详细设置
【QT学习七】QTreeWidget
热门推荐
从此不归路
04-04 1万+
QTreeWidget是Qt中一个用于显示树形结构数据的控件，它继承自QTreeView，可以显示多列数据和树形结构的层次关系，还提供了许多交互功能。可以支持单选、多选和可编辑的节点，还可以自定义节点的样式和布局。除此之外，QTreeWidget 还支持信号和槽机制，可以方便地处理节点的操作事件，如点击、双击、选择等等。头文件: #include <QTreeWidget>继承: QTreeViewQTreeWidget 的节点可以根据需求进行自定义样式的设置。
【嵌入式——QT】QTreeWidget
weixin_39723539的博客
03-04 1976
嵌入式-QT-QTreeWidget
QT笔记——QTreeWidget
lion_cxq的博客
01-25 425
头文件： #include<QTreeWidget> 代码段： ui->treeWidget->setColumnCount(1); //设置列数 ui->treeWidget->setHeaderLabel(QStringLiteral("树的示例")); //设置头的标题 QTreeWidgetItem *tree1 = new QTreeWidgetItem(ui->treeWidget,QStringList(QStringLiteral("树1")))
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值