一、QTreeWidget Class

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

Header:	#include <QTreeWidget>
qmake:	QT += widgets
Inherits:	QTreeView

• List of all members, including inherited members
• Obsolete members

Properties

• columnCount?: int
• topLevelItemCount?: const int

Public Functions

?	QTreeWidget(QWidget *parent?= nullptr)
virtual	~QTreeWidget()
void	addTopLevelItem(QTreeWidgetItem *item)
void	addTopLevelItems(const QList<QTreeWidgetItem *> &items)
void	closePersistentEditor(QTreeWidgetItem *item, int?column?= 0)
int	columnCount() const
int	currentColumn() const
QTreeWidgetItem *	currentItem() const
void	editItem(QTreeWidgetItem *item, int?column?= 0)
QList<QTreeWidgetItem *>	findItems(const QString &text, Qt::MatchFlags?flags, int?column?= 0) const
QTreeWidgetItem *	headerItem() const
int	indexOfTopLevelItem(QTreeWidgetItem *item) const
void	insertTopLevelItem(int?index, QTreeWidgetItem *item)
void	insertTopLevelItems(int?index, const QList<QTreeWidgetItem *> &items)
QTreeWidgetItem *	invisibleRootItem() const
bool	isPersistentEditorOpen(QTreeWidgetItem *item, int?column?= 0) const
QTreeWidgetItem *	itemAbove(const QTreeWidgetItem *item) const
QTreeWidgetItem *	itemAt(const QPoint &p) const
QTreeWidgetItem *	itemAt(int?x, int?y) const
QTreeWidgetItem *	itemBelow(const QTreeWidgetItem *item) const
QWidget *	itemWidget(QTreeWidgetItem *item, int?column) const
void	openPersistentEditor(QTreeWidgetItem *item, int?column?= 0)
void	removeItemWidget(QTreeWidgetItem *item, int?column)
QList<QTreeWidgetItem *>	selectedItems() const
void	setColumnCount(int?columns)
void	setCurrentItem(QTreeWidgetItem *item)
void	setCurrentItem(QTreeWidgetItem *item, int?column)
void	setCurrentItem(QTreeWidgetItem *item, int?column, QItemSelectionModel::SelectionFlags?command)
void	setHeaderItem(QTreeWidgetItem *item)
void	setHeaderLabel(const QString &label)
void	setHeaderLabels(const QStringList &labels)
void	setItemWidget(QTreeWidgetItem *item, int?column, QWidget *widget)
int	sortColumn() const
void	sortItems(int?column, Qt::SortOrder?order)
QTreeWidgetItem *	takeTopLevelItem(int?index)
QTreeWidgetItem *	topLevelItem(int?index) const
int	topLevelItemCount() const
QRect	visualItemRect(const QTreeWidgetItem *item) const

Reimplemented Public Functions

virtual void

setSelectionModel(QItemSelectionModel *selectionModel) override

Public Slots

void	clear()
void	collapseItem(const QTreeWidgetItem *item)
void	expandItem(const QTreeWidgetItem *item)
void	scrollToItem(const QTreeWidgetItem *item, QAbstractItemView::ScrollHint?hint?= EnsureVisible)

Signals

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	itemCollapsed(QTreeWidgetItem *item)
void	itemDoubleClicked(QTreeWidgetItem *item, int?column)
void	itemEntered(QTreeWidgetItem *item, int?column)
void	itemExpanded(QTreeWidgetItem *item)
void	itemPressed(QTreeWidgetItem *item, int?column)
void	itemSelectionChanged()

Protected Functions

virtual bool	dropMimeData(QTreeWidgetItem *parent, int?index, const QMimeData *data, Qt::DropAction?action)
QModelIndex	indexFromItem(const QTreeWidgetItem *item, int?column?= 0) const
QTreeWidgetItem *	itemFromIndex(const QModelIndex &index) const
virtual QMimeData *	mimeData(const QList<QTreeWidgetItem *>?items) const
virtual QStringList	mimeTypes() const
virtual Qt::DropActions	supportedDropActions() const

