QStringListModel是用于处理字符串列表的数据模型，它可以作为QListView的数据模型，在界面上显示和编辑字符串列表。

QStringListModel的setStringList()函数可以初始化数据模型的字符串列表的内容，stringList() 函数返回数据模型内的字符串列表，在关联的ListView组件里编辑数据后，数据都会及时更 新到数据模型内的字符串列表里。

QStringListModel提供编辑和修改字符串列表数据的函数，如insertRows()、removeRows()、 setData()等，这些操作直接影响数据模型内部的字符串列表，并且修改后的数据会自动在关联的ListView组件里刷新显示。

示例釆用QStringListModel作为数据模型，QListView作为视图组件，演示了QStringListModel 和QListView构成Model/View结构编辑字符串列表的功能，程序运行时界面如图所示。

QStringListModel的使用

Model/View结构对象和组件初始化

示例的窗口是从QWidget继承而来的类Widget，界面采用可视化设计。在Widget类中定义一个QStringListModel类的变量：

QStringListModel *theModel;

在Widget类的构造函数中进行变量的创建，完成数据模型与界面视图组件的关联，下面是Widget类构造函数的代码：

Widget::Widget(QWidget *parent): QWidget(parent), ui(new Ui::Widget)
{
  ui->setupUi(this);
  QStringList theStrList;
  theStrList<<"北京"<<"上海"<<"天津"<<"河北"<<"山东"<<"四川"<<"重庆";
  theModel=new QStringListModel(this);
  theModel->setStringList(theStrList); //导入theStrList的内容
  ui->listView->setModel(theModel); //设置数据模型
  ui->listView->setEditTriggers(QAbstractItemView::DoubleClicked | 
                                QAbstractItemView::SelectedClicked);
}

QStringListModel的setStringList()函数将一个字符串列表的内容作为数据模型的初始数据内容。

QListView的setModel()函数为界面视图组件设置一个数据模型。

程序运行后，界面上ListView组件里就会显示初始化的字符串列表的内容。

编辑项

QListView::setEditTriggers()函数设置QListView的条目是否可以编辑，以及如何进入编辑状态，函数的参数是QAbstractItemView::EditTrigger枚举类型值的组合。构造函数中设置为：

ui->listView->setEditTriggers(QAbstractItemView::DoubleClicked | QAbstractItemView::SelectedClicked);

表示在双击，或选择并单击列表项后，就进入编辑状态。

若要设置为不可编辑，则可以设置为：

ui->listView->setEditTriggers(QAbstractltemView::NoEditTriggers);

添加项

添加项是要在列表的最后添加一行，界面上“添加项”按钮的槽函数代码如下：

void Widget::on_btnListAppend_clicked()
{ //添加一行
  theModel->insertRow(theModel->rowCount()); //在尾部插入一空行
  QModelIndex index=theModel->index(theModel->rowCount()-1, 0);
  theModel->setData(index, "new item", Qt::DisplayRole);
  ui->listView->setCurrentIndex(index); //设置当前选中的行
}

对数据的操作都是针对数据模型的，所以，插入一行使用的是QStringListModel的insertRow (int row)函数，其中row是一个行号，表示在row行之前插入一行。要在列表的最后插入一行，参数row设置为列表当前的行数即可。

这样只是在列表尾部添加一个空行，没有任何文字。为了给添加的项设置一个缺省的文字标 题，首先要获得新增项的模型索引，即：

QModelIndex index=theModel->index(theModel->rowCount()-1, 0);

QStringListModel的index()函数根据传递的行号、列号、父项的模型索引生成一个模型索引， 这行代码为新增的最后一个项生成一个模型索引index。

为新增的项设置一个文字标题“new item”，使用setData()函数，并用到前面生成的模型索引index。代码如下：

theModel->setData(index,"new item",Qt::DisplayRole);

在使用setData()函数时，必须指定设置数据的角色，这里的角色是Qt::DispiayRole，它是用 于显示的角色，即项的文字标题。

插入项

“插入项”按钮的功能是在列表的当前行前面插入一行，其实现代码如下：

void Widget: :on_btnListInsert_clicked
{//插入一行
  QModelIndex index=ui->listView->currentIndex();
  theModel->insertRow(index.row());
  theModel->setData(index,"inserted item",Qt::DisplayRole);
  ui->listView->setCurrentIndex(index);
}

QListView::currentIndex()获得当前项的模型索引index, index.row()则返回这个模型索引的行号。

删除当前项

使用QStringListModel的removeRow()函数删除某一行的代码如下：

void Widget::on_btnListDelete_clicked()
{//删除当前行 ^
  QModelIndex index=ui->listView->currentIndex();
  theModel->removeRow(index.row());
}

删除列表

删除列表的所有项可使用QStringListModel的removeRows(int row，int count)函数，它表示从行号row开始删除count行。代码如下：

void Widget::on_btnListClear_clicked()
{//淸除所有项
  theModel->removeRows (0, theModel->rowCount());
}

在这个示例中，通过QStringListModel和QListView说明了数据模型与视图组件之间构成 Model/View结构的基本原理。