Qt学习笔记之常用控件QTreeWidget

爱被打了一巴掌 2023-05-28 11:12 50阅读 0赞

# 一、QTreeWidget Class #

The [QTreeWidget][] class provides a tree view that uses a predefined tree model. [More...][]

<table> 
 <tbody> 
 <tr> 
 <td>Header:</td> 
 <td>#include &lt;QTreeWidget&gt;</td> 
 </tr> 
 <tr> 
 <td>qmake:</td> 
 <td>QT += widgets</td> 
 </tr> 
 <tr> 
 <td>Inherits:</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreeview.html" rel="nofollow">QTreeView</a></td> 
 </tr> 
 </tbody> 
</table>

*  [List of all members, including inherited members][List of all members_ including inherited members]
 *  [Obsolete members][]

## Properties ##

*  **[columnCount][]** : int
 *  **[topLevelItemCount][]** : const int

## Public Functions ##

<table> 
 <tbody> 
 <tr> 
 <td>&nbsp;</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#QTreeWidget" rel="nofollow">QTreeWidget</a>(QWidget *parent&nbsp;= nullptr)</td> 
 </tr> 
 <tr> 
 <td>virtual</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#dtor.QTreeWidget" rel="nofollow">~QTreeWidget</a>()</td> 
 </tr> 
 <tr> 
 <td>void</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#addTopLevelItem" rel="nofollow">addTopLevelItem</a>(QTreeWidgetItem *item)</td> 
 </tr> 
 <tr> 
 <td>void</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#addTopLevelItems" rel="nofollow">addTopLevelItems</a>(const QList&lt;QTreeWidgetItem *&gt; &amp;items)</td> 
 </tr> 
 <tr> 
 <td>void</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#closePersistentEditor" rel="nofollow">closePersistentEditor</a>(QTreeWidgetItem *item, int&nbsp;column&nbsp;= 0)</td> 
 </tr> 
 <tr> 
 <td>int</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#columnCount-prop" rel="nofollow">columnCount</a>() const</td> 
 </tr> 
 <tr> 
 <td>int</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#currentColumn" rel="nofollow">currentColumn</a>() const</td> 
 </tr> 
 <tr> 
 <td>QTreeWidgetItem *</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#currentItem" rel="nofollow">currentItem</a>() const</td> 
 </tr> 
 <tr> 
 <td>void</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#editItem" rel="nofollow">editItem</a>(QTreeWidgetItem *item, int&nbsp;column&nbsp;= 0)</td> 
 </tr> 
 <tr> 
 <td>QList&lt;QTreeWidgetItem *&gt;</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#findItems" rel="nofollow">findItems</a>(const QString &amp;text, Qt::MatchFlags&nbsp;flags, int&nbsp;column&nbsp;= 0) const</td> 
 </tr> 
 <tr> 
 <td>QTreeWidgetItem *</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#headerItem" rel="nofollow">headerItem</a>() const</td> 
 </tr> 
 <tr> 
 <td>int</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#indexOfTopLevelItem" rel="nofollow">indexOfTopLevelItem</a>(QTreeWidgetItem *item) const</td> 
 </tr> 
 <tr> 
 <td>void</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#insertTopLevelItem" rel="nofollow">insertTopLevelItem</a>(int&nbsp;index, QTreeWidgetItem *item)</td> 
 </tr> 
 <tr> 
 <td>void</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#insertTopLevelItems" rel="nofollow">insertTopLevelItems</a>(int&nbsp;index, const QList&lt;QTreeWidgetItem *&gt; &amp;items)</td> 
 </tr> 
 <tr> 
 <td>QTreeWidgetItem *</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#invisibleRootItem" rel="nofollow">invisibleRootItem</a>() const</td> 
 </tr> 
 <tr> 
 <td>bool</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#isPersistentEditorOpen" rel="nofollow">isPersistentEditorOpen</a>(QTreeWidgetItem *item, int&nbsp;column&nbsp;= 0) const</td> 
 </tr> 
 <tr> 
 <td>QTreeWidgetItem *</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#itemAbove" rel="nofollow">itemAbove</a>(const QTreeWidgetItem *item) const</td> 
 </tr> 
 <tr> 
 <td>QTreeWidgetItem *</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#itemAt" rel="nofollow">itemAt</a>(const QPoint &amp;p) const</td> 
 </tr> 
 <tr> 
 <td>QTreeWidgetItem *</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#itemAt-1" rel="nofollow">itemAt</a>(int&nbsp;x, int&nbsp;y) const</td> 
 </tr> 
 <tr> 
 <td>QTreeWidgetItem *</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#itemBelow" rel="nofollow">itemBelow</a>(const QTreeWidgetItem *item) const</td> 
 </tr> 
 <tr> 
 <td>QWidget *</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#itemWidget" rel="nofollow">itemWidget</a>(QTreeWidgetItem *item, int&nbsp;column) const</td> 
 </tr> 
 <tr> 
 <td>void</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#openPersistentEditor" rel="nofollow">openPersistentEditor</a>(QTreeWidgetItem *item, int&nbsp;column&nbsp;= 0)</td> 
 </tr> 
 <tr> 
 <td>void</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#removeItemWidget" rel="nofollow">removeItemWidget</a>(QTreeWidgetItem *item, int&nbsp;column)</td> 
 </tr> 
 <tr> 
 <td>QList&lt;QTreeWidgetItem *&gt;</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#selectedItems" rel="nofollow">selectedItems</a>() const</td> 
 </tr> 
 <tr> 
 <td>void</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#columnCount-prop" rel="nofollow">setColumnCount</a>(int&nbsp;columns)</td> 
 </tr> 
 <tr> 
 <td>void</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#setCurrentItem" rel="nofollow">setCurrentItem</a>(QTreeWidgetItem *item)</td> 
 </tr> 
 <tr> 
 <td>void</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#setCurrentItem-1" rel="nofollow">setCurrentItem</a>(QTreeWidgetItem *item, int&nbsp;column)</td> 
 </tr> 
 <tr> 
 <td>void</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#setCurrentItem-2" rel="nofollow">setCurrentItem</a>(QTreeWidgetItem *item, int&nbsp;column, QItemSelectionModel::SelectionFlags&nbsp;command)</td> 
 </tr> 
 <tr> 
 <td>void</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#setHeaderItem" rel="nofollow">setHeaderItem</a>(QTreeWidgetItem *item)</td> 
 </tr> 
 <tr> 
 <td>void</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#setHeaderLabel" rel="nofollow">setHeaderLabel</a>(const QString &amp;label)</td> 
 </tr> 
 <tr> 
 <td>void</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#setHeaderLabels" rel="nofollow">setHeaderLabels</a>(const QStringList &amp;labels)</td> 
 </tr> 
 <tr> 
 <td>void</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#setItemWidget" rel="nofollow">setItemWidget</a>(QTreeWidgetItem *item, int&nbsp;column, QWidget *widget)</td> 
 </tr> 
 <tr> 
 <td>int</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#sortColumn" rel="nofollow">sortColumn</a>() const</td> 
 </tr> 
 <tr> 
 <td>void</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#sortItems" rel="nofollow">sortItems</a>(int&nbsp;column, Qt::SortOrder&nbsp;order)</td> 
 </tr> 
 <tr> 
 <td>QTreeWidgetItem *</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#takeTopLevelItem" rel="nofollow">takeTopLevelItem</a>(int&nbsp;index)</td> 
 </tr> 
 <tr> 
 <td>QTreeWidgetItem *</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#topLevelItem" rel="nofollow">topLevelItem</a>(int&nbsp;index) const</td> 
 </tr> 
 <tr> 
 <td>int</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#topLevelItemCount-prop" rel="nofollow">topLevelItemCount</a>() const</td> 
 </tr> 
 <tr> 
 <td>QRect</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#visualItemRect" rel="nofollow">visualItemRect</a>(const QTreeWidgetItem *item) const</td> 
 </tr> 
 </tbody> 
