QStandardItemModel Class

QStandardItemModel model(4, 4);
for (int row = 0; row < model.rowCount(); ++row) {
    for (int column = 0; column < model.columnCount(); ++column) {
        QStandardItem *item = new QStandardItem(QString("row %0, column %1").arg(row).arg(column));
        model.setItem(row, column, item);
    }
}

QStandardItemModel model;
QStandardItem *parentItem = model.invisibleRootItem();
for (int i = 0; i < 4; ++i) {
    QStandardItem *item = new QStandardItem(QString("item %0").arg(i));
    parentItem->appendRow(item);
    parentItem = item;
}

QTreeView *treeView = new QTreeView(this);
treeView->setModel(myStandardItemModel);
connect(treeView, &QTreeView::clicked,
        this, &MyWidget::clicked);

void MyWidget::clicked(const QModelIndex &index)
{
    QStandardItem *item = myStandardItemModel->itemFromIndex(index);
    // Do stuff with the item ...
}

treeView->scrollTo(item->index());

成员函数文档

[explicit] QStandardItemModel::QStandardItemModel(QObject *parent = nullptr)

用给定的parent 构建一个新的项目模型。

QStandardItemModel::QStandardItemModel(int rows, int columns, QObject *parent = nullptr)

构建一个新的项目模型，该模型最初有rows 行和columns 列，并有给定的parent 。

[virtual noexcept] QStandardItemModel::~QStandardItemModel()

销毁模型。模型会销毁所有物品。

void QStandardItemModel::appendColumn(const QList<QStandardItem *> &items)

添加包含items 的列。如有必要，行数将增加到items 的大小。

另请参阅 insertColumn() 和appendRow()。

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

添加包含items 的行。如有必要，列数将增加到items 的大小。

另请参阅 insertRow() 和appendColumn()。

void QStandardItemModel::appendRow(QStandardItem *item)

这是一个重载函数。

在构建只有一列的列表或树时，该函数提供了一种方便的方法来追加一个新的item 。

void QStandardItemModel::clear()

从模型中删除所有项（包括标题项），并将行数和列数设置为零。

另请参阅 removeColumns() 和removeRows()。

[override virtual] bool QStandardItemModel::clearItemData(const QModelIndex &index)

重实现：QAbstractItemModel::clearItemData(const QModelIndex &index).

[override virtual] int QStandardItemModel::columnCount(const QModelIndex &parent = QModelIndex()) const

重实现：QAbstractItemModel::columnCount(const QModelIndex &parent) const。

另请参阅 setColumnCount().

[override virtual] QVariant QStandardItemModel::data(const QModelIndex &index, int role = Qt::DisplayRole) const

重实现：QAbstractItemModel::data(const QModelIndex &index, int role) const.

另请参阅 setData().

[override virtual] bool QStandardItemModel::dropMimeData(const QMimeData *data, Qt::DropAction action, int row, int column, const QModelIndex &parent)

重实现：QAbstractItemModel::dropMimeData(const QMimeData *data, Qt::DropAction action, int row, int column, const QModelIndex &parent).

QList<QStandardItem *> QStandardItemModel::findItems(const QString &text, Qt::MatchFlags flags = Qt::MatchExactly, int column = 0) const

使用给定的flags ，返回在给定的column 中与给定的text 匹配的项目列表。

[override virtual] Qt::ItemFlags QStandardItemModel::flags(const QModelIndex &index) const

重实现：QAbstractItemModel::flags(const QModelIndex &index) const.

[override virtual] bool QStandardItemModel::hasChildren(const QModelIndex &parent = QModelIndex()) const

重实现：QAbstractItemModel::hasChildren(const QModelIndex &parent) const.

[override virtual] QVariant QStandardItemModel::headerData(int section, Qt::Orientation orientation, int role = Qt::DisplayRole) const

重实现：QAbstractItemModel::headerData(int section, Qt::Orientation orientation, int role) const.

另请参阅 setHeaderData().

QStandardItem *QStandardItemModel::horizontalHeaderItem(int column) const

如果已设置column 的水平标题项，则返回该标题项；否则返回nullptr 。

另请参阅 setHorizontalHeaderItem() 和verticalHeaderItem()。

[override virtual] QModelIndex QStandardItemModel::index(int row, int column, const QModelIndex &parent = QModelIndex()) const

重实现：QAbstractItemModel::index(int row, int column, const QModelIndex &parent) const.

QModelIndex QStandardItemModel::indexFromItem(const QStandardItem *item) const

返回与给定item 相关的QModelIndex 。

如果要执行需要QModelIndex 项的操作，例如QAbstractItemView::scrollTo() ，请使用此函数。QStandardItem::index() 是为方便起见而提供的；它等同于调用此函数。

另请参阅 itemFromIndex() 和QStandardItem::index()。

void QStandardItemModel::insertColumn(int column, const QList<QStandardItem *> &items)

在column 插入一列，其中包含items 。如有必要，行数将增加到items 的大小。

另请参阅 takeColumn()、appendColumn() 和insertRow()。

