3.5.2 TreeWidget控件

1.控件位置

Item Widget→TreeWidget

2.控件介绍

TreeWidget控件（树形单元控件）继承于QTreeView类，样式如图3-40所示。

 

TreeWidget控件是树形视图使用　图3-40　TreeWidget控件预定义的模型，它也是基于模型/视图结构的控件。为方便开发人员使用树形视图，可以使用这个控件来创建简单的树形结构列表。

3.控件设置选项

在TreeWidget控件的properties选项中，一般常对以下选项进行设置。

name：该控件对应源代码中的名称；

font：设置表格内部的字体；

columnCount：保存该TreeWidget的列数。

4.常用成员函数

1) QTreeWidget::QTreeWidget ( QWidget *parent = 0 )

构造一个父对象为parent的TreeWidget。

2) void QTreeWidget::addTopLevelItem ( QTreeWidgetItem *item )

在该TreeWidget中追加item为顶级项目。

3) void QTreeWidget::addTopLevelItems ( const QList<QTreeWidgetItem *> & items )

把items中的项目作为顶级项目追加到该TreeWidget中。

4) void QTreeWidget::clear () ［slot］

清除该TreeWidget中的所有项目。

5) void QTreeWidget::collapseItem ( const QTreeWidgetItem *item ) ［slot］

折叠项目item。

6) int QTreeWidget::currentColumn () const

返回当前活动列。

7) QTreeWidgetItem *QTreeWidget::currentItem () const

返回当前活动项目。

8) void QTreeWidget::editItem ( QTreeWidgetItem *item, int column = 0 )

如果列column的item是可编辑的，开始编辑。

9) void QTreeWidget::expandItem ( const QTreeWidgetItem *item ) ［slot］
展开项目item。

10) QList<QTreeWidgetItem *> QTreeWidget::findItems ( const QString & text, QT::MatchFlags flags, int column = 0 ) const

查找匹配字符串text的项目，并返回查找结果。

11) QTreeWidgetItem *QTreeWidget::headerItem () const

返回头项目。

12) QModelIndex QTreeWidget::indexFromItem ( QTreeWidgetItem *item, int column = 0 ) const ［protected］

返回列column的项目item的模型索引。

13) int QTreeWidget::indexOfTopLevelItem ( QTreeWidgetItem *item ) const

返回顶级项目item的模型索引，如果item不存在则返回-1。

14) int QTreeWidget::sortColumn () const

返回排序的列。

15) void QTreeWidget::sortItems ( int column, QT::SortOrder order )

对列column的项目按照order进行排序。

16) QTreeWidgetItem *QTreeWidget::itemAbove ( const QTreeWidgetItem *item ) const

返回item的上一个项目。

17) QTreeWidgetItem *QTreeWidget::itemAt ( const QPoint & p ) const

返回点p处的项目。

18) QTreeWidgetItem *QTreeWidget::itemAt ( int x, int y ) const

返回坐标(x,y)处的项目。

19) void QTreeWidget::setItemWidget ( QTreeWidgetItem *item, int column, QWidget *widget )

设置控件widget为项目item的显示控件，项目item在列column中。

20) QTreeWidgetItem *QTreeWidget::itemBelow ( const QTreeWidgetItem *item ) const

返回item的下一个项目。

21) QWidget *QTreeWidget::itemWidget ( QTreeWidgetItem *item, int column ) const

返回列column中的项目item的显示控件。

22) void QTreeWidget::removeItemWidget ( QTreeWidgetItem *item, int column )

移除列column中的项目item的显示控件。

23) QList<QTreeWidgetItem *> QTreeWidget::selectedItems () const

返回所有选中状态的项目。

24) void QTreeWidget::setCurrentItem ( QTreeWidgetItem *item )

设置项目item为当前项目。

25) void QTreeWidget::setCurrentItem ( QTreeWidgetItem *item, int column )

设置列column的项目item为当前项目。

26) void QTreeWidget::setHeaderItem ( QTreeWidgetItem *item )

设置item为该TreeWidget的头项目。

27) void QTreeWidget::setHeaderLabel ( const QString & label )

设置label为头标题。

28) QTreeWidgetItem *QTreeWidget::topLevelItem ( int index ) const

返回所有index的顶级项目。