Reimplemented Protected Functions

virtual void	dropEvent(QDropEvent *event) override
virtual bool	event(QEvent *e) override

Detailed Description

轉(zhuǎn)存失敗重新上傳取消

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(). 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(). The?isSortingEnabled()?function indicates whether sorting is enabled.

See also?QTreeWidgetItem,?QTreeWidgetItemIterator,?QTreeView,?Model/View Programming, and?Settings Editor Example.

二、QTreeWidget的一些基本操作

1.insertTopLevelItems，insertTopLevelItem用來(lái)添加頂層的item

QTreeWidget *treeWidget = new QTreeWidget(this);//創(chuàng)建 treeWidget->setColumnCount(1); //設(shè)置列 treeWidget->setHeaderLabel(tr("item tree")); //設(shè)置標(biāo)題 treeWidget->setGeometry(0,0,this->width(),this->height()); //設(shè)置大小 QList<QTreeWidgetItem *> items;//創(chuàng)建兩個(gè)節(jié)點(diǎn) QTreeWidgetItem *fItem1 = new QTreeWidgetItem(treeWidget,QStringList(QString("f1"))); QTreeWidgetItem *fItem2 = new QTreeWidgetItem(treeWidget,QStringList(QString("f2")));items.append(fItem1); items.append(fItem2); //添加頂層節(jié)點(diǎn) treeWidget->insertTopLevelItems(0,items); //節(jié)點(diǎn)始終保持展開 treeWidget->setItemsExpandable(false); treeWidget->expandAll();

2.父節(jié)點(diǎn)通過(guò)addChild增加子節(jié)點(diǎn)

//創(chuàng)建子節(jié)點(diǎn) 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")));//添加字節(jié)點(diǎn) fItem1->addChild(fItem1a); fItem1->addChild(fItem1b);fItem2->addChild(fItem2a); fItem2->addChild(fItem2b);

3.建立鼠標(biāo)點(diǎn)擊右鍵點(diǎn)擊信號(hào)檢測(cè)

//檢測(cè)點(diǎn)擊事件connect(treeWidget,SIGNAL(itemClicked(QTreeWidgetItem*,int)),this,SLOT(itemClick(QTreeWidgetItem*,int)));//檢測(cè)鼠標(biāo)右鍵 treeWidget->setContextMenuPolicy(Qt::CustomContextMenu); connect(treeWidget,SIGNAL(customContextMenuRequested(const QPoint&)), this,SLOT(popMenu(const QPoint&)));

4.槽函數(shù)

void Widget::itemClick(QTreeWidgetItem *item, int column) {QTreeWidgetItem *parent = item->parent(); //獲取父節(jié)點(diǎn)if(NULL==parent) //注意：最頂端項(xiàng)是沒有父節(jié)點(diǎn)的return;int col = parent->indexOfChild(item); //item在父項(xiàng)中的節(jié)點(diǎn)行號(hào)(從0開始) }//彈出菜單 void Widget::popMenu(const QPoint &) {QTreeWidgetItem* curItem=treeWidget->currentItem(); //**獲取當(dāng)前被點(diǎn)擊的節(jié)點(diǎn)if(curItem == NULL || curItem->parent() == NULL)return; //右鍵的位置在空白位置右擊或者點(diǎn)擊的是頂層item//創(chuàng)建一個(gè)actionQAction deleteItem(QString::fromLocal8Bit("&刪除"),this);connect(&deleteItem, SIGNAL(triggered()), this, SLOT(deleteItem()));QPoint pos;//創(chuàng)建一個(gè)菜單欄QMenu menu(treeWidget);menu.addAction(&deleteItem);menu.exec(QCursor::pos()); //在當(dāng)前鼠標(biāo)位置顯示 }//刪除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); }

?

?

總結(jié)

以上是生活随笔為你收集整理的Qt学习笔记之常用控件QTreeWidget的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問(wèn)題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。