</table>

## Reimplemented Public Functions ##

<table> 
 <tbody> 
 <tr> 
 <td>virtual void</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#setSelectionModel" rel="nofollow">setSelectionModel</a>(QItemSelectionModel *selectionModel) override</td> 
 </tr> 
 </tbody> 
</table>

## Public Slots ##

<table> 
 <tbody> 
 <tr> 
 <td>void</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#clear" rel="nofollow">clear</a>()</td> 
 </tr> 
 <tr> 
 <td>void</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#collapseItem" rel="nofollow">collapseItem</a>(const QTreeWidgetItem *item)</td> 
 </tr> 
 <tr> 
 <td>void</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#expandItem" rel="nofollow">expandItem</a>(const QTreeWidgetItem *item)</td> 
 </tr> 
 <tr> 
 <td>void</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#scrollToItem" rel="nofollow">scrollToItem</a>(const QTreeWidgetItem *item, QAbstractItemView::ScrollHint&nbsp;hint&nbsp;= EnsureVisible)</td> 
 </tr> 
 </tbody> 
</table>

## Signals ##

<table> 
 <tbody> 
 <tr> 
 <td>void</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#currentItemChanged" rel="nofollow">currentItemChanged</a>(QTreeWidgetItem *current, QTreeWidgetItem *previous)</td> 
 </tr> 
 <tr> 
 <td>void</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#itemActivated" rel="nofollow">itemActivated</a>(QTreeWidgetItem *item, int&nbsp;column)</td> 
 </tr> 
 <tr> 
 <td>void</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#itemChanged" rel="nofollow">itemChanged</a>(QTreeWidgetItem *item, int&nbsp;column)</td> 
 </tr> 
 <tr> 
 <td>void</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#itemClicked" rel="nofollow">itemClicked</a>(QTreeWidgetItem *item, int&nbsp;column)</td> 
 </tr> 
 <tr> 
 <td>void</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#itemCollapsed" rel="nofollow">itemCollapsed</a>(QTreeWidgetItem *item)</td> 
 </tr> 
 <tr> 
 <td>void</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#itemDoubleClicked" rel="nofollow">itemDoubleClicked</a>(QTreeWidgetItem *item, int&nbsp;column)</td> 
 </tr> 
 <tr> 
 <td>void</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#itemEntered" rel="nofollow">itemEntered</a>(QTreeWidgetItem *item, int&nbsp;column)</td> 
 </tr> 
 <tr> 
 <td>void</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#itemExpanded" rel="nofollow">itemExpanded</a>(QTreeWidgetItem *item)</td> 
 </tr> 
 <tr> 
 <td>void</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#itemPressed" rel="nofollow">itemPressed</a>(QTreeWidgetItem *item, int&nbsp;column)</td> 
 </tr> 
 <tr> 
 <td>void</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#itemSelectionChanged" rel="nofollow">itemSelectionChanged</a>()</td> 
 </tr> 
 </tbody> 
