QTreeWidget 详解

QTreeWidget 详解

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

基本用法

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

   from PyQt5.QtWidgets import QTreeWidget, QTreeWidgetItem, QApplicationimport 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, QLabelimport sysclass 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 应用程序中实现树形结构视图。