QTreeWidgetItem

QTreeWidgetItem 是 Qt 的一个类，用于在 QTreeWidget 中显示项目。QTreeWidget 是一个继承自 QTreeView 的控件，用于显示树状结构的数据。QTreeWidgetItem 将每个项目作为一个独立的对象进行管理，可以为其设置文本、图标、数据等属性，并且支持拖放操作。使用 QTreeWidget 时，通常需要创建许多 QTreeWidgetItem 对象来表示树中的各个节点。

相关问题

QTreeWidgetItem模型

在Qt中，QTreeWidgetItem是TreeWidget控件（如QTreeWidget、QListView等）的基础模型，它是树形结构中的节点，用于表示树状数据中的每个项目。每一个QTreeWidgetItem代表一个层次结构中的条目，并且可以包含子项（再次是QTreeWidgetItem）。它们通常用于展示层次化的数据，如文件系统、目录结构或菜单项等。
QTreeWidgetItem的主要属性包括：

text()：用于存储项目的文本信息。
whatsThis()：提供关于该项目的额外说明（可通过鼠标悬停查看）。
icon()：指定项目的图标。
checkState()和setCheckState()：用于设置和获取项目的复选状态。
flags()：返回该节点的权限标志，例如可编辑、可见等。

以下是使用QTreeWidgetItem的一些常见操作：

创建新项：使用newChild()添加新的子项。
删除项：使用takeChild()删除某个子项。
更新属性：修改text(), whatsThis(), 等属性。
遍历树：通过childCount()、child()方法访问子项。

创建根节点
root_item = QTreeWidgetItem()
添加子项
sub_item = QTreeWidgetItem(root_item)
sub_item.setText(0, "子项标题")  # 设置第一列的文字
事件响应，如双击事件
def on_double_click(item):
    print(f"双击了 {item.text()}")
root_item.doubleClicked.connect(on_double_click)

QTreeWidgetItem选中

实现 QTreeWidgetItem 选中效果
为了实现 QTreeWidgetItem 的选中效果，在 Qt 中可以利用样式表来定制外观。具体来说，可以通过设置 QTreeWidget 或者其子项的样式属性来调整选中状态下的显示效果。
对于整个树形控件而言，如果希望修改分支节点（即有子节点的项目）在被选中时的颜色以及图标变化，则可以在应用程序资源文件中定义相应的图像路径，并通过如下 CSS 风格的选择器应用这些自定义样式：
/* 设置选中的背景颜色 */
QTreeView::branch:selected {
background: #BCCFE7;
selection-background-color: #BCCFE7;
}

/* 定义关闭状态下带有孩子的分支箭头 */
QTreeView::branch:has-children:!has-siblings:closed,
QTreeView::branch:closed:has-children:has-siblings {
border-image: none;
image: url(:/image/add-line_horizontal.png);
}

/* 定义打开状态下带有孩子的分支箭头 */
QTreeView::branch:open:has-children:!has-siblings,
QTreeView::branch:open:has-children:has-siblings {
border-image: none;
image: url(:/image/add-line_vertical.png);
}

上述代码片段展示了如何更改不同条件下分支项目的视觉表现[^3]。
当涉及到单个条目(QTreeWidgetItem)的文字颜色或其他细节上的微调时，可能需要进一步处理。例如，要改变当前选中行内的文字颜色不变的问题，通常是因为默认情况下文本颜色会继承父级窗口部件的主题设定。此时应该确保所使用的主题不会覆盖掉预期的效果；另外也可以尝试直接针对该项添加特定的样式规则或者编程方式控制字体颜色。
下面是一个简单的例子展示怎样获取并操作已选中的项:
#include <QMainWindow>
#include <QTreeWidgetItem>

// 获取所有被选中的节点列表
QList<QTreeWidgetItem*> selectedItems = treeWidget->selectedItems();

foreach (QTreeWidgetItem* item, selectedItems) {
// 对每一个选中的item执行某些动作...
qDebug() << "Selected Item Text:" << item->text(0); // 输出第一列的内容作为示范
}

这段 C++ 代码说明了如何遍历由 selectedItems() 方法返回的一系列指针对象，并对其进行迭代访问[^1]。