首页 Qt 学习之路 2 Qt 学习之路 2(43):QStringListModel

Qt 学习之路 2(43):QStringListModel

38 3.7K

上一章我们已经了解到有关 list、table 和 tree 三个最常用的视图类的便捷类的使用。前面也提到过,由于这些类仅仅是提供方便,功能、实现自然不如真正的 model/view 强大。从本章起,我们将了解最基本的 model/view 模型的使用。

既然是 model/view,我们也会分为两部分:model 和 view。本章我们将介绍 Qt 内置的最简单的一个模型:QStringListModel。接下来,我们再介绍另外的一些内置模型,在此基础上,我们将了解到 Qt 模型的基本架构,以便为最高级的应用——自定义模型——打下坚实的基础。

QStringListModel是最简单的模型类,具备向视图提供字符串数据的能力。QStringListModel是一个可编辑的模型,可以为组件提供一系列字符串作为数据。我们可以将其看作是封装了QStringList的模型。QStringList是一种很常用的数据类型,实际上是一个字符串列表(也就是QList<QString>)。既然是列表,它也就是线性的数据结构,因此,QStringListModel很多时候都会作为QListView或者QComboBox这种只有一列的视图组件的数据模型。

下面我们通过一个例子来看看QStringListModel的使用。首先是我们的构造函数:

MyListView::MyListView()
{
    QStringList data;
    data << "Letter A" << "Letter B" << "Letter C";
    model = new QStringListModel(this);
    model->setStringList(data);

    listView = new QListView(this);
    listView->setModel(model);

    QHBoxLayout *btnLayout = new QHBoxLayout;
    QPushButton *insertBtn = new QPushButton(tr("insert"), this);
    connect(insertBtn, SIGNAL(clicked()), this, SLOT(insertData()));
    QPushButton *delBtn = new QPushButton(tr("Delete"), this);
    connect(delBtn, SIGNAL(clicked()), this, SLOT(deleteData()));
    QPushButton *showBtn = new QPushButton(tr("Show"), this);
    connect(showBtn, SIGNAL(clicked()), this, SLOT(showData()));
    btnLayout->addWidget(insertBtn);
    btnLayout->addWidget(delBtn);
    btnLayout->addWidget(showBtn);

    QVBoxLayout *mainLayout = new QVBoxLayout(this);
    mainLayout->addWidget(listView);
    mainLayout->addLayout(btnLayout);
    setLayout(mainLayout);
}

我们不贴出完整的头文件了,只看源代码文件。首先,我们创建了一个QStringList对象,向其中插入了几个数据;然后将其作为QStringListModel的底层数据。这样,我们可以理解为,QStringListModelQStringList包装了起来。剩下来的只是简单的界面代码,这里不再赘述。试运行一下,程序应该是这样的:

QStringListModel 示例

接下来我们来看几个按钮的响应槽函数。

void MyListView::insertData()
{
    bool isOK;
    QString text = QInputDialog::getText(this, "Insert",
                                         "Please input new data:",
                                         QLineEdit::Normal,
                                         "You are inserting new data.",
                                         &isOK);
    if (isOK) {
        int row = listView->currentIndex().row();
        model->insertRows(row, 1);
        QModelIndex index = model->index(row);
        model->setData(index, text);
        listView->setCurrentIndex(index);
        listView->edit(index);
    }
}

首先是insertData()函数。我们使用QInputDialog::getText()函数要求用户输入数据。这是 Qt 的标准对话框,用于获取用户输入的字符串。这部分在前面的章节中已经讲解过。当用户点击了 OK 按钮,我们使用listView->currentIndex()函数,获取QListView当前行。这个函数的返回值是一个QModelIndex类型。我们会在后面的章节详细讲解这个类,现在只要知道这个类保存了三个重要的数据:行索引、列索引以及该数据属于哪一个模型。我们调用其row()函数获得行索引,该返回值是一个 int,也就是当前是第几行。然后我们向模型插入新的一行。insertRows()函数签名如下:

bool insertRows(int row, int count, const QModelIndex &parent = QModelIndex());

