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<QStandardItem *> &items)

void appendRow (const QList<QStandardItem *> &items)

void appendRows(const QList<QStandardItem *> &items)

void appendRow(QStandardItem *item)

2)、 void insertColumn (int column, const QList<QStandardItem *> &items)

void insertColumns(int column, int count) //从列 column 开始插入 count 列空列

void insertRow (int row, const QList<QStandardItem *> &items)

void insertRow(int row, QStandardItem *item)

void insertRows(int row, const QList<QStandardItem *> &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<QStandardItem *> takeColumn (int column) //移除而不删除列 column 处的数据项

QList<QStandardItem *> 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 模型