【QT学习七】QTreeWidget

2023-11-13 16:20| 来源: 网络整理| 查看: 265

一、QTreeWidget 概述

二、QTreeWidget 的基本使用

2.1、创建 QTreeWidget 控件

2.2、设置 QTreeWidget 的大小和位置

2.3、设置 QTreeWidget 的列数和列标题

2.4、添加节点

2.5、读取节点

2.6、设置节点数据

2.7、自定义节点样式

三、注意事项

四、完整示例

一、QTreeWidget 概述

QTreeWidget是Qt中一个用于显示树形结构数据的控件，它继承自QTreeView，可以显示多列数据和树形结构的层次关系，还提供了许多交互功能。可以支持单选、多选和可编辑的节点，还可以自定义节点的样式和布局。除此之外，QTreeWidget 还支持信号和槽机制，可以方便地处理节点的操作事件，如点击、双击、选择等等。

头文件: #include

qmake: QT += widgets

继承: QTreeView

二、QTreeWidget 的基本使用 2.1、创建 QTreeWidget 控件

使用 QTreeWidget 控件前，首先需要在代码中创建 QTreeWidget 实例。代码如下：

QTreeWidget *tree = new QTreeWidget();

这里创建了一个 QTreeWidget 实例，并将其保存在 tree 指针中。此时，tree 控件还没有设置显示大小和位置，需要设置它们才能正常显示。

2.2、设置 QTreeWidget 的大小和位置

在 Qt 中，可以使用 QWidget::resize() 和 QWidget::move() 函数来设置控件的大小和位置。代码如下：

tree->resize(400, 300); // 设置控件大小为 400 x 300 tree->move(100, 100); // 设置控件在窗口中的位置为 (100, 100)

这里设置了 tree 控件的大小为 400 x 300 像素，并将其移动到窗口的 (100, 100) 像素处。

2.3、设置 QTreeWidget 的列数和列标题

QTreeWidget 可以显示多列数据，可以使用 QTreeWidget::setColumnCount() 和 QTreeWidget::setHeaderLabels() 函数来设置列数和列标题。代码如下：

tree->setColumnCount(2); // 设置列数为 2 tree->setHeaderLabels({"Name", "Value"}); // 设置列标题为 "Name" 和 "Value"

这里设置了 tree 控件的列数为 2，列标题分别为 "Name" 和 "Value"。

2.4、添加节点

QTreeWidget 中的每个节点都是一个 QTreeWidgetItem 实例，可以使用 QTreeWidget::addTopLevelItem()、QTreeWidgetItem::addChild() 和 QTreeWidget::insertTopLevelItem() 函数来添加节点。代码如下：

QTreeWidgetItem *root = new QTreeWidgetItem(tree); // 创建一个根节点 root->setText(0, "Root"); // 设置节点文本 root->setText(1, "0"); // 设置节点文本 tree->addTopLevelItem(root); // 将节点添加到 QTreeWidget 中 QTreeWidgetItem *child1 = new QTreeWidgetItem(root); // 创建一个子节点 child1->setText(0, "Child 1"); // 设置节点文本 child1->setText(1,"10"); // 设置节点文本 root->addChild(child1); // 将节点添加到根节点下 QTreeWidgetItem *child2 = new QTreeWidgetItem(root); // 创建另一个子节点 child2->setText(0, "Child 2"); // 设置节点文本 child2->setText(1, "20"); // 设置节点文本 tree->insertTopLevelItem(0, child2); // 将节点插入到 QTreeWidget 的第一个位置

这里创建了一个根节点 root，其文本为 "Root" 和 "0"，并将其添加到 QTreeWidget 中。然后创建了两个子节点 child1 和 child2，分别作为 root 的子节点，并设置其文本。注意，要将子节点添加到父节点中，可以使用 QTreeWidgetItem::addChild() 函数或 QTreeWidget::insertTopLevelItem() 函数。

2.5、读取节点

可以使用 QTreeWidget::topLevelItem() 和 QTreeWidgetItem::child() 函数来读取节点。代码如下：

