本文共 3349 字，大约阅读时间需要 11 分钟。

使用QTreeWidget创建树形控件示例

以下是使用PyQt5创建树形控件（QTreeWidget）的一个实用示例，展示了如何在PyQt应用中创建和定制树形控件。

1. 树形控件的基本设置

首先，我们需要在主窗口中创建一个QTreeWidget控件，并设置其基本属性。以下是详细的步骤：

from PyQt5.QtWidgets import *from PyQt5.QtGui import QIcon, QBrush, QColorfrom PyQt5.QtCore import Qtclass TreeWidgetDemo(QMainWindow):    def __init__(self, parent=None):        super(TreeWidgetDemo, self).__init__(parent)        self.setWindowTitle('TreeWidget 例子')        self.tree = QTreeWidget()                # 设置列数        self.tree.setColumnCount(2)                # 设置树形控件头部的标题        self.tree.setHeaderLabels(['Key', 'Value'])                # 创建根节点        root = QTreeWidgetItem(self.tree)        root.setText(0, 'Root')        root.setIcon(0, QIcon('./images/root.png'))                # 设置根节点的背景颜色        brush_red = QBrush(Qt.red)        root.setBackground(0, brush_red)                brush_blue = QBrush(Qt.blue)        root.setBackground(1, brush_blue)                # 设置列宽度        self.tree.setColumnWidth(0, 150)                # 添加子节点        child1 = QTreeWidgetItem()        child1.setText(0, 'child1')        child1.setText(1, 'ios')        child1.setIcon(0, QIcon('./images/IOS.png'))        child1.setCheckState(0, Qt.Checked)        root.addChild(child1)                child2 = QTreeWidgetItem(root)        child2.setText(0, 'child2')        child2.setText(1, '')        child2.setIcon(0, QIcon('./images/android.png'))                child3 = QTreeWidgetItem(child2)        child3.setText(0, 'child3')        child3.setText(1, 'android')        child3.setIcon(0, QIcon('./images/music.png'))                # 将根节点添加到树形控件        self.tree.addTopLevelItem(root)                # 设置节点全部展开        self.tree.expandAll()                # 设置中央布局        self.setCentralWidget(self.tree)

2. 添加响应事件

为了让树形控件的节点具有交互功能，我们可以添加点击事件响应。以下是如何实现的步骤：

def onClicked(self, qmodeLindex):    item = self.tree.currentItem()    print(f'Key={item.text(0)}, value={item.text(1)}')

在类初始化时，连接点击事件：

self.tree.clicked.connect(self.onClicked)

3. 节点样式设置

为了提升用户体验，我们可以为树形控件的节点设置样式。以下是如何实现的步骤：

# 设置根节点的背景颜色brush_red = QBrush(Qt.red)root.setBackground(0, brush_red)brush_blue = QBrush(Qt.blue)root.setBackground(1, brush_blue)

4. 树形控件的默认展开

默认情况下，树形控件的节点可能不会全部展开以便更好地展示结构。以下是如何实现的步骤：

self.tree.expandAll()

5. 节点状态设置

如果需要，可以为树形控件的节点设置选中状态。以下是如何实现的步骤：

child1.setCheckState(0, Qt.Checked)

6. 列宽度设置

为了确保树形控件在不同的平台上都能良好显示，我们可以设置列宽度。以下是如何实现的步骤：

self.tree.setColumnWidth(0, 150)

7. 子节点的添加和管理

通过PyQt5的QTreeWidgetItem和QTreeWidget API，我们可以轻松添加和管理树形控件的子节点。以下是如何实现的步骤：

# 创建子节点child1 = QTreeWidgetItem()child1.setText(0, 'child1')child1.setText(1, 'ios')child1.setIcon(0, QIcon('./images/IOS.png'))child1.setCheckState(0, Qt.Checked)root.addChild(child1)child2 = QTreeWidgetItem(root)child2.setText(0, 'child2')child2.setText(1, '')child2.setIcon(0, QIcon('./images/android.png'))child3 = QTreeWidgetItem(child2)child3.setText(0, 'child3')child3.setText(1, 'android')child3.setIcon(0, QIcon('./images/music.png'))

8. 节点背景颜色设置

为了让树形控件的节点更具吸引力，可以设置节点的背景颜色。以下是如何实现的步骤：

brush_red = QBrush(Qt.red)root.setBackground(0, brush_red)

9. 树形控件的样式定制

为了提升用户体验，可以为树形控件的样式进行定制。以下是如何实现的步骤：

# 设置列宽度self.tree.setColumnWidth(0, 150)

10. 测试运行

在完成上述设置后，可以运行应用程序来测试树形控件的功能。以下是如何实现的步骤：

if __name__ == '__main__':    app = QApplication(sys.argv)    tree = TreeWidgetDemo()    tree.show()    sys.exit(app.exec_())

通过以上步骤，我们可以轻松创建一个功能丰富的树形控件，满足不同的应用需求。