bool QStandardItemModel::insertColumn(int column, const QModelIndex &parent = QModelIndex())

在parent 的子项目中，在给定的column 之前插入单列。如果列已插入，则返回true ；否则返回false 。

另请参阅 insertColumns()、insertRow() 和removeColumn()。

[override virtual] bool QStandardItemModel::insertColumns(int column, int count, const QModelIndex &parent = QModelIndex())

重实现：QAbstractItemModel::insertColumns(int column, int count, const QModelIndex &parent).

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

在row 插入一行，其中包含items 。如有必要，列数将增加到items 的大小。

另请参阅 takeRow()、appendRow() 和insertColumn()。

bool QStandardItemModel::insertRow(int row, const QModelIndex &parent = QModelIndex())

在parent 的子项目中，在给定的row 之前插入一行。如果行已插入，则返回true ；否则返回false 。

另请参阅 insertRows()、insertColumn() 和removeRow()。

void QStandardItemModel::insertRow(int row, QStandardItem *item)

这是一个重载函数。

在row 处插入一行，包含item 。

在构建只有一列的列表或树时，该函数提供了一种添加单个新项的便捷方法。

[override virtual] bool QStandardItemModel::insertRows(int row, int count, const QModelIndex &parent = QModelIndex())

重实现：QAbstractItemModel::insertRows(int row, int count, const QModelIndex &parent).

QStandardItem *QStandardItemModel::invisibleRootItem() const

返回模型的不可见根项。

不可见根项通过QStandardItem API 提供了对模型顶层项的访问，从而使编写能以统一方式处理顶层项及其子项的函数成为可能；例如，涉及树形模型的递归函数。

QStandardItem *QStandardItemModel::item(int row, int column = 0) const

如果已设置row 和column ，则返回给定 和 的项目；否则返回nullptr 。

另请参阅 setItem()、takeItem() 和itemFromIndex()。

[signal] void QStandardItemModel::itemChanged(QStandardItem *item)

只要item 的数据发生变化，就会发出该信号。

[override virtual] QMap<int, QVariant> QStandardItemModel::itemData(const QModelIndex &index) const

重实现：QAbstractItemModel::itemData(const QModelIndex &index) const。

另请参阅 setItemData().

QStandardItem *QStandardItemModel::itemFromIndex(const QModelIndex &index) const

返回与给定index 相关联的QStandardItem 的指针。

在处理视图中基于QModelIndex 的信号（如QAbstractItemView::activated() ）时，调用该函数通常是第一步。在您的槽中，以信号携带的QModelIndex 为参数调用 itemFromIndex()，以获取指向相应QStandardItem 的指针。

请注意，该函数将为索引创建一个项目（使用itemPrototype()) ，如果该索引下没有项目，则将其设置在父项目的子表中。

如果index 是无效索引，该函数将返回nullptr 。

另请参见 indexFromItem()。

const QStandardItem *QStandardItemModel::itemPrototype() const

返回模型使用的项目原型。当模型需要按需构建新项目时（例如，当视图或项目委托调用setData() 时），会将项目原型用作项目工厂。

另请参阅 setItemPrototype()。

[override virtual] QMimeData *QStandardItemModel::mimeData(const QModelIndexList &indexes) const

重实现：QAbstractItemModel::mimeData(const QModelIndexList &indexes) const.

[override virtual] QStringList QStandardItemModel::mimeTypes() const

重实现：QAbstractItemModel::mimeTypes() const.

[override virtual] void QStandardItemModel::multiData(const QModelIndex &index, QModelRoleDataSpan roleDataSpan) const

重实现：QAbstractItemModel::multiData(const QModelIndex &index, QModelRoleDataSpan roleDataSpan) const.

[override virtual] QModelIndex QStandardItemModel::parent(const QModelIndex &child) const

重实现：QAbstractItemModel::parent(const QModelIndex &index) const.

[override virtual] bool QStandardItemModel::removeColumns(int column, int count, const QModelIndex &parent = QModelIndex())

重实现：QAbstractItemModel::removeColumns(int column, int count, const QModelIndex &parent).

[override virtual] bool QStandardItemModel::removeRows(int row, int count, const QModelIndex &parent = QModelIndex())

重实现：QAbstractItemModel::removeRows(int row, int count, const QModelIndex &parent).

[override virtual] QHash<int, QByteArray> QStandardItemModel::roleNames() const

重实现：QAbstractItemModel::roleNames() const.

[override virtual] int QStandardItemModel::rowCount(const QModelIndex &parent = QModelIndex()) const

重实现：QAbstractItemModel::rowCount(const QModelIndex &parent) const。

另请参阅 setRowCount().

void QStandardItemModel::setColumnCount(int columns)

将此模型中的列数设置为columns 。如果小于columnCount()，不需要的列中的数据将被丢弃。

另请参阅 columnCount() 和setRowCount()。

[override virtual] bool QStandardItemModel::setData(const QModelIndex &index, const QVariant &value, int role = Qt::EditRole)

