Qt中文手册 之 QTreeWidget

头文件：#include<QTreeWidget>

继承自：QTreeView

属性：

1、columnCount : int

    树中有多少列，默认是1；

intcolumnCount() constvoidsetColumnCount(int columns)

 2、topLevelItemCount : constint

    树中有多少顶层项，默认是0；

成员函数

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

    默认构造函数。

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

   在树最后添加一个顶层项。

3、void QTreeWidget::addTopLevelItems(constQList<QTreeWidgetItem *> & items)

   在树最后添加一组顶层项。

4、void QTreeWidget::clear()[slot]

   清空。

5、void QTreeWidget::closePersistentEditor(QTreeWidgetItem * item,int column = 0)

    如果指定的项处于编辑状态，则取消编辑状态。

6、void QTreeWidget::collapseItem(constQTreeWidgetItem * item)[slot]

     折叠item下的子项

？？？？？？？？？？？？？？？？？？？？？？？？

7、int QTreeWidget::currentColumn() const

     返回当前选择的列（从0开始），没有选择则返回-1；

8、QTreeWidgetItem * QTreeWidget::currentItem() const

   返回当前选择的项

9、void QTreeWidget::currentItemChanged(QTreeWidgetItem * current,QTreeWidgetItem * previous)[signal]

  当前项发生改变时，发送该信号。

10、bool QTreeWidget::dropMimeData(QTreeWidgetItem * parent,int index, const QMimeData * data,Qt::DropAction action)

   拖放时，在指定的index处执行action动作。

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

   如果指定的项可以编辑，进入编辑状态

12、void QTreeWidget::expandItem(constQTreeWidgetItem * item)

    展开项item下的子项。

13、QList<QTreeWidgetItem *> QTreeWidget::findItems(constQString & text,Qt::MatchFlags flags,int column = 0) const

    返回匹配text及指定标志flags，在第column列的所有项。

14、QTreeWidgetItem * QTreeWidget::headerItem() const

    返回树头的项？？？？？？？？？？

15、QModelIndex QTreeWidget::indexFromItem(QTreeWidgetItem * item,int column = 0) const

    返回item指定列的数据模式QModelIndex

16、int QTreeWidget::indexOfTopLevelItem(QTreeWidgetItem * item) const

     返回给定item的索引

17、void QTreeWidget::insertTopLevelItem(int index,QTreeWidgetItem * item)

    在指定的索引处，插入一个顶层项。

18、void QTreeWidget::insertTopLevelItems(int index, constQList<QTreeWidgetItem *> & items)   

    在指定的索引处，插入一组顶层项。

19、QTreeWidgetItem * QTreeWidget::invisibleRootItem() const

返回根项（该项看不见，用做递归等操作）

20、bool QTreeWidget::isFirstItemColumnSpanned(constQTreeWidgetItem * item) const

   如果给定的item所在的列，只显示item自己（遮盖其他项），返回true，否则返回false。？？？？？？

21、QTreeWidgetItem * QTreeWidget::itemAbove(constQTreeWidgetItem * item) const

    返回给定的item的上一个item

22、[signal] void QTreeWidget::itemActivated(QTreeWidgetItem * item,int column)

     当一个项被激活时，发送该信号。被激活是指：单击或者双击（和平台有关）、或者按下Enter。

23、QTreeWidgetItem * QTreeWidget::itemAt(constQPoint & p) const

     返回相对于树窗口（tree widget）坐标处的item

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

     同上

25、QTreeWidgetItem * QTreeWidget::itemBelow(constQTreeWidgetItem * item) const

     返回给定的item下面的那个项

26、[signal] void QTreeWidget::itemChanged(QTreeWidgetItem* item,int column)

     当item改变时，发送该信号？？？？？？？？？？？

27、[signal] void QTreeWidget::itemClicked(QTreeWidgetItem * item,int column)

      点击item发送该信号

28、[signal] void QTreeWidget::itemCollapsed(QTreeWidgetItem * item)

      当item折起来时（子项不显示），发送该信号

29、[signal] void QTreeWidget::itemDoubleClicked(QTreeWidgetItem * item,int column)

      双击item时发送该信号

30、[signal] void QTreeWidget::itemEntered(QTreeWidgetItem * item,int column)

       当鼠标光标进入时，发送该信号，注意该窗口必须使能鼠标跟踪

31、[signal] void QTreeWidget::itemExpanded(QTreeWidgetItem * item)

     当展开item时，发送该信号

 32、[protected] QTreeWidgetItem * QTreeWidget::itemFromIndex(constQModelIndex & index) const

       返回index（QModelIndex）处的项

33、[signal] void QTreeWidget::itemPressed(QTreeWidgetItem * item,int column)

      当item被鼠标按下时，发送该信号

34、[signal] void QTreeWidget::itemSelectionChanged()

     当选择的区域发生改变时，发送该信号

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

       返回指定item的第column列的窗口部件

36、[virtual protected] QMimeData * QTreeWidget::mimeData(constQList<QTreeWidgetItem *> items) const

     返回项列表的mime型数据

37、[virtual protected] QStringList QTreeWidget::mimeTypes() const

    返回描述树的mime类型

38、void QTreeWidget::openPersistentEditor(QTreeWidgetItem * item,int column = 0)

     编辑指定的item的第column列

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

   删除指定的item的第column列中的窗口部件

40、[slot] void QTreeWidget::scrollToItem(constQTreeWidgetItem * item,QAbstractItemView::ScrollHint hint = EnsureVisible)

   当滚动时，确保item可见。？？？？？？？？

 

 41、 QList<QTreeWidgetItem *> QTreeWidget::selectedItems() const

   返回选择区域没有隐藏的项的列表

42、void QTreeWidget::setCurrentItem(QTreeWidgetItem * item)

   设置item为当前的项

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

  设置item的第column列为当前的项

44、void QTreeWidget::setCurrentItem(QTreeWidgetItem * item,int column,QItemSelectionModel::SelectionFlags command)

    使用指定命令 设置item的第column列为当前的项

45、void QTreeWidget::setFirstItemColumnSpanned(constQTreeWidgetItem * item,bool span)

  如果span为true，item只显示第一列

46、void QTreeWidget::setHeaderItem(QTreeWidgetItem * item)

    使用item设置表头

47、void QTreeWidget::setHeaderLabel(constQString & label)

   设置表头的第一列，显示为label

48、void QTreeWidget::setHeaderLabels(constQStringList & labels)

  设置表头

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

  将widget设置为指定的item的第column列窗口部件

50、int QTreeWidget::sortColumn() const

返回排序的那一列

 

51、void QTreeWidget::sortItems(int column,Qt::SortOrder order)

  使用指定的排序规则order对第column列进行排序

52、[virtual protected] Qt::DropActions QTreeWidget::supportedDropActions() const

   返回该tree窗口支持的拖放操作

53、QTreeWidgetItem * QTreeWidget::takeTopLevelItem(int index)

   删除给定index的顶层项，并将它返回，如果不存在返回0

54、QTreeWidgetItem * QTreeWidget::topLevelItem(int index) const

    返回给定index的顶层项，如果不存在返回0

55、QRect QTreeWidget::visualItemRect(constQTreeWidgetItem * item) const

   返回给定item的位置和尺寸。