QTreeWidget 详解

QTreeWidget 是 PyQt5 框架中的一个重要部件，它提供了树形结构的视图，可以用于显示层级数据。以下是 QTreeWidget 的详细讲解，包括基本用法、主要方法和属性以及如何与其他组件进行交互。

基本用法

1. 导入模块 要使用 QTreeWidget，首先需要导入相关模块：

   from PyQt5.QtWidgets import QTreeWidget, QTreeWidgetItem, QApplication
   import sys
   

2. 创建 QTreeWidget 实例 创建 QTreeWidget 的实例并设置其列数和列标题：

   app = QApplication(sys.argv)
   tree = QTreeWidget()
   tree.setColumnCount(2)
   tree.setHeaderLabels(["Column 1", "Column 2"])
   

3. 添加顶层项和子项 添加顶层项（根项）和子项：

   root = QTreeWidgetItem(tree)
   root.setText(0, "Root Item 1")
   root.setText(1, "Root Item 1 Description")
   child1 = QTreeWidgetItem(root)
   child1.setText(0, "Child 1")
   child1.setText(1, "Child 1 Description")
   child2 = QTreeWidgetItem(root)
   child2.setText(0, "Child 2")
   child2.setText(1, "Child 2 Description")
   

4. 显示窗口 设置窗口大小并显示：

   tree.setWindowTitle("QTreeWidget Example")
   tree.resize(400, 300)
   tree.show()
   sys.exit(app.exec_())
   

主要方法和属性

• 添加和删除项
  • addTopLevelItem(item): 添加顶层项。
  • addTopLevelItems(items): 添加多个顶层项。
  • takeTopLevelItem(index): 删除并返回指定索引的顶层项。
  • clear(): 清空所有项。
  • 项操作
    • setText(column, text): 设置指定列的文本。
    • text(column): 获取指定列的文本。
    • addChild(child): 为当前项添加子项。
    • takeChild(index): 删除并返回指定索引的子项。
    • child(index): 返回指定索引的子项。
    • childCount(): 返回子项数目。
    • 信号和槽
      • itemClicked(item, column): 单击项时发射信号。
      • itemDoubleClicked(item, column): 双击项时发射信号。
      • itemChanged(item, column): 项目改变时发射信号。

        代码示例

        以下是一个完整的示例，展示了如何使用 QTreeWidget 以及如何响应用户的交互：

        from PyQt5.QtWidgets import QTreeWidget, QTreeWidgetItem, QApplication, QVBoxLayout, QWidget, QLabel
        import sys
        class TreeWidgetDemo(QWidget):
            def __init__(self):
                super().__init__()
                self.initUI()
            def initUI(self):
                self.setWindowTitle('QTreeWidget Demo')
                self.setGeometry(100, 100, 600, 400)
                self.tree = QTreeWidget(self)
                self.tree.setColumnCount(2)
                self.tree.setHeaderLabels(['Name', 'Description'])
                root1 = QTreeWidgetItem(self.tree)
                root1.setText(0, 'Root 1')
                root1.setText(1, 'Root 1 Description')
                child1 = QTreeWidgetItem(root1)
                child1.setText(0, 'Child 1')
                child1.setText(1, 'Child 1 Description')
                child2 = QTreeWidgetItem(root1)
                child2.setText(0, 'Child 2')
                child2.setText(1, 'Child 2 Description')
                root2 = QTreeWidgetItem(self.tree)
                root2.setText(0, 'Root 2')
                root2.setText(1, 'Root 2 Description')
                layout = QVBoxLayout(self)
                layout.addWidget(self.tree)
                self.label = QLabel("Selected Item Info", self)
                layout.addWidget(self.label)
                self.tree.itemClicked.connect(self.onItemClicked)
                self.setLayout(layout)
            def onItemClicked(self, item, column):
                self.label.setText(f"Selected: {item.text(0)} - {item.text(1)}")
        if __name__ == '__main__':
            app = QApplication(sys.argv)
            demo = TreeWidgetDemo()
            demo.show()
            sys.exit(app.exec_())
        

        示例界面如图所示：

        这个示例展示了一个包含两个顶层项和多个子项的树形视图，并且当用户点击某个项时，在窗口底部的标签中显示该项的信息。

        通过上述步骤和示例，应该能够掌握 QTreeWidget 的基本用法，并在 PyQt5 应用程序中实现树形结构视图。