该函数会将 count 行插入到模型给定的 row 的位置,新行的数据将会作为 parent 的子元素。如果 row 为 0,新行将被插入到 parent 的所有数据之前,否则将在指定位置的数据之前。如果 parent 没有子元素,则会新插入一个单列数据。函数插入成功返回 true,否则返回 false。我们在这段代码中调用的是insertRows(row, 1)。这是QStringListModel的一个重载。参数 1 说明要插入 1 条数据。记得之前我们已经把 row 设置为当前行,因此,这行语句实际上是在当前的 row 位置插入 count 行,这里的 count 为 1。由于我们没有添加任何数据,实际效果是,我们在 row 位置插入了 1 个空行。然后我们使用 model 的index()函数获取当前行的QModelIndex对象,利用setData()函数把我们用QInputDialog接受的数据设置为当前行数据。接下来,我们使用setCurrentIndex()函数,把当前行设为新插入的一行,并调用edit()函数,使这一行可以被编辑。

以上是我们提供的一种插入数据的方法:首先插入空行,然后选中新插入的空行,设置新的数据。这其实是一种冗余操作,因为currentIndex()已经获取到当前行。在此,我们仅仅是为了介绍这些函数的使用。因此,除去这些冗余,我们可以使用一种更简洁的写法:

void MyListView::insertData()
{
    bool isOK;
    QString text = QInputDialog::getText(this, "Insert",
                                         "Please input new data:",
                                         QLineEdit::Normal,
                                         "You are inserting new data.",
                                         &isOK);
    if (isOK) {
        QModelIndex currIndex = listView->currentIndex();
        model->insertRows(currIndex.row(), 1);
        model->setData(currIndex, text);
        listView->edit(currIndex);
    }
}

接下来是删除数据:

void MyListView::deleteData()
{
    if (model->rowCount() > 1) {
        model->removeRows(listView->currentIndex().row(), 1);
    }
}

使用模型的removeRows()函数可以轻松完成这个操作。这个函数同前面所说的insertRows()很类似,这里不再赘述。需要注意的是,我们用rowCount()函数判断了一下,要求最终始终保留 1 行。这是因为我们写的简单地插入操作所限制,如果把数据全部删除,就不能再插入数据了。所以,前面所说的插入操作实际上还需要再详细考虑才可以解决这一问题。

最后是简单地将所有数据都显示出来:

void MyListView::showData()
{
    QStringList data = model->stringList();
    QString str;
    foreach(QString s, data) {
        str += s + "\n";
    }
    QMessageBox::information(this, "Data", str);
}

这段代码没什么好说的。

关于QStringListModel我们简单介绍这些。从这些示例中可以看到,几乎所有操作都是针对模型的,也就是说,我们直接对数据进行操作,当模型检测到数据发生了变化,会立刻通知视图进行刷新。这样,我们就可以把精力集中到对数据的操作上,而不用担心视图的同步显示问题。这正是 model/view 模型所带来的一个便捷之处。

38 评论

panda 2013年2月14日 - 13:32

新年快乐,还有情人节快乐! 😉

回复
豆子 2013年2月14日 - 17:12

嘿嘿,多谢多谢!春节快乐!

回复
j 2013年7月26日 - 17:44

如果 row 为 0,新行将被插入到 parent 的原有数据之前,否则将在已有数据之后.

貌似是插入在row之前.即:例子中的插入会插入在当前选中项的前面.

回复
豆子 2013年7月27日 - 10:52

原文有误,已经修改过了,感学指出!

回复
enockipp 2013年9月26日 - 22:19

将deleteData()中的>1修改为>=1,同时将insertData()里面的row进行下判断,如果为-1,赋值0。否则在剩下一行的时候就不能删除了

回复
Dingjiang Zhou 2014年1月13日 - 11:07

I got the error message as: QObject::connect: No such slot QListView::insertData() in ../QStringListModel_test/myListView.cpp:17, can anyone help? by the way, I have public slots declaration as void insertData() when I define the class.

The same problem as for the other two buttons. Please help.

回复
豆子 2014年1月13日 - 11:18

没有代码,看不出来什么问题。有可能是你的 connect() 函数给出的接收类的类型错误,导致只找到了父类的函数,而不是你自己的子类的指针。

回复
Dingjiang Zhou 2014年1月14日 - 02:57

wa, you replied. Here is my code: http://stackoverflow.com/questions/21083064/qt-qobjectconnnect-function-cannot-be-connected/21083106?noredirect=1#21083106, someone answered my question, but I got another error message.

Regards,
Dingjiang

回复
豆子 2014年1月14日 - 09:16

