Qt QTreeWidget详解

Qt中实现树形结构可以使用QTreeWidget类，也可以使用QTreeView类，QTreeWidget继承自QTreeView类。

一、常用属性（可通过设计器直接设置）

函数	作用
header()->setVisible(false);	设置标题头是否显示
header()->setDefaultSectionSize(200);	设置标题头默认的尺寸
void setSortingEnabled(bool enable);	设置点击标题头排序
void setAnimated(bool enable);	设置动画展开
void setHorizontalScrollBarPolicy(Qt::ScrollBarPolicy);	设置水平滚动条策略，设置是否显示滚动条
void setVerticalScrollBarPolicy(Qt::ScrollBarPolicy);	设置垂直滚动条策略，设置是否显示滚动条
void setSelectionMode(QAbstractItemView::SelectionMode mode);	设置单选、多选、Ctrl 、shift（和QTableWidget一样）
void setSelectionBehavior(QAbstractItemView::SelectionBehavior behavior);	设置选择行、列、项（和QTableWidget一样）

还有很很多的属性设置可自行研究，或者查看Qt 源码即可。

二、标题设置

//设置列数
ui.treeWidget->setColumnCount(1);
//一次性设置一个标题
ui.treeWidget->setHeaderLabel(QString::fromLocal8Bit("标题1"));
//一次性设置多个标题
ui.treeWidget->setHeaderLabels({ QString::fromLocal8Bit("标题2"),QString::fromLocal8Bit("标题3"),QString::fromLocal8Bit("标题4") });
//修改某个标题
ui.treeWidget->headerItem()->setText(0, QString::fromLocal8Bit("标题5"));

三、内容插入

ui->treeWidget->setColumnCount(1); //设置列数
ui->treeWidget->setHeaderLabel(tr("图像选择")); //设置头的标题

QTreeWidgetItem *imageItem1 = new QTreeWidgetItem(ui->treeWidget,QStringList(QString("图像1")));
imageItem1->setIcon(0,QIcon("xxx.png"));
QTreeWidgetItem *imageItem1_1 = new QTreeWidgetItem(imageItem1,QStringList(QString("Band1"))); //子节点1
imageItem1->addChild(imageItem1_1); //添加子节点

QTreeWidgetItem *imageItem2 = new QTreeWidgetItem(ui->treeWidget,QStringList(QString("图像2")));
QTreeWidgetItem *imageItem2_1 = new QTreeWidgetItem(imageItem2,QStringList(QString("Band1"))); //子节点1
QTreeWidgetItem *imageItem2_2 = new QTreeWidgetItem(imageItem2,QStringList(QString("Band2"))); //子节点2
imageItem2->addChild(imageItem2_1);  //添加子节点
imageItem2->addChild(imageItem2_2);

ui->treeWidget->expandAll(); //结点全部展开

当然，还有其他的一些方法用于设置，具体需要时查查帮助文档学习。

除了使用上面这种方法之外，还可以使用QList < QTreeWidgetItem * > & items实现结点的添加。QT中对C++中的STL库中的容器使用进行了封装，使用其封装的类可以很方便的解决很多类似很复杂数据结构的问题。实现如下：

//只写结点的实现
QList<QTreeWidgetItem *> rootList;

QTreeWidgetItem *imageItem1 = new QTreeWidgetItem;   //添加第一个父节点
imageItem1->setText(0,tr("图像1"));
rootList.append(imageItem1);

QTreeWidgetItem *imageItem1_1 = new QTreeWidgetItem(imageItem1,QStringList(QString("Band1"))); //添加子节点
imageItem1->addChild(imageItem1_1);

QTreeWidgetItem *imageItem2 = new QTreeWidgetItem;   //添加第二个父节点
imageItem2->setText(0,tr("图像2"));
rootList.append(imageItem2);

QTreeWidgetItem *imageItem2_1 = new QTreeWidgetItem(imageItem2,QStringList(QString("Band1")));  //添加子节点
QTreeWidgetItem *imageItem2_2 = new QTreeWidgetItem(imageItem2,QStringList(QString("Band2")));
imageItem2->addChild(imageItem2_1);
imageItem2->addChild(imageItem2_2);

ui->treeWidget->insertTopLevelItems(0,rootList);  //将结点插入部件中