</table>

## Protected Functions ##

<table> 
 <tbody> 
 <tr> 
 <td>virtual bool</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#dropMimeData" rel="nofollow">dropMimeData</a>(QTreeWidgetItem *parent, int&nbsp;index, const QMimeData *data, Qt::DropAction&nbsp;action)</td> 
 </tr> 
 <tr> 
 <td>QModelIndex</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#indexFromItem" rel="nofollow">indexFromItem</a>(const QTreeWidgetItem *item, int&nbsp;column&nbsp;= 0) const</td> 
 </tr> 
 <tr> 
 <td>QTreeWidgetItem *</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#itemFromIndex" rel="nofollow">itemFromIndex</a>(const QModelIndex &amp;index) const</td> 
 </tr> 
 <tr> 
 <td>virtual QMimeData *</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#mimeData" rel="nofollow">mimeData</a>(const QList&lt;QTreeWidgetItem *&gt;&nbsp;items) const</td> 
 </tr> 
 <tr> 
 <td>virtual QStringList</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#mimeTypes" rel="nofollow">mimeTypes</a>() const</td> 
 </tr> 
 <tr> 
 <td>virtual Qt::DropActions</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#supportedDropActions" rel="nofollow">supportedDropActions</a>() const</td> 
 </tr> 
 </tbody> 
</table>

## Reimplemented Protected Functions ##

<table> 
 <tbody> 
 <tr> 
 <td>virtual void</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#dropEvent" rel="nofollow">dropEvent</a>(QDropEvent *event) override</td> 
 </tr> 
 <tr> 
 <td>virtual bool</td> 
 <td><a href="https://doc.qt.io/archives/qt-5.13/qtreewidget.html#event" rel="nofollow">event</a>(QEvent *e) override</td> 
 </tr> 
 </tbody> 
</table>

## Detailed Description ##