在工程上点右键,运行qmake,或者重新构建

回复
Dingjiang Zhou 2014年1月15日 - 07:44

Done, the problem is solved. But still don't understand what is the qmake for.

豆子 2014年1月15日 - 08:52

qmake 用于生成 makefile。qmake 会扫描你的头文件,寻找 Q_OBJECT 宏以便 moc 处理。由于你的 Q_OBJECT 宏是后来添加上的,不重新运行 qmake 的话无法让 moc 知道新增加的宏,也就没办法处理,所以会出错。

muggle 2014年9月29日 - 06:48

请教一下,这个showData函数的用法。固然可以通过按钮connect这个函数,但是这样一来是不是MODEL/VIEW作用被降低了?我看别的文章说,Model的数据更新以后,View是自动更新的?

回复
豆子 2014年9月29日 - 09:31

showData() 函数只是为了弹出一个对话框把全部数据显示出来,并不是将 model 的数据刷新到 view 上面。这个更新的过程是自动的。

回复
wuming123057 2015年2月6日 - 17:54

在Qt 5中编译使用connect(delBtn, SIGNAL(clicked()), this, SLOT(deleteData()));,提示-connect- No such slot MyListView--deleteData()。
换成Qt5语法connect(insertBtn,&QPushButton::clicked,this,&MyListView::insertData);就没有错误。
使用的是Qt5.4 win7 64位操作系统。

回复
wuming123057 2015年2月7日 - 09:47

头文件里面 忘记添加 private slots:
添加上就好了。

回复
Crazydoudou 2015年11月2日 - 17:51

受益匪浅,谢谢

回复
时代 2016年4月27日 - 21:29

