pyqt5-QTreeWidget树组件

1、介绍

QTreeWidget，树组件。

2、顶级项

addTopLevelItem(self, item: QTreeWidgetItem)

• 末尾添加单个顶级项

addTopLevelItems(self, items: Iterable[QTreeWidgetItem])

• 末尾批量添加顶级项

insertTopLevelItem(self, index: int, item: QTreeWidgetItem)

• 指定索引插入单个顶级项

insertTopLevelItems(self, index: int, items: Iterable[QTreeWidgetItem]) 

• 指定索引批量插入顶级项

topLevelItemCount(self) -> int

• 返回顶级项的个数

takeTopLevelItem(self, index: int) -> QTreeWidgetItem 

• 移除指定索引的顶级项，并作为返回对象

topLevelItem(self, index: int) -> QTreeWidgetItem

• 获取指定索引的顶级项

3、当前项

currentItem(self) -> QTreeWidgetItem

• 获取当前项。
• 如果树组件存在节点，则会默认选中索引为0的顶级节点
• 如果树组件中不存在任何节点，则会返回None
• 可以获取顶级节点，也可以获取子节点。
• 点击树组件外区域，不会丢失选中状态
• 标题栏是否存在，不会影响当前项
• 如果本身没有任何节点，即没有选中项，那么再添加时不会改变，仍然是None。

setCurrentItem(self, item: QTreeWidgetItem)
setCurrentItem(self, item: QTreeWidgetItem, column: int)
setCurrentItem(self, item: QTreeWidgetItem, column: int, command: Union[QItemSelectionModel.SelectionFlags, QItemSelectionModel.SelectionFlag])

• 设置当前项

currentIndex(self) -> QModelIndex

currentIndex().row(self) -> int 

• QModelIndex对象的主要作用是其row方法，返回当前项在其父级节点中的索引
• 如果树组件中存在节点，则默认选中索引为0的顶级节点。反之，则不选中任何节点，此时仍然可以获取到QModelIndex对象，其row方法返回-1

setCurrentIndex(self, index: QModelIndex)

•  

4、其它设置

columnCount(self) -> int

• 获取列数

currentColumn(self) -> int 

• 当前列的索引

5、项QTreeWidgetItem

 

clear(self)

• 清除

collapseItem(self, item: QTreeWidgetItem)

• 收缩

expandItem(self, item: QTreeWidgetItem)

• 展开