【Qt常用控件】—— 多元素控件

• QListWidget
• QListView
• QTableWidget
• QTableView
• QTreeWidget
• QTreeView

xxWidget 和 xxView 之间的区别

以 QTableWidget 和 QTableView 为例：

1. QTableView 是基于 MVC 设计的控件. QTableView ⾃⾝不持有数据. 使⽤ QTableView的时候需要⽤⼾创建⼀个 Model 对象 (⽐如 QStandardModel ), 并且把 Model 和QTableView 关联起来. 后续修改 Model 中的数据就会影响 QTableView 的显⽰; 修改QTableView 的显⽰也会影响到 Model 中的数据(双向绑定).
2. QTableWidget 则是 QTableView 的子类, 对 Model 进⾏了封装. 不需要⽤⼾⼿动创建Model 对象, 直接就可以往 QTableWidget 中添加数据了.

1.1 List Widget  

在Qt中，QListWidget是一个用于显示列表项的常用控件，它提供了一种简单的方法来显示文本和图标的列表。

• 每个选项都可以被选中.  

核心属性  

•  注意: ListWidget 是 ListView 的⼦类, 功能⽐ ListView 更丰富. 咱们使⽤ListWidget 即可

 2) 编写 widget.cpp, 在构造函数中添加初始元素

Widget::Widget(QWidget *parent)
     : QWidget(parent)
     , ui(new Ui::Widget)
{
     ui->setupUi(this);
    
     ui->listWidget->addItem("C++");
     ui->listWidget->addItem("Java");
     ui->listWidget->addItem("Python");
}

void Widget::on_listWidget_currentItemChanged(QListWidgetItem *current,
QListWidgetItem *previous)
{
     if (current != NULL && previous != NULL) {
         qDebug() << "当前选中: " << current->text()<< "之前选中: " << previous->text();
     }
}

4) 编写按钮的 slot 函数 

void Widget::on_pushButton_clicked()
{
     // 获取到输⼊框的内容
     const QString& text = ui->lineEdit->text();
     if (text.isEmpty()) {
         return;
     }
     ui->listWidget->addItem(text);
}

void Widget::on_pushButton_2_clicked()
{
     // 获取当前被选中的元素
     int row = ui->listWidget->currentRow();
     // 删除这⼀⾏
     ui->listWidget->takeItem(row);
}

1.2 Table Widget  

使⽤ QTableWidget 表⽰⼀个表格控件. ⼀个表格中包含若⼲⾏, 每⼀⾏⼜包含若⼲列. 表格中的每个单元格, 是⼀个 QTableWidgetItem 对象.

QTableWidget 核心方法

 1) 在界面上创建 QTableWidget 和 三个按钮, ⼀个输⼊框

• 注意: QTableWidget 是 QTableView 的⼦类, 功能⽐ QTableView 更丰富. 咱们使用QTableWidget 即可.

2) 编写 widget.cpp 构造函数, 构造表格中的初始数据. 

Widget::Widget(QWidget *parent)
     : QWidget(parent)
     , ui(new Ui::Widget)
{
     ui->setupUi(this);

     // 创建 3 ⾏
     ui->tableWidget->insertRow(0);
     ui->tableWidget->insertRow(1);
     ui->tableWidget->insertRow(2);

     // 创建 3 列
     ui->tableWidget->insertColumn(0);
     ui->tableWidget->insertColumn(1);
     ui->tableWidget->insertColumn(2);

     // 给 3 列设定列名
     ui->tableWidget->setHorizontalHeaderItem(0, new QTableWidgetItem("学号"));
     ui->tableWidget->setHorizontalHeaderItem(1, new QTableWidgetItem("姓名"));
     ui->tableWidget->setHorizontalHeaderItem(2, new QTableWidgetItem("年龄"));

     // 设置初始数据
     ui->tableWidget->setItem(0, 0, new QTableWidgetItem("1001"));
     ui->tableWidget->setItem(0, 1, new QTableWidgetItem("张三"));
     ui->tableWidget->setItem(0, 2, new QTableWidgetItem("20"));

     ui->tableWidget->setItem(1, 0, new QTableWidgetItem("1002"));
     ui->tableWidget->setItem(1, 1, new QTableWidgetItem("李四"));
     ui->tableWidget->setItem(1, 2, new QTableWidgetItem("21"));

     ui->tableWidget->setItem(2, 0, new QTableWidgetItem("1003"));
     ui->tableWidget->setItem(2, 1, new QTableWidgetItem("王五"));
     ui->tableWidget->setItem(2, 2, new QTableWidgetItem("19"));
}

