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 }

五、样式设置

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
}