本文共 4593 字，大约阅读时间需要 15 分钟。

引言

为什么不能通过这篇文章，直接玩转 QTreeWidget 树桩窗体呢？

简介

操作系统：window7 x64

编程IDE：Qt Creator 4.2.1

Qt版本：5.8.0

最后更新日期：2017年5月3日

版权所有：_OE_, 转载请注明出处：

基础

这里只负责基础的内容，最浅显，最常用的内容。

树状列表的创建

• 关联

  该类的关联头文件, 别觉得谁都知道，有不知道的人，我说真的。

  #include 
       

• 光膀子的列表

  包含了头文件以后，我们通过下面的这句话就可以建出一个啥也没有的列表了，虽然这个列表看起来还很可笑。

  QTreeWidget* tree = new QTreeWidget();    tree->show();

  

  别瞧他现在还是个四不像，这胚子已经出来了，树状列表还远吗？

  这里的 1 是这个树状图的标题，我们暂时先不用理会他。

• 穿上列表的衣服

  我们来认识下一个至关重要的类。

  QTreeWidgetItem 显然他的名字就已经说明了他的作用，我们想要插入一条一条的数据都要通过这个类。

  /** * @brief : 构造函数 - 生成一个子项 * @param : view 关联的窗体，或译父节点 * @param : strings 列(column)数据 （后面会细讲） * @param : type 暂时不用理会*/QTreeWidgetItem(QTreeWidget *view,     const QStringList &strings, int type = Type);

  我们来建立我们自己的列表

  QTreeWidget* tree = new QTreeWidget();tree->show();//添加一级节点QTreeWidgetItem *items1 = new QTreeWidgetItem(tree,                       QStringList(QString("num_1")));QTreeWidgetItem *items2 = new QTreeWidgetItem(tree,                       QStringList(QString("num_2")));QTreeWidgetItem *items3 = new QTreeWidgetItem(tree,                       QStringList(QString("num_3")));

  

  我们的树列就有了，一个for，我们想有多少行就有多少行了。

  至此，基础的列表显示就已经齐全了。

树状列表的删除

• 野蛮的 delete

  树状列表的删除其实很有趣，一个 delete 就搞定了，尽管这样很不优雅。

  

  原因也很简单，一个 delete 触发了析构函数。

  我说他野蛮的原因是，我们不可能在程序复杂的运行过程中还保留曾经的变量 items2 item3….

  所以这样的写法，只能被看成野蛮，无脑。

• 如何优雅？

  QTreeWidget* tree = new QTreeWidget();tree->show();//添加一级节点QTreeWidgetItem *items1 = new QTreeWidgetItem(tree,                            QStringList(QString("num_1")));QTreeWidgetItem *items2 = new QTreeWidgetItem(tree,                            QStringList(QString("num_2")));QTreeWidgetItem *items3 = new QTreeWidgetItem(tree,                            QStringList(QString("num_3")));tree->takeTopLevelItem(1);

  嘿嘿，这里的函数名 takeTopLevelItem 已经阐述了他的作用，拿走顶级的项。

  index 是下标，我们这里给了 1 你们可以想想，这里哪个子项会消失。

• 最常用的删除

  我们一般删除某个项，都是由用户通过鼠标指定的，所以我们其实可以通过相应特定的事件（例：右键菜单，delete keydown）。

  // 通过这个函数获得当前选中的项QTreeWidget* tree = new QTreeWidget();tree->currentItem();

  若currentItem 返回空，则意味着没有选中该列表中的子项。

树状图的查找

• 众里寻他千百度 删他只需一抽搐

  QTreeWidget* tree = new QTreeWidget();tree->show();//添加一级节点QTreeWidgetItem *items1 = new QTreeWidgetItem(tree,                            QStringList(QString("num_1")));QTreeWidgetItem *items2 = new QTreeWidgetItem(tree,                            QStringList(QString("num_1")));QTreeWidgetItem *items3 = new QTreeWidgetItem(tree,                            QStringList(QString("num_3")));// 查找 与 num_1 完全一致的项，并返回。QList
       
         s = tree->findItems("num_1", Qt::MatchFlag::MatchExactly);// 无情删除for (auto item : s) {    delete item;}
       

深入

多级树状图

多级树状图，其实也很好理解，就是把父节点换掉嘛，谁是父节点，那么Item项就挂载在谁的下面。

QTreeWidgetItem *items3 = new QTreeWidgetItem(tree,                             QStringList(QString("num_13")));QTreeWidgetItem *item104 = new QTreeWidgetItem(items3,                            QStringList(QString("item104")));

层次都是按照这个套路来的，多级树状图油然而生。

多列树状图

暂无信息

简单的自定义

使用这个函数的时候，需要在全局或类内定义一个变量

/**     * @brief : 添加子项到树中     * @param : item 项的内容     * @param : parentKey 他的父级节点的唯一标识     * @param : theKey 他的节点唯一标识    */    int CustomTreeWidget::addItem(QStringList item, QString parentKey, QString theKey) {    QTreeWidgetItem* temp_item;    /// 生成到父级节点下    QMap
   
    ::iterator iter_item = itemMap_.find(parentKey);    if (iter_item == itemMap_.end()) {        temp_item = new QTreeWidgetItem(this, item);    }    else {        temp_item = new QTreeWidgetItem(iter_item.value(), item);    }    /// 判断    if (!theKey.isEmpty()) {        itemMap_.insert(theKey,temp_item);    }}
   

这里只是简单的给大家一个思路，大家放胆去继承QTreeWidget类，发挥想象读取干吧。

比如通过某个值获得这个项，结合上面的基础，已经可以做很多事情啦，不是吗?

列表头的操作

• 表头操作

/** * @brief : 表头的隐藏 * @param : hide  [true : 隐藏表头 false : 显示表头] */void QTreeView::setHeaderHidden(bool hide);

• 设置表头

/** * @brief :  设置表头内容 * @param : item 具体的item项 */void QTreeView::setHeaderItem(QTreeWidgetItem *item);// 也可以直接给文字void setHeaderLabels(const QStringList &labels);inline void setHeaderLabel(const QString &label);

会说话的颜色

QStringList head;    head << "姓名";    QTreeWidget* tree = new QTreeWidget();    tree->show();    // 设置表头    tree->setHeaderLabels(head);    // 添加一级节点    head.clear();    head << "王根基";    QTreeWidgetItem *items1 = new QTreeWidgetItem(tree,                                head);    head.clear();    head << "李大锤";    QTreeWidgetItem *items3 = new QTreeWidgetItem(tree,                                head);    /// 设置背景颜色    items3->setBackground(0,QBrush(Qt::green));    head.clear();    head << "李思基(非亲生)";    QTreeWidgetItem *item104 = new QTreeWidgetItem(items3,                                head);

太晚了，这里还没有更新，抱歉。

为子项添加Logo

暂无介绍

QTreeWidget 的新装

暂无介绍