QtCreator 模块/视图编程( 一） 模型类，自定义模型QStringListModel,QStandardItemModel,QFileSystemModel,QSqlQueryModel,

1 模型/视图架构

1.1 模型

所有的模型都是基于QAbstractItemModel类，这个类定义了一个接口，可以供视图和委托来访问数据。

Qt提供的现成模型：

QStringListModel:用来存储一个简单的QString项目列表

QStandardItemModel:管理复杂的树型结构数据项，每一个数据项可以包含任意数据

QFileSystemModel:提供了本地文件系统中文件和目录的信息

QSqlQueryModel,QSqlTableModel和QSqlRelationalTableModel来访问数据库

1.2 视图

QListView:将模型的数据项显示为一个列表

QTableView:将模型的数据显示成表格

QTreeView:将模型的数据显示在树中

1.3 委托

定制数据的渲染和编辑方式

QStyledItemDelegate:使用当前样式来绘制它的项目，要实现自定义的委托或者要和Qt样式表一起应用时，建议使用它

QItemDelegate:

#include <QApplication>

#include <QFileSystemModel>

#include <QTreeView>

#include <QListView>

int main(int argc,char* argv[])

{

    QApplication app(argc,argv);

    //创建文件系统模型

    QFileSystemModel model;

    //指定根目录

    model.setRootPath(QDir::currentPath());

    //创建树形视图

    QTreeView tree;

    //为视图指定模型

    tree.setModel(&model);

    //指定根索引

    tree.setRootIndex(model.index(QDir::currentPath()));

    //创建列表视图

    QListView list;

    list.setModel(&model);

    list.setRootIndex(model.index(QDir::currentPath()));

    tree.show();

    list.show();

    return app.exec();

}

2 模型类

2.1 模型索引（为了确保数据的表示与数据的获取相分离）QModelIndex类提供

QModelIndex是临时引用，随着模型的结构改变而改变，

QPersistentModelIndex:用于长时间的引用

获取数据项的模型索引，必须指定模型的3个属性：行号，列号和父项的模型索引

2.2 行和列

一个模型可以把它看成一个简单的表格来访问，每个数据项可以使用行号和列号来定位

2.3 父项

顶层数据项的父项是QModelIndex()

2.4 项角色

标准的角色由Qt::ItemDataRole来定义

#include <QApplication>

#include <QStandardItemModel>

#include <QTreeView>

#include <QDebug>

#include <QStandardItem>

int main(int argc,char* argv[])

{

    QApplication app(argc,argv);

    //创建标准数据项模型

    QStandardItemModel model;

    //获取模型的根项，根项不可见

    QStandardItem * parentItem = model.invisibleRootItem();

    //创建标准项item0,并设置显示文本，图标和工具提示

    QStandardItem *item0 = new QStandardItem;

    item0->setText("A");

    QPixmap pixmap0(50,50);

    pixmap0.fill("red");

    item0->setIcon(pixmap0);

    item0->setToolTip("indexA");

    //就标准项item0作为根的子项

    parentItem->appendRow(item0);

    //就创建的标准项item0,作为新的父项

    parentItem = item0;

    //为item0创建子项

    QStandardItem *item1 = new QStandardItem;

    item1->setText("B");

    QPixmap pixmap1(50,50);

    pixmap1.fill(("blue"));

    item1->setIcon(pixmap1);

    item1->setToolTip("indexB");

    parentItem->appendRow(item1);

    //创建新的标准项，设置文本，图标，工具提示

    QStandardItem *item2 = new QStandardItem;

    QPixmap pixmap2(50,50);

    pixmap2.fill(("green"));

    item2->setData("C",Qt::EditRole);

    item2->setData("indexC",Qt::ToolTipRole);

    item2->setData(QIcon(pixmap2),Qt::DecorationRole);

    parentItem->appendRow(item2);

    QTreeView view;

    view.setModel(&model);

    view.show();

    QModelIndex indexA = model.index(0,0,QModelIndex());

    qDebug() << "indexA row count:" << model.rowCount(indexA);

    QModelIndex indexB = model.index(0,0,indexA);

    qDebug() << "indexB text:" << model.data(indexB,Qt::EditRole).toString();

    qDebug() << "indexB toolTip:"

             << model.data(indexB,Qt::ToolTipRole);

    return app.exec();

}

3 创建新的模型

3.1 创建只读模型

3.1.1 添加新类:StringListModel,基类：QAbstractListModel,继承自QObject

3.1.2 修改stringlistmode.h头文件

因为QAbstractItemMode本身不存储任何数据，只提供了一个访问数据的接口，所以将StringList作为数据源，

public:

    explicit StringListModel(const QStringList &strings,QObject *parent = 0);

    int rowCount(const QModelIndex &parent = QModelIndex()) const;  //返回模型的行数

    QVariant data(const QModelIndex &index, int role) const;    //返回模型的数据项

    //可以在树和表格视图的表头显示一些内容

    QVariant headerData(int section, Qt::Orientation orientation, int role=Qt::DisplayRole) const;

private:

    QStringList stringList; //作为模块的数据源

添加函数的实现

int StringListModel::rowCount(const QModelIndex &parent) const

{

    return stringList.count();      //返回item的个数

}

//获取索引项对应的数据

QVariant StringListModel::data(const QModelIndex &index, int role) const

{

    if (! index.isValid()) return QVariant();

    if (index.row() >= stringList.size()) return QVariant();

    if (role == Qt::DisplayRole) return stringList.at(index.row());

    else return QVariant();

}

//设置表头对应的数据

QVariant StringListModel::headerData(int section, Qt::Orientation orientation, int role) const

{

    if (role != Qt::DisplayRole) return QVariant();

    if (orientation == Qt::Horizontal)

        return QString("Column %1").arg(section); //表头显示的数据

    else

        return QString("Row %1").arg(section);

}

main.cpp

int main(int argc,char* argv[]) {

    QApplication app(argc,argv);

    //为模型构造数据

    QStringList list;

    list << "a" << "b" << "c" ;

    StringListModel model(list);

    QListView listView;

    listView.setModel(&model);

    listView.show();

    QTableView tableView;

    tableView.setModel(&model);

    tableView.show();

    return app.exec();

}

3.2 添加编辑功能

添加flags()与setData,flags函数不知道是干什么的？有懂得可以留言下

    Qt::ItemFlags flags(const QModelIndex &index) const;    //

    bool setData(const QModelIndex &index, const QVariant &value, int role = Qt::EditRole); //变更数据

实现函数

Qt::ItemFlags StringListModel::flags(const QModelIndex &index) const

{

    if (!index.isValid()) return Qt::ItemIsEnabled;

    return QAbstractItemModel::flags(index)|Qt::ItemIsEditable;

}

bool StringListModel::setData(const QModelIndex &index, const QVariant &value, int role)

{

    if (index.isValid() && role == Qt::EditRole) {

        stringList.replace(index.row(),value.toString());   //更新值

        emit dataChanged(index,index);      //发出数据变更的信号,左上的index，右下的index

        return true;

    }

    return false;

}

修改data()

if (role == Qt::DisplayRole || role == Qt::EditRole) return stringList.at(index.row());

3.3 插入和删除行

需要添加两个函数insertRows和removeRows

    //row位置，count行数,parent父项索引

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

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

实现两个函数

bool StringListModel::insertRows(int row, int count, const QModelIndex &parent)

{

    beginInsertRows(QModelIndex(),row,row+count-1);

    for (int loop = 0; loop < count; loop++ ) {

        stringList.insert(row,"");

    }

    endInsertRows();

    return true;

}

bool StringListModel::removeRows(int row, int count, const QModelIndex &parent)

{

    beginRemoveRows(QModelIndex(), row, row+count-1);

    for (int loop = 0; loop < count; loop++) {

        stringList.removeAt(row);

    }

    endRemoveRows();

    return true;

}