树形控件的节点可以有多层、多个子节点， 如果将子节点全部展开，那么每一行都是一个数据条目。QTreeWidgetItem 比较特殊，一个条目内部可以有多列数据信息，相当于表格控件一整行的表格单元集成为一个条目。
默认情况下，树形控件最上面是一个树头条目，树头条目也是 QTreeWidgetItem 对象，可以有多列内容。
树头下面是真正的树形控件所有条目，在折叠的情况下，如上图所示，每行一个顶级条目，顶级条目也是 QTreeWidgetItem 对象，顶级条目的父节点指针 QTreeWidgetItem::parent() 为 NULL。
QTreeWidget
顶级条目进行计数
int QTreeWidget::topLevelItemCount() const
获取顶级条目
QTreeWidgetItem *topLevelItem(int index) const;
添加顶级条目
void addTopLevelItem(QTreeWidgetItem *item);
移除顶级条目
QTreeWidgetItem *takeTopLevelItem(int index);
清空所有的顶级条目和子条目
void clear();
获取当前高亮选中条目的函数为
QTreeWidgetItem *currentItem() const;
设置某个条目为当前选中的状态
void setCurrentItem(QTreeWidgetItem *item);
当前高亮选中的状态发生变化，会触发如下信号
void currentItemChanged(QTreeWidgetItem *current, QTreeWidgetItem *previous);
QTreeWidgetItem
获取某列的数据
QString text(int column)
virtual QVariant data(int column, int role) const;
设置某列的数据
void setText(int column, const QString &text)
virtual void setData(int column, int role, const QVariant &value);
获取某列图标
inline QIcon icon(int column) const
设置某列图标
inline void setIcon(int column, const QIcon &icon);
添加子项
void addChild(QTreeWidgetItem *child);
void addChildren(const QList<QTreeWidgetItem*> &children);
当前条目的操作
QTreeWidgetItem *currentItem() const; //获取当前高亮选中条目
int currentColumn() const; //当前条目被点击选中的列号
void setCurrentItem(QTreeWidgetItem *item); //设置某个条目为当前选中的状态
常用的信号
如果当前高亮选中的状态发生变化
void currentItemChanged(QTreeWidgetItem *current, QTreeWidgetItem *previous);
void itemActivated(QTreeWidgetItem * item, int column) //条目列被激活
void itemChanged(QTreeWidgetItem * item, int column) //条目列的数据发生变化，比如文本或图标修改了
void itemClicked(QTreeWidgetItem * item, int column) //条目列被单击
void itemDoubleClicked(QTreeWidgetItem * item, int column) //条目列被双击
void itemEntered(QTreeWidgetItem * item, int column) //进入条目列
void itemPressed(QTreeWidgetItem * item, int column) //条目列被点击按下
void QTreeWidget::itemExpanded(QTreeWidgetItem * item) //条目展开时发送信号
void QTreeWidget::itemCollapsed(QTreeWidgetItem * item) //条目折叠时发送信号
代码例子
#ifndef WIDGET_H#define WIDGET_H#include <QWidget>#include <QTreeWidget>QT_BEGIN_NAMESPACEnamespace Ui { class Widget; }QT_END_NAMESPACEclass Widget : public QWidget{Q_OBJECTpublic:Widget(QWidget *parent = nullptr);~Widget();void createtree();QTreeWidget *tree;public slots:void curItemChanged(QTreeWidgetItem *current, QTreeWidgetItem *previous);void itemselected(QTreeWidgetItem *item,int column);public:void setselected(QTreeWidgetItem *item,Qt::CheckState state);private:Ui::Widget *ui;};#endif // WIDGET_H#include "widget.h"#include "ui_widget.h"#include <QDebug>Widget::Widget(QWidget *parent): QWidget(parent), ui(new Ui::Widget){ui->setupUi(this);createtree();}Widget::~Widget(){delete ui;}void Widget::createtree(){tree = new QTreeWidget(this);tree->resize(400, 300); // 设置控件大小为 400 x 300tree->move(100, 100); // 设置控件在窗口中的位置为 (100, 100)tree->setColumnCount(2); // 设置列数为 2tree->setHeaderLabels({"Name", "Value"}); // 设置列标题为 "Name" 和 "Value"QTreeWidgetItem *root = new QTreeWidgetItem(tree); // 创建一个根节点root->setText(0, "Root"); // 设置节点文本root->setText(1, "0"); // 设置节点文本root->setCheckState(0,Qt::Checked);tree->addTopLevelItem(root); // 将节点添加到 QTreeWidget 中QTreeWidgetItem *child1 = new QTreeWidgetItem(root); // 创建一个子节点child1->setText(0, "Child 1"); // 设置节点文本child1->setText(1,"10"); // 设置节点文本''child1->setCheckState(0,Qt::Checked);root->addChild(child1); // 将节点添加到根节点下QTreeWidgetItem *child11 = new QTreeWidgetItem(child1); // 创建一个子节点child11->setText(0, "Child 11"); // 设置节点文本child11->setText(1,"100"); // 设置节点文本''child11->setCheckState(0,Qt::Checked);child1->addChild(child11); // 将节点添加到根节点下QTreeWidgetItem *child2 = new QTreeWidgetItem(root); // 创建一个子节点child2->setText(0, "Child 2"); // 设置节点文本child2->setText(1,"20"); // 设置节点文本child2->setCheckState(0,Qt::Checked);root->addChild(child2); // 将节点添加到根节点下connect(tree,SIGNAL(currentItemChanged(QTreeWidgetItem *, QTreeWidgetItem*)),this,SLOT(curItemChanged(QTreeWidgetItem *, QTreeWidgetItem*)));connect(tree,SIGNAL(itemClicked(QTreeWidgetItem *,int)),this,SLOT(itemselected(QTreeWidgetItem *,int)));tree->show();}void Widget::curItemChanged(QTreeWidgetItem *current, QTreeWidgetItem *previous){if(current != nullptr){qDebug() << current->text(0);}}void Widget::itemselected(QTreeWidgetItem *item,int column){if(column == 0){Qt::CheckState state = item->checkState(0);if(state == Qt::Checked || state == Qt::Unchecked){setselected(item,state);}}}void Widget::setselected(QTreeWidgetItem *item,Qt::CheckState state ){int ncount = item->childCount();for(int i = 0; i <ncount; i++){QTreeWidgetItem *child = item->child(i);child->setCheckState(0,state);if(child->childCount() > 0)setselected(child,state);}}
