C/C++ Qt StringListModel 字元串列表映射組件

• 2021 年 12 月 4 日
• 筆記
• C/C++ Qt 窗體開發教程

StringListModel 字元串列表映射組件，該組件用於處理字元串與列表框組件中數據的轉換，通常該組件會配合ListView組件一起使用，例如將ListView組件與Model模型綁定，當ListView組件內有數據更新時，我們就可以利用映射將數據模型中的數值以字元串格式提取出來，同理也可實現將字元串賦值到指定的ListView組件內。

首先在UI介面中排版

默認的MainWindow::MainWindow構造函數中，我們首先初始化一個QStringList字元串鏈表並對該鏈表賦值，通過new QStringListModel(this);創建一個數據模型，並通過ui->listView->setModel(model);屬性將模型與ListView組件綁定，當ListView組件被選中是則觸發on_listView_clicked事件實現輸出當前選中行，其初始化程式碼部分如下:

#include "mainwindow.h"
#include "ui_mainwindow.h"
#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);    // 導入模型數據

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

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

// 當ListView列表項被選中時，顯示QModelIndex的行、列號
void MainWindow::on_listView_clicked(const QModelIndex &index)
{
        ui->LabInfo->setText(QString::asprintf("當前項:row=%d, column=%d",
                            index.row(),index.column()));
}

程式碼運行效果:

添加程式碼：需要通過model->index()獲取到最後一行的索引，然後使用model->setData()追加寫入數據到最後一條索引位置。
插入程式碼: 需要通過ui->listView->currentIndex()獲取到當前游標位置，並調用model->setData()插入到指定位置。
刪除程式碼: 直接調用model->removeRows()等函數即可將指定位置刪除。

// 添加一行
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);                       // 設置當前選中行
}

// 刪除當前選中行
void MainWindow::on_btnListDelete_clicked()
{
    QModelIndex index;
    index = ui->listView->currentIndex();    // 獲取當前行的ModelIndex
    model->removeRow(index.row());           // 刪除選中行
}

// 清除當前列表
void MainWindow::on_btnListClear_clicked()
{
   model->removeRows(0,model->rowCount());
}

程式碼運行效果:

如果需要實現將ListView數據模型中的數據導出到plaintextEdit組件中，則需要通過model->stringList()獲取到ListView中的每行並將其賦值到QStringList字元串鏈表中，最後通過循環的方式依次插入到plainTextEdit中即可，插入時默認會以逗號作為分隔符。

// 顯示數據模型文本到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(","));
    }
}

程式碼運行效果: