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)

1つの列のみからなるリストやツリーを構築する際、この関数を使用すると、新しいitem を1つ追加するのに便利です。

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

指定されたtext に一致する項目のリストを、指定されたflags を使用して、指定されたcolumn 内で返します。

[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 を返します。

QAbstractItemView::scrollTo() など、アイテムの `QModelIndex ` を必要とする操作を実行したい場合に、この関数を使用します。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())

指定された `column ` の前に、指定された `parent ` の子項目の中に 1 つの列を挿入します。列が挿入された場合は `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())

指定された `row ` の前に、指定された `parent ` の子項目の中に 1 行を挿入します。行が挿入された場合は `true ` を返し、そうでない場合は `false` を返します。

insertRows()、insertColumn()、およびremoveRow()も参照してください 。

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

row の位置に、item を含む行を挿入します。

1 列のみからなるリストやツリーを構築する際、この関数を使用すると、新しい項目を 1 つ追加するのに便利です。

[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 へのポインタを返します。

この関数の呼び出しは、通常、QAbstractItemView::activated() などのビューからの `QModelIndex` ベースのシグナルを処理する際の最初のステップとなります。スロット内では、シグナルによって渡される `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() const を再実装します。

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()も参照してください 。