QStringListModel是一个处理字符串列表的数据模型,可以作为QListView数据模型在界面中查看和编辑字符串列表。
QStringListModel的setStringList ) )函数初始化数据模型字符串列表的内容,stringList ) )函数返回数据模型中的字符串列表,并在关联的ListView组件中编辑数据
QStringListModel提供了用于编辑和修改字符串列表中数据的函数,如insertRows (、removeRows )和setData ),这些操作直接影响和修改数据模型中的字符串列表
实例samp5_2使用QStringListModel作为数据模型,使用QListView组件作为视图组件,QStringListModel和QListView构成模型/视图结构
图1实例samp5_2的运行时接口
窗口左侧有对QStringListModel的几项操作,右侧的QPlaintextEdit组件显示qstringlistmodel 33603360 string list () )的内容,并在接口上
QStringListModel用法Model/View结构对象和组件初始化实例samp5_2窗口是继承自q构件的类小部件,接口采用可视设计。 在小部件类中定义QStringListModel类的变量。
QStringListModel *theModel;
在小部件类的构造函数中创建变量,并完成数据模型与界面视图组件的关联。 以下是小部件类构造函数的代码。
构件:3360构件(q构件*构件) : q构件(parent ),ui )新ui :3360构件(ui-setupui ) this ); QStringList theStrList; //初期字符串列表the strlist '北京''上海''天津''河北''山东''四川''重庆''广东''河南'; //stringlistthemodel=初始化newqstringlistmodel (this ); //创建数据模型themodel-se tstringlist (the strlist )//如果在模型中设置了字符串列表,则字符串列表的内容UI-listview-setmodel(themodel ) listView的数据模型ui-listview-setedittriggers (qabstractitemview :3360 double clicked ) QListView的setModel ()函数设置界面视图组件的数据模型。
程序运行时,界面上的ListView组件将显示初始化的字符串列表的内容。
编辑、添加和删除项目操作1 )编辑项目
qlistview 3360: setedittriggers ()函数设置qlistview条目是否可编辑以及如何进入编辑状态。 函数的参数是qabstractitemview 33603360 edit trigger枚举类型的值组合。 构造函数设置:
ui-listview-setedittriggers (qabstractitemview 33603360 double clicked );
双击或选择列表项目并单击,表示进入编辑状态。
要设置为不可编辑,请进行以下设置:
ui-listview-setedittriggers (qabstractitemview 33603360 noedittriggers );
2 )增加项目
添加项目是指在列表末尾添加一行。 界面中“添加项”按钮的插槽函数代码如下:
void构件:3360 on _ btnlistappend _ clicked ()//themodel-insertrow (themodel-rowcount ) )添加行; //末尾插入空行//qmodelindex索引qodelindexindex=themodel-index (th
eModel->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::DisplayRole,它是用于显示的角色,即项的文字标题。
3) 插入项
“插入项”按钮的功能是在列表的当前行前面插入一行,其实现代码如下:
QListView::currentIndex() 获得当前项的模型索引 index,index.row() 则返回这个模型索引的行号。
4) 删除当前项
使用 QStringListModel 的 removeRow() 函数删除某一行的代码如下:
5) 删除列表
删除列表的所有项可使用 QStringListModel 的 removeRows(int row, int count) 函数,它表示从行号 row 开始删除 count 行。代码如下:
以上在对界面上 ListView 的项进行编辑时,实际操作的都是其关联的数据模型 theModel,在对数据模型进行插入、添加、删除项操作后,内容立即在 ListView 上显示出来,这是数据模型与视图组件之间信号与槽的作用,当数据模型的内容发生改变时,通知视图组件更新显示。
同样的,当在 ListView 上双击一行进入编辑状态,修改一个项的文字内容后,这部分内容也保存到数据模型里了。那么,数据模型内部应该保存有最新的数据内容,对于 QStringListModel 模型来说,通过 stringList() 函数可以得到其最新的数据副本。界面上的“显示数据模型的 StringList”按钮获取数据模型的 stringList,并用多行文本的形式显示其内容,以检验对数据模型修改数据,特别是在界面上修改列表项的文字后,其内部的数据是否同步更新了。
以下是界面上的“显示数据模型的 StringList”按钮的 clicked() 信号的槽函数代码,它通过数据模型的 stringList() 函数获取字符串列表,并在 plainTextEdit 里逐行显示:
程序运行时,无论对 ListView 的列表做了什么编辑和修改,单击“显示数据模型的 StringList”按钮,在文本框里显示的文字内容与 ListView 里总是完全相同的,说明数据模型的数据与界面上显示的内容是同步的。
其他功能QListView 的 clicked() 信号会传递一个 QModellndex 类型的参数,利用该参数,可以显示当前项的模型索引的行和列的信息,实现代码如下:
void Widget::on_listView_clicked(const QModelIndex &index){ //显示QModelIndex的行、列号 ui->LabInfo->setText(QString::asprintf("当前项:row=%d, column=%d", index.row(), index.column()));}在这个实例中,通过 QStringListModel 和 QListView 说明了数据模型与视图组件之间构成 Model/View 结构的基本原理。
前面章节中,我们采用 QListWidget 设计过一个列表编辑器(samp4_7),对比这两个实例,可以发现如下两点:
所以,这是 Model/View 结构与便利组件之间的主要区别。