![windows-treeview.png][]![uploading.4e448015.gif][]转存失败重新上传取消![windows-treeview.png][]

The [QTreeWidget][] class is a convenience class that provides a standard tree widget with a classic item-based interface similar to that used by the [QListView][] class in Qt 3. This class is based on Qt's Model/View architecture and uses a default model to hold items, each of which is a [QTreeWidgetItem][].

Developers who do not need the flexibility of the Model/View framework can use this class to create simple hierarchical lists very easily. A more flexible approach involves combining a [QTreeView][] with a standard item model. This allows the storage of data to be separated from its representation.

In its simplest form, a tree widget can be constructed in the following way:

QTreeWidget *treeWidget = new QTreeWidget();
 treeWidget->setColumnCount(1);
 QList<QTreeWidgetItem *> items;
 for (int i = 0; i < 10; ++i)
 items.append(new QTreeWidgetItem((QTreeWidget*)0, QStringList(QString("item: %1").arg(i))));
 treeWidget->insertTopLevelItems(0, items);

Before items can be added to the tree widget, the number of columns must be set with [setColumnCount][columnCount](). This allows each item to have one or more labels or other decorations. The number of columns in use can be found with the [columnCount][]() function.

The tree can have a header that contains a section for each column in the widget. It is easiest to set up the labels for each section by supplying a list of strings with [setHeaderLabels][](), but a custom header can be constructed with a [QTreeWidgetItem][] and inserted into the tree with the [setHeaderItem][]() function.

The items in the tree can be sorted by column according to a predefined sort order. If sorting is enabled, the user can sort the items by clicking on a column header. Sorting can be enabled or disabled by calling [setSortingEnabled()][setSortingEnabled]. The [isSortingEnabled()][setSortingEnabled] function indicates whether sorting is enabled.

**See also** [QTreeWidgetItem][], [QTreeWidgetItemIterator][], [QTreeView][], [Model/View Programming][Model_View Programming], and [Settings Editor Example][].

# 二、**QTreeWidget的一些基本操作** #

**1.insertTopLevelItems，insertTopLevelItem用来添加顶层的item**

QTreeWidget *treeWidget = new QTreeWidget(this);//创建
 treeWidget->setColumnCount(1); //设置列
 treeWidget->setHeaderLabel(tr("item tree")); //设置标题
 treeWidget->setGeometry(0,0,this->width(),this->height()); //设置大小
 QList<QTreeWidgetItem *> items;
 
 //创建两个节点
 QTreeWidgetItem *fItem1 = new QTreeWidgetItem(treeWidget,QStringList(QString("f1")));
 QTreeWidgetItem *fItem2 = new QTreeWidgetItem(treeWidget,QStringList(QString("f2")));
 
 items.append(fItem1);
 items.append(fItem2);
 //添加顶层节点
 treeWidget->insertTopLevelItems(0,items);
 //节点始终保持展开
 treeWidget->setItemsExpandable(false);
 treeWidget->expandAll();

**2.父节点通过addChild增加子节点**

//创建子节点
    QTreeWidgetItem *fItem1a = new QTreeWidgetItem(fItem1,QStringList(QString("f1a")));
    QTreeWidgetItem *fItem1b = new QTreeWidgetItem(fItem1,QStringList(QString("f1b")));
    
    QTreeWidgetItem *fItem2a = new QTreeWidgetItem(fItem2,QStringList(QString("f2a")));
    QTreeWidgetItem *fItem2b = new QTreeWidgetItem(fItem2,QStringList(QString("f2b")));
    
        //添加字节点
    fItem1->addChild(fItem1a);
    fItem1->addChild(fItem1b);
    
    fItem2->addChild(fItem2a);
    fItem2->addChild(fItem2b);

**3.建立鼠标点击右键点击信号检测**

//检测点击事件
        connect(treeWidget,SIGNAL(itemClicked(QTreeWidgetItem*,int)),this,SLOT(itemClick(QTreeWidgetItem*,int)));
        //检测鼠标右键
    treeWidget->setContextMenuPolicy(Qt::CustomContextMenu);
    connect(treeWidget,SIGNAL(customContextMenuRequested(const QPoint&)), this,SLOT(popMenu(const QPoint&)));

**4.槽函数**

