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

Qt 是一个跨平台C++图形界面开发库,利用Qt可以快速开发跨平台窗体应用程序,在Qt中我们可以通过拖拽的方式将不同组件放到指定的位置,实现图形化开发极大的方便了开发效率,本章将重点介绍QStringListModel字符串映射组件的常用方法及灵活运用。

QStringListModel 是 Qt 中用于处理字符串列表数据的模型类之一,它是 QAbstractListModel 的子类,用于在 Qt 的视图类(如 QListViewQComboBox 等)中显示字符串列表。该组件是用于在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::DisplayRole) 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 中使用 QStringListModelQListView 来展示一个字符串列表。

以下是该代码的一些说明:

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

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

#include <iostream>
#include <QStringList>
#include <QStringListModel>

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

    // 初始化一个StringList字符串列表
    QStringList theStringList;
    theStringList << "北京" << "上海" << "广州" << "深圳" << "山东" << "四川";

    // 创建并使用数据模型
    model = new QStringListModel(this);

    // 导入模型数据
    model->setStringList(theStringList);

    // 为listView设置模型
    ui->listView->setModel(model);
    ui->listView->setEditTriggers(QAbstractItemView::DoubleClicked |
                                  QAbstractItemView::SelectedClicked);
}

MainWindow::~MainWindow()
{
    delete ui;
}

运行后左侧的ListView组将将被初始化为城市地址,如下图所示;

1.2 添加与插入

如下代码演示了如何在 MainWindow 中通过按钮的点击事件向 QStringListModel 中添加或插入数据。

以下是代码的一些说明:

  1. on_btnListAppend_clicked 方法用于在 QStringListModel 的末尾添加一行。具体步骤包括:
    • 使用 insertRow 在模型的末尾插入一行。
    • 获取最后一行的索引。
    • 从界面的 lineEdit 获取输入的文本。
    • 使用 setData 方法将文本设置到模型的指定索引处。
    • 使用 setCurrentIndex 方法将最后一行设置为当前选中行。
    • 清空输入框。
  2. on_btnListInsert_clicked 方法用于在当前选中行的前面插入一行。具体步骤包括:
    • 获取当前选中行的索引。
    • 使用 insertRow 在当前行的前面插入一行。
    • 从界面的 lineEdit 获取输入的文本。
    • 使用 setData 方法将文本设置到模型的指定索引处。
    • 使用 setData 方法设置对齐方式为右对齐。
    • 使用 setCurrentIndex 方法将当前行设置为当前选中行。

这样,通过这两个按钮的点击事件,可以向 QStringListModel 中添加或插入数据,并在 QListView 中进行显示。

// 添加一行
void MainWindow::on_btnListAppend_clicked()
{
    model->insertRow(model->rowCount());                       // 在尾部插入一行
    QModelIndex index = model->index(model->rowCount()-1,0);   // 获取最后一行的索引
    QString LineText = ui->lineEdit->text();
    
    model->setData(index,LineText,Qt::DisplayRole);            // 设置显示文字
    ui->listView->setCurrentIndex(index);                      // 设置当前行选中
    ui->lineEdit->clear();
}

// 插入一行数据到ListView
void MainWindow::on_btnListInsert_clicked()
{
    QModelIndex index;

    index= ui->listView->currentIndex();             // 获取当前选中行
    model->insertRow(index.row());                   // 在当前行的前面插入一行
    
    QString LineText = ui->lineEdit->text();
    model->setData(index,LineText,Qt::DisplayRole);             // 设置显示文字
    model->setData(index,Qt::AlignRight,Qt::TextAlignmentRole); // 设置对其方式
    ui->listView->setCurrentIndex(index);                       // 设置当前选中行
}

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

1.3 转换字符串

如下代码演示了如何通过按钮的点击事件将 QStringListModel 的数据导入到 QPlainTextEdit 中。

以下是代码的一些说明:

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

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

// 显示数据模型文本到QPlainTextEdit
void MainWindow::on_btnTextImport_clicked()
{
    QStringList pList;

    pList = model->stringList();    // 获取数据模型的StringList
    ui->plainTextEdit->clear();     // 先清空文本框

    // 循环追加数据
    for(int x=0;x< pList.count();x++)
    {
        ui->plainTextEdit->appendPlainText(pList.at(x) + QString(","));
    }
}

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

附件下载

StringListModel.zip

热门相关:扑倒老公大人   诛天至极   写给鼹鼠先生的情书   我有一张均富卡   无上崛起