QTreeWidget 详解

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 应用程序中实现树形结构视图。