树形控件的节点可以有多层、多个子节点， 如果将子节点全部展开，那么每一行都是一个数据条目。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_NAMESPACE
namespace Ui { class Widget; }
QT_END_NAMESPACE
class Widget : public QWidget
{
Q_OBJECT
public:
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 300
tree->move(100, 100); // 设置控件在窗口中的位置为 (100, 100)
tree->setColumnCount(2); // 设置列数为 2
tree->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);
}
}
