### Python 中 QtWidgets.QTreeWidget 的使用方法 `QTreeWidget` 是 PyQt 或 PySide 提供的一个用于显示分层数据的控件。它允许用户创建具有父子关系的项目列表，并支持自定义列、图标以及交互功能。 以下是 `QTreeWidget` 的基本使用方法及其示例代码： #### 创建 QTreeWidget 并设置表头 通过调用 `setHeaderLabels()` 方法可以为树形结构设置多个列名。 ```python tree_widget = QTreeWidget() tree_widget.setHeaderLabels(["Column 1", "Column 2"]) ``` #### 添加根节点和子节点 可以通过 `QTreeWidgetItem` 类来创建节点并将其添加到树中。 ```python root = QTreeWidgetItem(tree_widget, ["Root Item", "Data"]) child1 = QTreeWidgetItem(root, ["Child 1", "Sub Data 1"]) child2 = QTreeWidgetItem(root, ["Child 2", "Sub Data 2"]) ``` #### 设置节点属性 可以为节点附加额外的数据，或者为其设置图标。 ```python # 设置用户数据 (例如路径或其他元信息) child1.setData(0, Qt.UserRole, "/path/to/file") # 设置图标 icon = QIcon("file_icon.png") child1.setIcon(0, icon) ``` #### 获取可见项的位置矩形 利用 `visualItemRect()` 方法可以获得某个项目的可视区域位置。 ```python rect = tree_widget.visualItemRect(child1) print(f"Visible rectangle of child1: {rect}") ``` #### 查找特定项 如果需要搜索符合条件的项，则可使用 `findItems()` 方法[^4]。 ```python items_found = tree_widget.findItems("Search Text", Qt.MatchContains | Qt.MatchRecursive) for item in items_found: print(item.text(0)) ``` #### 完整示例代码 以下是一个完整的示例程序展示如何初始化 `QTreeWidget` 和操作其内部元素： ```python import sys from PyQt5.QtWidgets import QApplication, QTreeWidget, QTreeWidgetItem, QWidget, QVBoxLayout from PyQt5.QtCore import Qt class TreeExample(QWidget): def __init__(self): super().__init__() layout = QVBoxLayout() # 初始化 QTreeWidget 控件 self.tree = QTreeWidget() self.tree.setColumnCount(2) # 设定两列 self.tree.setHeaderLabels(["Name", "Type"]) # 构建层次结构 root = QTreeWidgetItem(self.tree, ["My Computer"]) disk_c = QTreeWidgetItem(root, ["C Drive", "NTFS"]) file_item = QTreeWidgetItem(disk_c, ["Document.txt", "Text File"]) # 扩展所有节点以便查看全部内容 self.tree.expandAll() # 将树控件加入布局 layout.addWidget(self.tree) self.setLayout(layout) if __name__ == "__main__": app = QApplication(sys.argv) window = TreeExample() window.resize(400, 300) window.setWindowTitle("QTreeWidget Example") window.show() sys.exit(app.exec_()) ``` 此脚本展示了如何建立一个简单的文件系统表示形式，其中包含计算机驱动器及一些虚拟文件条目[^3]。