### 在 Python 中使用 QtWidgets.QTreeWidget 实现关键字搜索与筛选功能 要在 Python 的 `QtWidgets.QTreeWidget` 中实现关键字搜索与筛选功能，可以通过遍历树的所有项并根据输入的关键字动态显示或隐藏相应的项。以下是一个完整的解决方案[^1]。 首先，需要创建一个 `QTreeWidget` 并填充数据。然后，通过连接一个 `QLineEdit` 的文本变化信号到自定义的过滤函数，实现动态筛选功能。以下是具体代码示例： ```python from PyQt6.QtWidgets import QApplication, QTreeWidget, QTreeWidgetItem, QVBoxLayout, QLineEdit, QWidget class TreeSearchApp(QWidget): def __init__(self): super().__init__() # 初始化 UI 元素 self.tree = QTreeWidget() self.tree.setHeaderLabels(["Name", "Value"]) self.search_bar = QLineEdit() self.search_bar.setPlaceholderText("Search...") self.search_bar.textChanged.connect(self.filter_items) # 填充树数据 self.populate_tree() # 设置布局 layout = QVBoxLayout() layout.addWidget(self.search_bar) layout.addWidget(self.tree) self.setLayout(layout) def populate_tree(self): """填充 QTreeWidget 数据""" items = [ ("Item 1", "Value 1"), ("Item 2", "Value 2"), ("Item 3", "Value 3"), ("Keyword Item", "Keyword Value"), ("Another Keyword", "More Keywords") ] for name, value in items: item = QTreeWidgetItem([name, value]) self.tree.addTopLevelItem(item) def filter_items(self, text): """根据搜索框文本过滤树中的项""" for i in range(self.tree.topLevelItemCount()): item = self.tree.topLevelItem(i) if text.lower() in item.text(0).lower() or text.lower() in item.text(1).lower(): item.setHidden(False) # 如果匹配，则显示该项 else: item.setHidden(True) # 如果不匹配，则隐藏该项 if __name__ == "__main__": import sys app = QApplication(sys.argv) window = TreeSearchApp() window.show() sys.exit(app.exec()) ``` #### 代码解析 1. **UI 构建**： - 使用 `QVBoxLayout` 将 `QLineEdit` 和 `QTreeWidget` 布局在一起。 - `QLineEdit` 用于接收用户输入的关键字，并通过 `textChanged` 信号触发过滤逻辑[^1]。 2. **数据填充**： - 调用 `populate_tree` 方法向 `QTreeWidget` 添加顶层项。 - 每个项由 `QTreeWidgetItem` 表示，并包含两列数据（名称和值）。 3. **过滤逻辑**： - 遍历 `QTreeWidget` 的所有顶层项。 - 判断关键字是否存在于项的任意列中。 - 根据匹配结果调用 `setHidden` 方法显示或隐藏该项。 #### 注意事项 - 如果树结构较深（包含子项），需要递归遍历所有子项以确保完整过滤。 - 可以通过设置 `QTreeWidget` 的列数和列标题来自定义显示内容。