当前位置：首页 > article >正文

Qt QTreeWidget 总结

article 2025/2/25 5:15:10

Qt QTreeWidget 总结

1. 概述

QTreeWidget 是 Qt 中用于显示树形结构的控件，继承自 QTreeView，但提供了更简单的接口。
适合展示层级数据（如文件目录、组织结构）。
每个节点是 QTreeWidgetItem 对象，支持文本、图标、复选框等。

2. 基本使用

创建与初始化

QTreeWidget *treeWidget = new QTreeWidget(parent);
treeWidget->setColumnCount(2); // 设置列数
treeWidget->setHeaderLabels({"Name", "Type"}); // 设置表头

添加项

// 添加顶层项
QTreeWidgetItem *topItem = new QTreeWidgetItem(treeWidget);
topItem->setText(0, "Root");
topItem->setIcon(0, QIcon(":/icon.png"));

// 添加子项
QTreeWidgetItem *childItem = new QTreeWidgetItem(topItem);
childItem->setText(0, "Child");
childItem->setCheckState(0, Qt::Checked); // 复选框

3. 常用方法

方法	描述
`addTopLevelItem(QTreeWidgetItem*)`	添加顶层项
`insertTopLevelItem(int, QTreeWidgetItem*)`	插入顶层项到指定位置
`takeTopLevelItem(int)`	移除并返回顶层项
`currentItem()`	获取当前选中项
`expandItem(QTreeWidgetItem*)`	展开节点
`collapseItem(QTreeWidgetItem*)`	折叠节点
`setItemWidget(QTreeWidgetItem, int, QWidget)`	为项添加自定义控件（如按钮）

遍历项

QTreeWidgetItemIterator it(treeWidget);
while (*it) {
    qDebug() << (*it)->text(0);
    ++it;
}

4. 信号与槽

常用信号：
- itemClicked(QTreeWidgetItem*, int)：点击项触发。
- itemDoubleClicked(QTreeWidgetItem*, int)：双击项触发。
- itemChanged(QTreeWidgetItem*, int)：项内容变化触发（如复选框状态）。

示例：响应点击事件

connect(treeWidget, &QTreeWidget::itemClicked, [](QTreeWidgetItem *item, int column) {
    qDebug() << "Clicked:" << item->text(column);
});

5. 样式与定制

使用 QSS 美化

treeWidget->setStyleSheet(
    "QTreeWidget { background: #f0f0f0; }"
    "QTreeWidget::item:hover { background: yellow; }"
    "QTreeWidget::item:selected { background: blue; color: white; }"
);

自定义项外观

QTreeWidgetItem *item = new QTreeWidgetItem();
item->setForeground(0, QBrush(Qt::red)); // 设置文本颜色
item->setBackground(1, QBrush(Qt::lightGray)); // 设置背景色

6. 完整示例

QTreeWidget *treeWidget = new QTreeWidget();
treeWidget->setColumnCount(2);
treeWidget->setHeaderLabels({"Name", "Value"});

// 添加顶层项
QTreeWidgetItem *root = new QTreeWidgetItem(treeWidget);
root->setText(0, "Settings");
root->setExpanded(true); // 默认展开

// 添加子项
QTreeWidgetItem *child = new QTreeWidgetItem(root);
child->setText(0, "Language");
child->setText(1, "English");

// 响应双击
connect(treeWidget, &QTreeWidget::itemDoubleClicked, [](QTreeWidgetItem *item, int col) {
    QMessageBox::information(nullptr, "Info", item->text(col));
});

treeWidget->show();