重实现：QAbstractItemModel::setData(const QModelIndex &index, const QVariant &value, int role）。

另请参阅 data().

[override virtual] bool QStandardItemModel::setHeaderData(int section, Qt::Orientation orientation, const QVariant &value, int role = Qt::EditRole)

重实现：QAbstractItemModel::setHeaderData(int section, Qt::Orientation orientation, const QVariant &value, int role）。

另请参阅 headerData().

void QStandardItemModel::setHorizontalHeaderItem(int column, QStandardItem *item)

将column 的水平标题项设置为item 。模型拥有该项的所有权。如有必要，将增加列数以适应项目。之前的页眉项（如果有的话）将被删除。

另请参阅 horizontalHeaderItem()、setHorizontalHeaderLabels() 和setVerticalHeaderItem()。

void QStandardItemModel::setHorizontalHeaderLabels(const QStringList &labels)

使用labels 设置水平标题标签。如有必要，列数将增加到labels 的大小。

另请参阅 setHorizontalHeaderItem() 。

void QStandardItemModel::setItem(int row, int column, QStandardItem *item)

将给定的row 和column 的项目设置为item 。模型拥有该项的所有权。如有必要，将增加行数和列数以适应项目。在给定位置的上一个项目（如果有的话）将被删除。

另请参见 item() 。

void QStandardItemModel::setItem(int row, QStandardItem *item)

这是一个重载函数。

[override virtual] bool QStandardItemModel::setItemData(const QModelIndex &index, const QMap<int, QVariant> &roles)

重实现：QAbstractItemModel::setItemData(const QModelIndex &index, const QMap<int, QVariant> &roles）。

另请参阅 itemData().

void QStandardItemModel::setItemPrototype(const QStandardItem *item)

将模型的项目原型设置为指定的item 。模型拥有原型的所有权。

项目原型依靠QStandardItem::clone() 函数作为QStandardItem 工厂。要提供自己的原型，请子类QStandardItem ，重新实现QStandardItem::clone() 并将原型设置为自定义类的实例。无论何时QStandardItemModel 需要按需创建项目（例如，当视图或项目委托调用setData()) 时），新项目都将是您自定义类的实例。

另请参阅 itemPrototype() 和QStandardItem::clone()。

void QStandardItemModel::setItemRoleNames(const QHash<int, QByteArray> &roleNames)

将项目角色名称设置为roleNames 。

void QStandardItemModel::setRowCount(int rows)

将此模型中的行数设置为rows 。如果行数小于rowCount() ，不需要的行中的数据将被丢弃。

另请参阅 rowCount() 和setColumnCount()。

void QStandardItemModel::setVerticalHeaderItem(int row, QStandardItem *item)

将row 的垂直标题项设置为item 。模型拥有该项的所有权。如有必要，将增加行数以适应该项目。之前的页眉项（如果有的话）将被删除。

另请参阅 verticalHeaderItem()、setVerticalHeaderLabels() 和setHorizontalHeaderItem()。

void QStandardItemModel::setVerticalHeaderLabels(const QStringList &labels)

使用labels 设置垂直标题标签。如有必要，行数将增加到labels 的大小。

另请参阅 setVerticalHeaderItem() 。

[override virtual] void QStandardItemModel::sort(int column, Qt::SortOrder order = Qt::AscendingOrder)

重实现：QAbstractItemModel::sort(int column, Qt::SortOrder order)。

[override virtual] Qt::DropActions QStandardItemModel::supportedDropActions() const

重实现：QAbstractItemModel::supportedDropActions() 常量。

QStandardItemModel 支持复制和移动。

QList<QStandardItem *> QStandardItemModel::takeColumn(int column)

删除给定的column ，但不删除列项，并返回指向被删除项的指针列表。模型会释放项目的所有权。对于列中尚未设置的项目，列表中相应的指针将是nullptr 。

另请参阅 takeRow() 。

QStandardItem *QStandardItemModel::takeHorizontalHeaderItem(int column)

从页眉中删除位于column 的水平页眉项，但不删除它，并返回指向该项的指针。模型将释放项目的所有权。

另请参阅 horizontalHeaderItem() 和takeVerticalHeaderItem()。

QStandardItem *QStandardItemModel::takeItem(int row, int column = 0)

删除 (row,column) 处的项目，但不删除它。模型会释放项目的所有权。

另请参阅 item(),takeRow() 和takeColumn()。

QList<QStandardItem *> QStandardItemModel::takeRow(int row)

删除给定的row ，但不删除行项目，并返回指向被删除项目的指针列表。模型会释放项目的所有权。对于行中未被设置的项目，列表中相应的指针将是nullptr 。

另请参见 takeColumn() 。

QStandardItem *QStandardItemModel::takeVerticalHeaderItem(int row)

将位于row 的垂直页眉项从页眉中移除，但不删除它，并返回指向该项的指针。模型会释放项目的所有权。

另请参阅 verticalHeaderItem() 和takeHorizontalHeaderItem()。

QStandardItem *QStandardItemModel::verticalHeaderItem(int row) const

如果已设置row ，则返回该行的垂直标题项；否则返回nullptr 。

另请参阅 setVerticalHeaderItem() 和horizontalHeaderItem()。