void Widget::on_pushButton_addRow_clicked()
{
     // 1. 获取到⾏数
     int rowCount = ui->tableWidget->rowCount();
     // 2. 插⼊新⾏
    ui->tableWidget->insertRow(rowCount);
}

void Widget::on_pushButton_delRow_clicked()
{
     // 1. 获取选中的⾏号
     int curRow = ui->tableWidget->currentRow();
     // 2. 删除对应⾏
     ui->tableWidget->removeRow(curRow);
}

void Widget::on_pushButton_addCol_clicked()
{
     // 1. 获取到列数
     int colCount = ui->tableWidget->columnCount();
     // 2. 插⼊新列
     ui->tableWidget->insertColumn(colCount);
     // 3. 设置列名
     const QString& name = ui->lineEdit->text();
     ui->tableWidget->setHorizontalHeaderItem(colCount, new QTableWidgetItem(name));
}

void Widget::on_pushButton_delCol_clicked()
{
     // 1. 获取选中的列号
     int curCol = ui->tableWidget->currentColumn();
     // 2. 删除对应的列
     ui->tableWidget->removeColumn(curCol);
}

 QTreeWidget 核心方法

QTreeWidgetItem 方法 

代码示例: 使⽤ QTreeWidget

 2) 编写代码, 构造初始数据

Widget::Widget(QWidget *parent)
    : QWidget(parent)
    , ui(new Ui::Widget)、
{
     ui->setupUi(this);

     ui->treeWidget->setHeaderLabel("动物");

     QTreeWidgetItem* item1 = new QTreeWidgetItem();
     item1->setText(0, "猫");
     ui->treeWidget->addTopLevelItem(item1);

     QTreeWidgetItem* item2 = new QTreeWidgetItem();
     item2->setText(0, "狗");
     ui->treeWidget->addTopLevelItem(item2);

     QTreeWidgetItem* item3 = new QTreeWidgetItem();
     item3->setText(0, "⻦");
     ui->treeWidget->addTopLevelItem(item3);
}

void Widget::on_pushButton_clicked()
{
     // 获取输⼊框内容
     const QString& text = ui->lineEdit->text();
     if (text.isEmpty()) {
         return;
    }
     // 添加到顶层节点中
     QTreeWidgetItem* item = new QTreeWidgetItem();
     item->setText(0, text);
     ui->treeWidget->addTopLevelItem(item);
}

void Widget::on_pushButton_2_clicked()
{
     // 获取输⼊框内容
     const QString& text = ui->lineEdit->text();
     if (text.isEmpty()) {
         return;
    }
     // 获取到当前选中的节点
     QTreeWidgetItem* currentItem = ui->treeWidget->currentItem();
     if (currentItem == NULL) {
         return;
     }
     // 构造新的 item
     QTreeWidgetItem* newItem = new QTreeWidgetItem();
     newItem->setText(0, text);
     // 添加 item 到选中节点
     currentItem->addChild(newItem);
     // 展开⽗节点
     currentItem->setExpanded(true);
}

void Widget::on_pushButton_3_clicked()
{
     // 获取到当前选中的节点
     QTreeWidgetItem* currentItem = ui->treeWidget->currentItem();
     if (currentItem == NULL) {
         return;
     }
    // 获取当前节点的⽗节点
     QTreeWidgetItem* parent = currentItem->parent();
     if (parent == NULL) {
         // 顶层节点
         int index = ui->treeWidget->indexOfTopLevelItem(currentItem);
         ui->treeWidget->takeTopLevelItem(index);
     } else {
         // ⾮顶层节点
         parent->removeChild(currentItem);
     }
}

1.4 小结

QListWidget、QTableWidget 和 QTreeWidget 是 Qt 中常用的三种用于展示列表、表格和树形结构数据的控件，它们各自有着不同的特点和用法。

QListWidget

• 特点：用于显示简单的列表，每个列表项可以包含文本、图标等简单内容。
• 用途：适用于简单的列表展示，如文件列表、选项列表等。

QTableWidget

• 特点：用于显示二维表格数据，支持行列操作、单元格编辑等功能。
• 用途：适用于显示表格数据，如数据展示、编辑表格等。

QTreeWidget

• 特点：用于显示树形结构数据，支持展开折叠、节点操作等功能。
• 用途：适用于显示层级结构数据，如文件夹结构、树状菜单等。

总结

• 使用 QListWidget 来显示简单的列表数据。
• 使用 QTableWidget 来显示二维表格数据。
• 使用 QTreeWidget 来显示树形结构数据。

这些控件都提供了丰富的功能和灵活的接口，可以根据实际需求选择合适的控件来展示数据。