[TOC] ## 概述  或  1. 默認的列數是 1 列, 2. 如果涉及到多列數據，比如文件瀏覽樹，有文件名、文件類型、大小、修改時間等等，就需要設置為多列數據的樹 常用函數 ``` QTreeWidget(QWidget * parent = 0) // 必須設置列數 void setColumnCount(int columns) //設置列數 int columnCount() const //獲取列數 // 默認的列數是 1 列，如果涉及到多列數據，比如文件瀏覽樹，有文件名、文件類型、大小、修改時間等等，就需要設置為多列數據的樹 // 添加和訪問頂級條目 void QTreeWidget::?addTopLevelItem(QTreeWidgetItem * item) //添加一個頂級條目到末尾 void QTreeWidget::?addTopLevelItems(const QList<QTreeWidgetItem *> & items) //添加多個頂級條目到末尾 // 添加到指定頂級條目 void QTreeWidget::?insertTopLevelItem(int index, QTreeWidgetItem * item) void QTreeWidget::?insertTopLevelItems(int index, const QList<QTreeWidgetItem *> & items) // 移除頂級條目 QTreeWidgetItem * QTreeWidget::?takeTopLevelItem(int index) void QTreeWidget::?clear() // 清空所有的頂級條目和子條目 // 條目訪問函數 QTreeWidgetItem * QTreeWidget::?topLevelItem(int index) const int QTreeWidget::?indexOfTopLevelItem(QTreeWidgetItem * item) const // 訪問相鄰條目,可能同級,父級或是子級 QTreeWidgetItem * QTreeWidget::?itemAbove(const QTreeWidgetItem * item) const //上面相鄰條目 QTreeWidgetItem * QTreeWidget::?itemBelow(const QTreeWidgetItem * item) const //下面相鄰條目 // 當前條目的操作 QTreeWidgetItem * QTreeWidget::?currentItem() const int QTreeWidget::?currentColumn() const // 多航頂級條目時返回選中的 // 設置某個條目為當前選中的狀態 void QTreeWidget::?setCurrentItem(QTreeWidgetItem * item) void QTreeWidget::?setCurrentItem(QTreeWidgetItem * item, int column) void QTreeWidget::?setCurrentItem(QTreeWidgetItem * item, int column, QItemSelectionModel::SelectionFlags command) // 條目查找 QList<QTreeWidgetItem *> QTreeWidget::?findItems(const QString & text, Qt::MatchFlags flags, int column = 0) const // 排序 bool isSortingEnabled() const //設置是否自動排序 void setSortingEnabled(bool enable) //查看是否開啟自動排序 void QTreeView::?sortByColumn(int column, Qt::SortOrder order) // 指定某行排序 //條目顯示和運行時條目編輯 //可以為條目的某列“單元格”設置單獨的控件來靜態顯示（控件不具有編輯功能） void QTreeWidget::?setItemWidget(QTreeWidgetItem * item, int column, QWidget * widget) //設置條目列控件 QWidget * QTreeWidget::?itemWidget(QTreeWidgetItem * item, int column) const //獲取條目列控件，不設置就是NULL // 刪除條目控件 void QTreeWidget::?removeItemWidget(QTreeWidgetItem * item, int column) // 選中行為和選中模式 QAbstractItemView::SelectionBehavior selectionBehavior() const //獲取選中行為，按條目選中、整行或整列選中 void setSelectionBehavior(QAbstractItemView::SelectionBehavior behavior) //設置選中行為 QAbstractItemView::SelectionMode selectionMode() const //獲取選中模式，比如單選、多選、擴展選擇 void setSelectionMode(QAbstractItemView::SelectionMode mode) //設置選中模式 ``` ## 樹頭條目 ``` void QTreeWidget::?setHeaderItem(QTreeWidgetItem * item) //設置樹頭條目，樹頭條目可以有多列數據，相當于多列的表頭一次性設置了 void QTreeWidget::?setHeaderLabel(const QString & label) //只設置第 0 列的表頭 void QTreeWidget::?setHeaderLabels(const QStringList & labels) //設置多列的表頭 QTreeWidgetItem * QTreeWidget::?headerItem() const //獲取樹頭條目 ``` 樹頭條目本質其實也是由 QHeaderView 子控件來顯示的 ``` QHeaderView * QTreeView::?header() const //獲取表頭視圖控件 void QTreeView::?setHeader(QHeaderView * header) //設置表頭視圖， 一般樹形控件不需要用這個函數 void QTreeView::setHeaderHidden(bool hide) //設置表頭是否隱藏 bool QTreeView::isHeaderHidden() const //判斷是否隱藏了表頭 ``` ## 示例 ### 初始化 ``` ui->setupUi(this); //設置樹形控件只有 1 列 ui->treeWidget->setColumnCount( 1 ); //創建A條目，添加到頂級條目 QTreeWidgetItem *itemA = new QTreeWidgetItem(); itemA->setText(0, "A"); ui->treeWidget->addTopLevelItem(itemA); //創建 B、C條目，添加給 A QTreeWidgetItem *itemB = new QTreeWidgetItem(); itemB->setText(0, "B"); itemA->addChild( itemB ); //創建D、E條目，構造函數指定父條目為 B，自動設置父子關系 QTreeWidgetItem *itemD = new QTreeWidgetItem(itemB); itemD->setText(0, "D"); //設置樹形控件2列 //ui->treeWidget->setColumnCount( 2 ); //各列均勻拉伸 ui->treeWidget->header()->setSectionResizeMode(QHeaderView::Stretch); //展開所有子孫節點 ui->treeWidget->expandAll(); // 方式二:添加item //樹形控件構造條目 for(int i=0; i<5; i++) { QTreeWidgetItem *itemT = new QTreeWidgetItem( ui->treeWidget ); itemT->setText(0, tr("treeItem %1, 0").arg(i) ); itemT->setText(1, tr("t%1, 1").arg(i) ); } ``` ### 雙擊修改 ``` // 添加信號 connect(view,&QTreeWidget::itemDoubleClicked,this,&MainWindow::itemDoubleClicked); // 處理函數 // 雙擊修改 void MainWindow::itemDoubleClicked(QTreeWidgetItem *item, int column) { qDebug()<< column; item->setFlags(item->flags()|Qt::ItemIsEditable); view->editItem(item,column); } ``` ### 設置三態復選框 ``` // 迭代器 QTreeWidgetItemIterator it(ui->treeWidget); while (*it) { //取出當前條目 QTreeWidgetItem *item = *it; if(item->childCount() > 0 )//有子節點開啟三態復選，沒子節點是二態復選 { item->setFlags( item->flags() | Qt::ItemIsTristate ); } item->setCheckState(0, Qt::Unchecked); //正常應該只用第0列的復選框，代表一整行條目 //找下一個條目 ++it; } ```