如何检测QTreeWidgetItem的展开与折叠状态变化？

嗨，这个问题我之前做Qt项目时也踩过坑！你用的itemChanged和itemClicked确实不会响应展开折叠的操作——Qt专门为树形控件的展开折叠行为提供了更精准的信号，换个思路就能解决。

正确的信号选择 #

Qt的QTreeWidget提供了两个专门对应展开/折叠操作的信号：

• itemExpanded(QTreeWidgetItem* item)：当项目被展开时触发（不管是点击三角图标还是键盘操作）
• itemCollapsed(QTreeWidgetItem* item)：当项目被折叠时触发

这两个信号会直接把触发操作的目标QTreeWidgetItem传递给槽函数，完美匹配你的需求。

代码示例 #

C++ 版本 #

假设你的树形控件对象名为treeWidget，可以这样连接信号：

#include <QTreeWidget>
#include <QDebug>

// 连接展开信号
connect(treeWidget, &QTreeWidget::itemExpanded, this, [](QTreeWidgetItem* item) {
    // 这里编写展开后的处理逻辑，比如打印项目文本
    qDebug() << "用户展开了项目：" << item->text(0);
});

// 连接折叠信号
connect(treeWidget, &QTreeWidget::itemCollapsed, this, [](QTreeWidgetItem* item) {
    // 编写折叠后的处理逻辑
    qDebug() << "用户折叠了项目：" << item->text(0);
});

PyQt/PySide 版本 #

如果用Python开发，代码会更简洁：

from PyQt5.QtWidgets import QTreeWidget

# 假设treeWidget是你的树形控件实例
treeWidget.itemExpanded.connect(lambda item: print(f"用户展开了项目：{item.text(0)}"))
treeWidget.itemCollapsed.connect(lambda item: print(f"用户折叠了项目：{item.text(0)}"))

额外说明 #

如果需要区分用户手动操作和代码调用setExpanded()触发的展开折叠，可以在槽函数里结合项目的状态判断，但大多数场景下，上面的信号已经足够检测用户的交互操作啦。

内容的提问来源于stack exchange，提问作者apalomer