QTreeWidgetItem *item = tree->topLevelItem(0); // 获取第一个根节点 if (item) { QString text1 = item->text(0); // 获取节点的第一列文本 QString text2 = item->text(1); // 获取节点的第二列文本 qDebug() text(0); // 获取子节点的第一列文本 QString text4 = child->text(1); // 获取子节点的第二列文本 qDebug() setData(2, Qt::UserRole, "custom data"); // 设置第三列的自定义数据 } // 读取节点数据可以使用item->data(2, Qt::UserRole).toString();

这里设置了根节点的第三列数据为 "custom data"。

2.7、自定义节点样式

QTreeWidget 的节点可以根据需求进行自定义样式的设置。可以使用 QTreeWidget::setItemDelegate() 函数来设置 QItemDelegate，从而实现节点样式的自定义。代码如下：

class MyDelegate : public QItemDelegate { public: MyDelegate(QObject *parent = nullptr) : QItemDelegate(parent) {} void paint(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const override { QStyleOptionViewItem opt = option; if (opt.state & QStyle::State_Selected) { painter->fillRect(opt.rect, opt.palette.highlight()); opt.palette.setColor(QPalette::Text, opt.palette.highlightedText().color()); } painter->drawText(opt.rect, Qt::AlignVCenter | Qt::AlignLeft | Qt::TextWordWrap, index.data(Qt::DisplayRole).toString()); } }; // 在创建 QTreeWidget 对象后设置自定义的 QItemDelegate QTreeWidget *tree = new QTreeWidget(parent); tree->setItemDelegate(new MyDelegate(tree));

这里定义了一个 MyDelegate 类来继承自 QItemDelegate，重写了其 paint() 函数以实现节点样式的自定义。在创建 QTreeWidget 对象后，使用 QTreeWidget::setItemDelegate() 函数设置自定义的 QItemDelegate。

三、注意事项

1、 QTreeWidget 中的数据存储在 QTreeWidgetItem 中，因此在对 QTreeWidget 进行数据操作时，必须同时对其对应的 QTreeWidgetItem 进行相应的操作。

2、 QTreeWidget 的节点数据的列数默认为 1，可以使用 QTreeWidget::setColumnCount() 函数进行设置。

3、 QTreeWidgetItem 的列数必须与 QTreeWidget 的列数相同，否则节点的数据将无法正确显示。

四、完整示例 #include #include #include #include #include #include #include class MyDelegate : public QItemDelegate { public: MyDelegate(QObject *parent = nullptr) : QItemDelegate(parent) {} void paint(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const override { QStyleOptionViewItem opt = option; if (opt.state & QStyle::State_Selected) { painter->fillRect(opt.rect, opt.palette.highlight()); opt.palette.setColor(QPalette::Text, opt.palette.highlightedText().color()); } painter->drawText(opt.rect, Qt::AlignVCenter | Qt::AlignLeft | Qt::TextWordWrap, index.data(Qt::DisplayRole).toString()); } }; int main(int argc, char *argv[]) { QApplication app(argc, argv); // 创建 QTreeWidget 对象 QTreeWidget *tree = new QTreeWidget; tree->setColumnCount(3); // 设置列数为 3 tree->setHeaderLabels({"Name", "Value", "Data"}); // 设置列标签 tree->header()->setSectionResizeMode(QHeaderView::ResizeToContents); // 自适应列宽 // 创建根节点 QTreeWidgetItem *root = new QTreeWidgetItem(tree); root->setText(0, "Root"); root->setText(1, "0"); root->setData(2, Qt::UserRole, "root data"); tree->addTopLevelItem(root); // 创建子节点 1 QTreeWidgetItem *child1 = new QTreeWidgetItem(root); child1->setText(0, "Child 1"); child1->setText(1, "10"); root->addChild(child1); // 创建子节点 2 QTreeWidgetItem *child2 = new QTreeWidgetItem(root); child2->setText(0, "Child 2"); child2->setText(1, "20"); tree->insertTopLevelItem(0, child2); // 设置自定义样式 tree->setItemDelegate(new MyDelegate(tree)); // 读取节点数据 QTreeWidgetItem *item = tree->topLevelItem(0); if (item) { qDebug()

【本文地址】

公司简介

联系我们