请问豆子前辈,为什么我运行上面那个代码,QListView会将按钮覆盖呢?
StringListMode::StringListMode(QWidget *parent) : QWidget(parent)
{
QStringList StringList;
StringList << "Letter A" << "Letter B" <setStringList(StringList);
for(int i=0; isetText("one");
m_PushButton[1]->setText("two");
m_PushButton[2]->setText("three");
m_ListView = new QListView(this);
m_ListView->setModel(m_StringListModel);
m_ListView->move(25, 25);
m_ListView->resize(350, 250);

m_HBoxLayout = new QHBoxLayout(this);
m_HBoxLayout->addWidget(m_PushButton[0]);
m_HBoxLayout->addWidget(m_PushButton[1]);
m_HBoxLayout->addWidget(m_PushButton[2]);

m_VBoxLayout = new QVBoxLayout(this);

m_VBoxLayout->addWidget(m_ListView);
m_VBoxLayout->addLayout(m_HBoxLayout);

setLayout(m_VBoxLayout);
this->resize(400, 300);
}

回复
豆子 2016年4月27日 - 22:54

layout 的参数会自动将该 layout 设置为参数的布局。因此,new QHBoxLayout(this); 一句已经将 QHBoxLayout 设置为 this 的布局,而第二处的 new QVBoxLayout(this); 因 this 已经有了布局,所以设置失败,导致错误。解决方法是,将第一个 new QHBoxLayout(this); 的 this 参数删除,改为 new QHBoxLayout; 即可

回复
时代 2016年4月28日 - 14:17

谢谢豆子前辈,表示支持豆子前辈

回复
ben 2016年8月12日 - 16:37

博主能把完整的代码贴出来吗?我试着写这个例子,结果只要在MyListView中加上Q_OBJECT,编译时就会报"undefined reference to `vtable for MyListV iew'"的错误,百思不解。

//MyListView.h
#ifndef MYLISTVIEW_H
#define MYLISTVIEW_H

#include
#include
#include
class MyListView: public QDialog
{
Q_OBJECT //注释掉则编译不会出错,但是connect()就不起作用了
public:
MyListView();
~MyListView();
void insertData();
void deleteData();
void showData();
private:
QStringListModel * model;
QListView* listView;
};
#endif

回复
ben 2016年8月12日 - 16:55

1.前一个问题找到原因了,没有重新运行qmake。
2.但是如果使用以下连接语句:
connect(insertBtn, SIGNAL(clicked()), this, SLOT(insertData()));
则程序编译正常,但是运行后点击"insert"按钮没有反应(暂时只写了insertData());

如果使用QT5的写法:
connect(&insertBtn, &QPushButton::clicked, this, &MyListView::insertData);
则编译会把一大堆的错误。

回复
豆子 2016年8月13日 - 09:06

添加了 Q_OBJECT 后需要重新运行 qmake。Qt 5 的话,不知道你用的什么编译器,需要编译器支持才行,并且需要在 pro 文件中添加 CONFIG += c++11

回复
ben 2016年8月13日 - 16:13

1.QT5用的就是软件自带的编译器啊。
2.pro文件中添加了CONFIG += c++11也是一样的结果:用qt4的写法编译正常,但是点击按钮没有反应;用qt5的写法则编译就报一大堆错误,郁闷!!

回复
豆子 2016年8月14日 - 10:53

Qt 自带的编译器应该是 mingw 吧?这样的设置应该是没有问题的。添加过 CONFIG 之后有没有重新运行 qmake 之类?

回复
ben 2016年8月15日 - 11:25

写了一个简单的例子,对比后找出原因了:
1.QT4写法无效,是因为类中没有写上 public slots,写上就可以了;
2.QT5写法报错,是因为insertBtn已经是指针了,前面又加了&,结果变成指针的指针了,因此找不到匹配的函数

有个问题:qt4的SINGAL()和SLOT()写法很直观明了,为什么QT5中又支持另一种写法呢?

回复
豆子 2016年8月15日 - 11:34

Qt 5 的指针语法可以在编译时就检测出来信号和槽是不是存在,SINGAL() 和 SLOT() 只能在运行时检测。所以新语法写出来代码会更安全一些。

回复
ben 2016年8月15日 - 17:04

明白了,谢谢。

慢慢慢慢 2016年8月17日 - 23:53

如果一开始model中没有初始数据,数据都是通过insert添加,是否还需要定义一个QStringList?这个QStringList的作用究竟是什么?还有如果要删除listview中所有的数据应该怎么做呢?

回复
豆子 2016年8月18日 - 21:29

QStringList 是作为 model 实际存储数据的底层数据结构存在的。也就是说,你调用的 model 提供的任何函数,实际都是反映到最底层的数据结构 QStringList 上面的。要删除所有数据,可以使用 model 的 removeRows() 函数,或者直接用 setStringList() 赋一个空的值

回复
leon 2016年8月29日 - 17:24

豆子你好,我在运行这个demo的时候,组件以及原始数据可以正常显示,但三个槽函数都运行失败,也就是在插入、删除、显示数据的时候,程序直接崩溃,调试了一下说是系统发了一个信号,我是新手,具体也不太清楚错在哪里。但我把槽函数换成简单的qDebug就不崩溃了。你的邮箱是?我希望你能帮我看下到底是什么原因。在此感谢!

回复
leon 2016年8月29日 - 17:58

已解决~

回复
xiaowoniu 2017年3月23日 - 11:24

你好请问你是怎么解决的

回复
ccppaa 2016年10月7日 - 16:02

大神你好,请问怎么改变一个字符串的其中一个或几个的字体大小或者颜色

回复
豆子 2016年10月16日 - 22:14

字符串只是保存字符数据用的,显示需要提供额外的信息,比如使用 HTML 改变颜色是最简单的。

回复
zxj 2016年12月18日 - 00:27

QStringList data; 构造函数结束后,list不会被析构吗,列表显示还正常吗

回复
豆子 2016年12月18日 - 10:15

这个可以看 QStringListModel 的实现代码,如果它是复制了传入的数据,就不会有问题。另外,Qt 的数据大多使用了隐式数据共享,可以进行隐式的共享

回复
春云者 2017年6月1日 - 20:00

你好,有一个问题不解,那段显示代码中QMessageBox没有调用show函数,为什么能够显示呢?望百忙之中抽出时间解答一下,谢谢!

回复
豆子 2017年6月15日 - 13:54

QMessageBox::information() 这样的函数就可以将消息框显示出来;除非你自定义了 QMessageBox 的各个参数,否则一般会用 information()、warning() 这样的 static 函数显示消息框。

回复

回复 豆子 取消回复

关于我

devbean

devbean

豆子,生于山东,定居南京。毕业于山东大学软件工程专业。软件工程师,主要关注于 Qt、Angular 等界面技术。

主题 Salodad 由 PenciDesign 提供 | 静态文件存储由又拍云存储提供 | 苏ICP备13027999号-2