C++ Qt开发：StringListModel字符串列表映射组件

Qt 是一个跨平台C++图形界面开发库，利用Qt可以快速开发跨平台窗体应用程序，在Qt中我们可以通过拖拽的方式将不同组件放到指定的位置，实现图形化开发极大的方便了开发效率，本章将重点介绍QStringListModel字符串映射组件的常用方法及灵活运用。
QStringListModel 是 Qt 中用于处理字符串列表数据的模型类之一，它是 QAbstractListModel 的子类，用于在 Qt 的视图类（如 QListView、QComboBox 等）中显示字符串列表。该组件是用于在Qt中快速显示字符串列表的便捷模型类。该组件通常会配合ListView一起使用，例如将ListView组件与Model模型绑定，当ListView组件内有数据更新时，就可以利用映射将数据模型中的数值以字符串格式提取出来，同理也可实现将字符串赋值到指定的ListView组件内。
以下是对 QStringListModel 的概述：

• 继承关系： QStringListModel 继承自 QAbstractListModel。
  
• 用途： QStringListModel 主要用于将字符串列表（QStringList）与视图进行绑定，使得这些字符串可以在视图中显示和管理。
  
• 特点：
  
  
  
  • 可以通过 setStringList 方法设置字符串列表。
    
  • 提供了获取和设置数据的接口，可以通过模型索引访问和修改数据。
    
  • 适用于显示简单的字符串列表，不涉及复杂的数据结构。
    
  
  
• 常见操作：
  
  
  
  • 设置字符串列表： 使用 setStringList 方法设置要在视图中显示的字符串列表。
    
  • 获取字符串列表： 使用 stringList 方法获取当前模型中的字符串列表。
    
  • 访问和修改数据： 可以使用模型索引通过 data 方法获取数据，通过 setData 方法修改数据。
    
  
  

以下是 QStringListModel 的一些常用方法，说明以及概述，按表格形式呈现：
方法描述QStringListModel(QObject * parent = nullptr)构造函数，创建一个 QStringListModel 对象。QStringListModel(const QStringList & strings, QObject * parent = nullptr)构造函数，创建一个包含指定字符串列表的 QStringListModel 对象。QStringList stringList() const获取当前模型中的字符串列表。void setStringList(const QStringList & strings)设置模型中的字符串列表。Qt::ItemFlags flags(const QModelIndex & index) const返回指定索引处的项目标志。QModelIndex index(int row, int column, const QModelIndex & parent = QModelIndex()) const返回指定行、列和父索引的模型索引。QModelIndex parent(const QModelIndex & child) const返回指定子索引的父索引。int rowCount(const QModelIndex & parent = QModelIndex()) const返回给定父索引下的行数。int columnCount(const QModelIndex & parent = QModelIndex()) const返回给定父索引下的列数。QVariant data(const QModelIndex & index, int role = Qt:isplayRole) const返回给定索引处的角色为 role 的数据。bool setData(const QModelIndex & index, const QVariant & value, int role = Qt::EditRole)设置给定索引处的角色为 role 的数据为 value。bool insertRows(int row, int count, const QModelIndex & parent = QModelIndex())在给定父索引下的 row 位置处插入 count 行。bool removeRows(int row, int count, const QModelIndex & parent = QModelIndex())从给定父索引下的 row 位置开始删除 count 行。这些方法使 QStringListModel 可以方便地管理和操作字符串列表数据，并能够与 Qt 的视图组件集成，实现数据的显示和交互。
首先绘制UI界面，如下图中所示，左侧是一个ListView组件，右侧是一个PlainTextEdit组件；

1.1 初始化模型

如下代码演示了如何在 MainWindow 中使用 QStringListModel 和 QListView 来展示一个字符串列表。
以下是该代码的一些说明：

• 在构造函数中，首先使用 QStringList theStringList 创建了一个字符串列表，并向其中添加了一些城市名称。
  
• 接着，创建了一个 QStringListModel 对象 model 并使用 setStringList 方法将先前创建的字符串列表导入模型中。
  
• 然后，通过 ui->listView->setModel(model) 将模型设置到 QListView 中，从而使模型中的数据在 QListView 中显示。
  
• 使用 setEditTriggers 方法设置了编辑触发器，使得可以通过双击或选择项目来触发编辑操作。
  

这样，通过 QStringListModel 和 QListView 的结合使用，可以很方便地在界面上展示和管理字符串列表的数据。

1. #include <iostream>
2. #include <QStringList>
3. #include <QStringListModel>
5. MainWindow::MainWindow(QWidget *parent): QMainWindow(parent), ui(new Ui::MainWindow)
6. {
7.     ui->setupUi(this);
9.     // 初始化一个StringList字符串列表
10.     QStringList theStringList;
11.     theStringList << "北京" << "上海" << "广州" << "深圳" << "山东" << "四川";
13.     // 创建并使用数据模型
14.     model = new QStringListModel(this);
16.     // 导入模型数据
17.     model->setStringList(theStringList);
19.     // 为listView设置模型
20.     ui->listView->setModel(model);
21.     ui->listView->setEditTriggers(QAbstractItemView::DoubleClicked |
22.                                   QAbstractItemView::SelectedClicked);
23. }
25. MainWindow::~MainWindow()
26. {
27.     delete ui;
28. }

复制代码

运行后输出如下图，使用SetData则可以在index位置设置字符串，并最终setCurrentIndex设置到当前下标处；

1.3 转换字符串

如下代码演示了如何通过按钮的点击事件将 QStringListModel 的数据导入到 QPlainTextEdit 中。
以下是代码的一些说明：

• 使用 stringList 方法获取数据模型的字符串列表。
  
• 清空 QPlainTextEdit，准备追加数据。
  
• 循环遍历字符串列表，并将每个字符串追加到 QPlainTextEdit 中，每个字符串之间用逗号隔开。
  

这样，通过这个按钮的点击事件，可以将 QStringListModel 中的数据导入到 QPlainTextEdit 中。

1. // 添加一行
2. void MainWindow::on_btnListAppend_clicked()
3. {
4.     model->insertRow(model->rowCount());                       // 在尾部插入一行
5.     QModelIndex index = model->index(model->rowCount()-1,0);   // 获取最后一行的索引
6.     QString LineText = ui->lineEdit->text();
7.    
8.     model->setData(index,LineText,Qt::DisplayRole);            // 设置显示文字
9.     ui->listView->setCurrentIndex(index);                      // 设置当前行选中
10.     ui->lineEdit->clear();
11. }
13. // 插入一行数据到ListView
14. void MainWindow::on_btnListInsert_clicked()
15. {
16.     QModelIndex index;
18.     index= ui->listView->currentIndex();             // 获取当前选中行
19.     model->insertRow(index.row());                   // 在当前行的前面插入一行
20.    
21.     QString LineText = ui->lineEdit->text();
22.     model->setData(index,LineText,Qt::DisplayRole);             // 设置显示文字
23.     model->setData(index,Qt::AlignRight,Qt::TextAlignmentRole); // 设置对其方式
24.     ui->listView->setCurrentIndex(index);                       // 设置当前选中行
25. }

复制代码

当点击显示数据模型时，则会将列表转换为字符串并按照特定格式输出到编辑框内，如下图所示；

附件下载

StringListModel.zip

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！