void Widget::itemClick(QTreeWidgetItem *item, int column)
    {
        QTreeWidgetItem *parent = item->parent();   //获取父节点
        if(NULL==parent) //注意：最顶端项是没有父节点的
            return;
        int col = parent->indexOfChild(item); //item在父项中的节点行号(从0开始)
    }
    
    //弹出菜单
    void Widget::popMenu(const QPoint &)
    {
        QTreeWidgetItem* curItem=treeWidget->currentItem();  //**获取当前被点击的节点
        if(curItem == NULL || curItem->parent() == NULL)
            return;           //右键的位置在空白位置右击或者点击的是顶层item
    
        //创建一个action
        QAction deleteItem(QString::fromLocal8Bit("&删除"),this);
        connect(&deleteItem, SIGNAL(triggered()), this, SLOT(deleteItem()));
        QPoint pos;
        //创建一个菜单栏
        QMenu menu(treeWidget);
        menu.addAction(&deleteItem);
        menu.exec(QCursor::pos());  //在当前鼠标位置显示
    }
    
    //删除item
    void Widget::deleteItem()
    {
        QTreeWidgetItem* curItem=treeWidget->currentItem();
        curItem->parent()->removeChild(treeWidget->currentItem());
    }

# 三、QTreeWidget例子 #

#ifndef TREEWIDGET_H 
 #define TREEWIDGET_H 
 
 #include <QtGui> 
 
 class TreeWidget : public QWidget 
 { 
 public: 
 TreeWidget(); 
 
 private: 
 QTreeWidget *tree; 
 }; 
 
 #endif // TREEWIDGET_H

#include "treewidget.h" 
 
 TreeWidget::TreeWidget() 
 { 
 tree = new QTreeWidget(this); 
 tree->setColumnCount(1); 
 QTreeWidgetItem *root = new QTreeWidgetItem(tree, QStringList(QString("Root"))); 
 QTreeWidgetItem *leaf = new QTreeWidgetItem(root, QStringList(QString("Leaf 1"))); 
 root->addChild(leaf); 
 QTreeWidgetItem *leaf2 = new QTreeWidgetItem(root, QStringList(QString("Leaf 1"))); 
 leaf2->setCheckState(0, Qt::Checked); 
 root->addChild(leaf2); 
 QList<QTreeWidgetItem *> rootList; 
 rootList << root; 
 tree->insertTopLevelItems(0, rootList); 
 }

[QTreeWidget]: https://doc.qt.io/archives/qt-5.13/qtreewidget.html
[More...]: https://doc.qt.io/archives/qt-5.13/qtreewidget.html#details
[List of all members_ including inherited members]: https://doc.qt.io/archives/qt-5.13/qtreewidget-members.html
[Obsolete members]: https://doc.qt.io/archives/qt-5.13/qtreewidget-obsolete.html
[columnCount]: https://doc.qt.io/archives/qt-5.13/qtreewidget.html#columnCount-prop
[topLevelItemCount]: https://doc.qt.io/archives/qt-5.13/qtreewidget.html#topLevelItemCount-prop
[windows-treeview.png]: /images/20230528/bc4cf63eed58439f8eaffde8c8addc63.png
[uploading.4e448015.gif]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9jc2RuaW1nLmNuL3JlbGVhc2UvbXAvaW1nL3VwbG9hZGluZy40ZTQ0ODAxNS5naWY
[QListView]: https://doc.qt.io/archives/qt-5.13/qlistview.html
[QTreeWidgetItem]: https://doc.qt.io/archives/qt-5.13/qtreewidgetitem.html
[QTreeView]: https://doc.qt.io/archives/qt-5.13/qtreeview.html
[setHeaderLabels]: https://doc.qt.io/archives/qt-5.13/qtreewidget.html#setHeaderLabels
[setHeaderItem]: https://doc.qt.io/archives/qt-5.13/qtreewidget.html#setHeaderItem
[setSortingEnabled]: https://doc.qt.io/archives/qt-5.13/qtreeview.html#sortingEnabled-prop
[QTreeWidgetItemIterator]: https://doc.qt.io/archives/qt-5.13/qtreewidgetitemiterator.html
[Model_View Programming]: https://doc.qt.io/archives/qt-5.13/model-view-programming.html
[Settings Editor Example]: https://doc.qt.io/archives/qt-5.13/qtwidgets-tools-settingseditor-example.html