ui->treeWidget->expandAll(); //全部展开

void setItemWidget(QTreeWidgetItem *item, int column, QWidget *widget); 也可以插入控件

四、信号事件

信号	说明
void itemPressed(QTreeWidgetItem *item, int column);	某一项被按下
void itemClicked(QTreeWidgetItem *item, int column);	某一项被点击
void itemDoubleClicked(QTreeWidgetItem *item, int column);	某一项被双击
void itemActivated(QTreeWidgetItem *item, int column);	某一项被激活
void itemEntered(QTreeWidgetItem *item, int column);	鼠标移上去 要打开鼠标跟踪事件（setMouseTracking(true)）
void itemChanged(QTreeWidgetItem *item, int column);	某一项改变
void itemExpanded(QTreeWidgetItem *item);	某一项展开
void itemCollapsed(QTreeWidgetItem *item);	某一项收缩
void currentItemChanged(QTreeWidgetItem *current, QTreeWidgetItem *previous);	某一项发生改变，要判断previous是否为空
void itemSelectionChanged();	某一项选中改变

1. 点击节点的事件响应

首先想到有没有点击某个节点的信号，查看文档，有一个void itemClicked ( QTreeWidgetItem * item, int column )信号，是双击某个节点的信号，将该信号与某个自定义槽相连，当双击节点时触发槽函数。

看一下这个信号，第一个参数为点击的QTreeWidgetItem类对象，第二个参数为节点所在列号。

思路：根据点击的QTreeWidgetItem类对象可以通过parent()函数得到父节点，如果QTreeWidgetItem类对象就是最最顶端的节点时，parent()函数返回的就是NULL。通过insertChildren ( int index, const QList<QTreeWidgetItem *> & children )函数可以得到该节点在父节点中的索引值。

目前只能解决只有一个最顶端父节点时的事件响应，当最顶端的父节点有多个(比如本文开头有2个)，这时点击子节点时，无法判断子节点的父节点是哪一个(本人愚笨啊！)，因此没法为其槽函数执行相应的操作。

这里就以一个分支为例。

 1 	private slots:
 2     void showSelectedImage(QTreeWidgetItem * item, int column); //点击树节点事件
 3 
 4 connect(ui->treeWidget,SIGNAL(itemDoubleClicked(QTreeWidgetItem*,int)),this,SLOT(showSelectedImage(QTreeWidgetItem*,int)));
 5 
 6 void MainWindow::showSelectedImage(QTreeWidgetItem *item, int column)
 7 {
 8     QTreeWidgetItem *parent = item->parent();
 9     if(NULL==parent) //注意：最顶端项是没有父节点的，双击这些项时注意(陷阱)
10         return;
11     int col = parent->indexOfChild(item); //item在父项中的节点行号(从0开始)
12 
13     if(0==col) //Band1
14     {
15         //执行对应操作
16     }
17     if(1==col) //Band2
18     {
19         //执行对应操作
20     }
21 }

Qt QTreeWidget节点的添加+双击响应+删除详解

五、样式设置

QTreeWidget{
	background-color:#FEFFF7;
	alternate-background-color:#CBE8D9;
}
QTreeWidget::item:hover{
	background-color:#C5DAFF;
}
QTreeWidget::item:selected{
	background-color:#DEBBE8;
}
/*连接线*/
QTreeView::branch:has-siblings:!adjoins-item{
	border-image:url(vline.png);
}
/*有多个连接项*/
QTreeView::branch:has-siblings:adjoins-item{
	border-image:url(branch-more.png);
}
/*结束项连接线*/
QTreeView::branch:!has-children:!has-siblings:adjoins-item{
	border-image:url(branch-end.png);
}
/*收缩图标*/
QTreeView::branch:has-children:!has-siblings:closed,
QTreeView::branch:closed:has-children:has-siblings{
	border-image:none;
	image:url(branch-closed.png);
}
/*展开图标*/
QTreeView::branch:open:has-children:!has-siblings,
QTreeView::branch:open:has-children:has-siblings{
	border-image:none;
	image:url(branch-open.png);
}
/*表头*/
QHeaderView::section{
	background-color:#FFE0D8;
	border:1px solid #C5DAFF
}