qt QTreeWidget 学习

树形控件的节点可以有多层、多个子节点， 如果将子节点全部展开，那么每一行都是一个数据条目。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 &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);
 
    }
 
}