QStandardItem数据项

一、QStandardItem基础概念

QStandardItem是QT框架提供的一个重要的数据模型类。它可以用于创建和管理各种层次结构的数据。QStandardItem主要由如下四个元素组成：数据、图标、文本颜色和字体，这些元素都可以被设置或者修改。同时，QStandardItem提供了很多接口函数，用于设置、获取、插入、移除和查找元素，便于我们对于数据模型进行实时更新和处理。

//创建QStandardItem对象
QStandardItem *item = new QStandardItem(); 
// 设置数据
item->setData(0, Qt::UserRole + 1); 
// 设置文本
item->setText("Example"); 
// 设置图标
item->setIcon(QIcon(":/xxx/xxx.ico")); 
// 设置字体颜色
item->setForeground(QBrush(Qt::darkBlue)); 
// 设置字体
QFont font;
font.setPointSize(15);
item->setFont(font); 

二、QStandardItem的应用

QStandardItem可以应用于各种树状结构、表格、列表（List）等多种数据模型。其中，应用于树状结构和列表（List）非常常见。

1、应用于树状结构

QStandardItem可以被用来表示数中的节点，并且可以通过父节点和子节点构建一个树形结构。下面是一个示例代码：

    //创建QStandardItem模型
    QStandardItemModel *model = new QStandardItemModel();
    //添加一个根节点
    QStandardItem *rootItem = model->invisibleRootItem(); 
    //添加子节点
    QStandardItem *item1 = new QStandardItem("item1");
    QStandardItem *item2 = new QStandardItem("item2");
    QStandardItem *item3 = new QStandardItem("item3");
    rootItem->appendRow(item1);
    rootItem->appendRow(item2);
    item2->appendRow(item3);

    //显示树形结构
    QTreeView *treeView = new QTreeView();
    treeView->setModel(model);
    treeView->setHeaderHidden(true);

2、应用于列表（List）

在列表（List）中，QStandardItem最常用的功能就是存储一些数据，以及根据需要设置图标、文本和字体属性等信息。下面是一个示例代码：

    //创建QStandardItem模型
    QStandardItemModel *model = new QStandardItemModel();
    //添加数据
    for(int i=0; i<10; i++){
        QString text = QString("Item %1").arg(i+1);
        QStandardItem *item = new QStandardItem(text);
        item->setIcon(QIcon(":/xxx/xxx.ico"));
        QFont font;
        font.setBold(true);
        item->setFont(font);
        model->appendRow(item);
    }

    //显示列表
    QListView *listView = new QListView();
    listView->setModel(model);

三、QStandardItem的常用接口函数

3.1 用于设置单个数据项的外观（文本、图标、字体、背景色）的函数

3.2 用于设置数据项状态(如选中、启用等)函数

3.3 其他函数

4、以下函数用于设置数据项中的子项目(注：应使用对应的树形视图进行显示)
1)、 void appendColumn(const QList &items)
        void appendRow(const QList &items)
        void appendRows(const QList &items)
        void appendRow(QStandardItem *item)
2)、 void insertColumn(int column, const QList &items)
        void insertColumns(int column, int count) //从列 column 开始插入 count 列空列
        void insertRow(int row, const QList &items)
        void insertRow(int row, QStandardItem *item)
        void insertRows(int row, const QList &items)
        void insertRows(int row, int count) //从行 row 开始插入 count 行空行

3)、 void setChild(int row, int column, QStandardItem *item)
        void setChild(int row, QStandardItem *item)
        把(row, column)处子项目的数据项设置为 item。该数据项(父数据项)获得 item 的所有
权，该函数会增加行数和列数，若 item 为空指针，将删除该位置处的数据项。
4)、 void setColumnCount(int columns); //设置列的数量 columns
        void setRowCount(int rows); //设置行的数量为 rows

5、移除或删除数据项中的子项

5)、 void removeColumn(int column) //删除列 column 处的数据项
        void removeColumns(int column, int count) //删除从列 column 开始的 count 列(原理见下图)
        void removeRow(int row)
        void removeRows(int row, int count)
6)、 QList takeColumn(int column) //移除而不删除列 column 处的数据项
        QList takeRow(int row)
7)、 QStandardItem * takeChild(int row, int column = 0)
        移除而不删除(row,column)处的数据项， 该函数不会影响子表的维数

6、获取有关子项目的信息
8)、 int column() const
        int row() const //返回该数据项所在父项中的行位置
9)、 int columnCount() const
        int rowCount() const //返回该数据项包含的子项列的数量。
10)、 QStandardItem * child(int row, int column = 0) const //返回位置(row,column)处的子项目
11)、 bool hasChildren() const //若该项有子项则返回 true
12)、 QStandardItem * parent() const //返回该项的父项，若没有父项(或顶级父项)则返回 0。
13)、 QModelIndex index() const //返回与该数据项关联的模型索引，若未与索引关联，则返回无效索引。
14)、 QStandardItemModel * model() const //返回该项目所属的 QStandardItemModel 模型