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());

Dokumentation der Mitgliedsfunktionen

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

Konstruiert ein neues Objektmodell mit dem angegebenen parent.

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

Konstruiert ein neues Artikelmodell, das anfänglich rows Zeilen und columns Spalten hat, und das die angegebene parent hat.

[virtual noexcept] QStandardItemModel::~QStandardItemModel()

Zerstört das Modell. Das Modell zerstört alle seine Gegenstände.

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

Hängt eine Spalte an, die items enthält. Falls erforderlich, wird die Zeilenzahl auf die Größe von items erhöht.

Siehe auch insertColumn() und appendRow().

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

Fügt eine Zeile mit items ein. Falls erforderlich, wird die Spaltenanzahl auf die Größe von items erhöht.

Siehe auch insertRow() und appendColumn().

void QStandardItemModel::appendRow(QStandardItem *item)

Dies ist eine überladene Funktion.

Wenn Sie eine Liste oder einen Baum mit nur einer Spalte erstellen, bietet diese Funktion eine bequeme Möglichkeit, eine einzelne neue item anzuhängen.

void QStandardItemModel::clear()

Entfernt alle Elemente (einschließlich der Kopfelemente) aus dem Modell und setzt die Anzahl der Zeilen und Spalten auf Null.

Siehe auch removeColumns() und removeRows().

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

Reimplements: QAbstractItemModel::clearItemData(const QModelIndex &index).

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

Reimplements: QAbstractItemModel::columnCount(const QModelIndex &parent) const.

Siehe auch setColumnCount().

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

Reimplements: QAbstractItemModel::data(const QModelIndex &index, int role) const.

Siehe auch setData().

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

Reimplements: 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

Gibt eine Liste von Elementen zurück, die mit dem angegebenen text übereinstimmen, unter Verwendung des angegebenen flags, im angegebenen column.

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

Reimplements: QAbstractItemModel::flags(const QModelIndex &index) const.

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

Reimplements: QAbstractItemModel::hasChildren(const QModelIndex &parent) const.

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

Reimplements: QAbstractItemModel::headerData(int section, Qt::Orientation orientation, int role) const.

Siehe auch setHeaderData().

QStandardItem *QStandardItemModel::horizontalHeaderItem(int column) const

Gibt die horizontale Kopfzeile für column zurück, wenn eine gesetzt wurde; andernfalls nullptr.

Siehe auch setHorizontalHeaderItem() und verticalHeaderItem().

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

Reimplements: QAbstractItemModel::index(int row, int column, const QModelIndex &parent) const.

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

Gibt die QModelIndex zurück, die mit dem angegebenen item verbunden ist.

Verwenden Sie diese Funktion, wenn Sie eine Operation durchführen wollen, für die die QModelIndex des Elements erforderlich ist, z. B. QAbstractItemView::scrollTo(). QStandardItem::index() wird aus Bequemlichkeitsgründen zur Verfügung gestellt; es ist äquivalent zum Aufruf dieser Funktion.

Siehe auch itemFromIndex() und QStandardItem::index().

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

Fügt unter column eine Spalte ein, die items enthält. Falls erforderlich, wird die Zeilenzahl auf die Größe von items erhöht.

Siehe auch takeColumn(), appendColumn(), und insertRow().

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

Fügt eine einzelne Spalte vor der angegebenen column in die untergeordneten Elemente des angegebenen parent ein. Gibt true zurück, wenn die Spalte eingefügt wurde; andernfalls wird false zurückgegeben.

Siehe auch insertColumns(), insertRow(), und removeColumn().

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

Reimplements: QAbstractItemModel::insertColumns(int column, int count, const QModelIndex &parent).

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

Fügt unter row eine Zeile ein, die items enthält. Falls erforderlich, wird die Spaltenanzahl auf die Größe von items erhöht.

Siehe auch takeRow(), appendRow(), und insertColumn().

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

Fügt eine einzelne Zeile vor dem angegebenen row in die untergeordneten Elemente des angegebenen parent ein. Gibt true zurück, wenn die Zeile eingefügt wurde; andernfalls wird false zurückgegeben.

Siehe auch insertRows(), insertColumn(), und removeRow().

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

Dies ist eine überladene Funktion.

Fügt eine Zeile unter row ein, die item enthält.

Wenn Sie eine Liste oder einen Baum mit nur einer Spalte erstellen, bietet diese Funktion eine bequeme Möglichkeit, ein einzelnes neues Element einzufügen.

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

Reimplements: QAbstractItemModel::insertRows(int row, int count, const QModelIndex &parent).

QStandardItem *QStandardItemModel::invisibleRootItem() const

Gibt das unsichtbare Wurzelelement des Modells zurück.

Das unsichtbare Wurzelelement ermöglicht den Zugriff auf die Top-Level-Elemente des Modells über die QStandardItem API, wodurch es möglich wird, Funktionen zu schreiben, die Top-Level-Elemente und ihre Kinder auf einheitliche Weise behandeln können; zum Beispiel rekursive Funktionen, die ein Baummodell einbeziehen.

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

Gibt das Element für die angegebenen row und column zurück, wenn eines gesetzt wurde; andernfalls wird nullptr zurückgegeben.

Siehe auch setItem(), takeItem(), und itemFromIndex().

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

Dieses Signal wird ausgegeben, wenn sich die Daten von item geändert haben.

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

Reimplements: QAbstractItemModel::itemData(const QModelIndex &index) const.

Siehe auch setItemData().

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

Gibt einen Zeiger auf den QStandardItem zurück, der mit dem angegebenen index verbunden ist.

Der Aufruf dieser Funktion ist typischerweise der erste Schritt bei der Verarbeitung von QModelIndex-basierten Signalen aus einer Ansicht, wie QAbstractItemView::activated(). In Ihrem Slot rufen Sie itemFromIndex() auf, mit der QModelIndex, die das Signal als Argument trägt, um einen Zeiger auf die entsprechende QStandardItem zu erhalten.

Beachten Sie, dass diese Funktion ein Element für den Index (unter Verwendung von itemPrototype()) erstellt und es in die untergeordnete Tabelle des übergeordneten Elements einfügt, wenn noch kein Element für diesen Index existiert.

Wenn index ein ungültiger Index ist, gibt diese Funktion nullptr zurück.

Siehe auch indexFromItem().

const QStandardItem *QStandardItemModel::itemPrototype() const

Gibt den vom Modell verwendeten Item-Prototyp zurück. Das Modell verwendet den Item-Prototyp als Item-Fabrik, wenn es neue Items bei Bedarf konstruieren muss (z.B. wenn ein View oder Item-Delegate setData() aufruft).

Siehe auch setItemPrototype().

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

Reimplements: QAbstractItemModel::mimeData(const QModelIndexList &indexes) const.

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

Reimplements: QAbstractItemModel::mimeTypes() const.

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

Reimplements: QAbstractItemModel::multiData(const QModelIndex &index, QModelRoleDataSpan roleDataSpan) const.

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

Reimplements: QAbstractItemModel::parent(const QModelIndex &index) const.

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

Reimplements: QAbstractItemModel::removeColumns(int column, int count, const QModelIndex &parent).

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

Reimplements: QAbstractItemModel::removeRows(int row, int count, const QModelIndex &parent).

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

Reimplements: QAbstractItemModel::roleNames() const.

reimp

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

Reimplements: QAbstractItemModel::rowCount(const QModelIndex &parent) const.

Siehe auch setRowCount().

void QStandardItemModel::setColumnCount(int columns)

Setzt die Anzahl der Spalten in diesem Modell auf columns. Ist diese kleiner als columnCount(), werden die Daten in den nicht benötigten Spalten verworfen.

Siehe auch columnCount() und setRowCount().

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

Reimplements: QAbstractItemModel::setData(const QModelIndex &index, const QVariant &value, int role).

Siehe auch data().

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

Reimplements: QAbstractItemModel::setHeaderData(int section, Qt::Orientation orientation, const QVariant &value, int role).

Siehe auch headerData().

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

Setzt die horizontale Kopfposition für column auf item. Das Modell übernimmt die Position. Falls erforderlich, wird die Spaltenanzahl erhöht, um die Position anzupassen. Die vorherige Kopfzeile (falls vorhanden) wird gelöscht.

Siehe auch horizontalHeaderItem(), setHorizontalHeaderLabels(), und setVerticalHeaderItem().

void QStandardItemModel::setHorizontalHeaderLabels(const QStringList &labels)

Setzt die horizontalen Kopfzeilenbeschriftungen mit labels. Falls erforderlich, wird die Spaltenanzahl auf die Größe von labels erhöht.

Siehe auch setHorizontalHeaderItem().

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

Setzt das Element für die angegebene row und column auf item. Das Modell übernimmt das Eigentum an dem Element. Falls erforderlich, werden die Zeilenzahl und die Spaltenzahl erhöht, um das Element anzupassen. Das vorherige Element an der angegebenen Position (falls vorhanden) wird gelöscht.

Siehe auch item().

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

Dies ist eine überladene Funktion.

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

Reimplements: QAbstractItemModel::setItemData(const QModelIndex &index, const QMap<int, QVariant> &roles).

Siehe auch itemData().

void QStandardItemModel::setItemPrototype(const QStandardItem *item)

Setzt den Prototyp des Elements für das Modell auf den angegebenen item. Das Modell wird Eigentümer des Prototyps.

Der Elementprototyp fungiert als QStandardItem Fabrik, indem er sich auf die Funktion QStandardItem::clone() stützt. Um einen eigenen Prototyp bereitzustellen, untergliedern Sie die Klasse QStandardItem, implementieren Sie QStandardItem::clone() neu und setzen Sie den Prototyp auf eine Instanz Ihrer eigenen Klasse. Wann immer QStandardItemModel ein Element bei Bedarf erstellen muss (z. B. wenn ein View- oder Elementdelegat setData()) aufruft), werden die neuen Elemente Instanzen Ihrer benutzerdefinierten Klasse sein.

Siehe auch itemPrototype() und QStandardItem::clone().

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

Setzt die Namen der Elementrollen auf roleNames.

void QStandardItemModel::setRowCount(int rows)

Setzt die Anzahl der Zeilen in diesem Modell auf rows. Ist diese kleiner als rowCount(), werden die Daten in den nicht benötigten Zeilen verworfen.

Siehe auch rowCount() und setColumnCount().

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

Setzt die vertikale Kopfposition für row auf item. Das Modell übernimmt die Position. Falls erforderlich, wird die Zeilenzahl erhöht, um die Position anzupassen. Die vorherige Kopfzeile (falls es eine gab) wird gelöscht.

Siehe auch verticalHeaderItem(), setVerticalHeaderLabels(), und setHorizontalHeaderItem().

void QStandardItemModel::setVerticalHeaderLabels(const QStringList &labels)

Setzt die vertikalen Kopfzeilenbeschriftungen mit labels. Falls erforderlich, wird die Zeilenzahl auf die Größe von labels erhöht.

Siehe auch setVerticalHeaderItem().

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

Reimplements: QAbstractItemModel::sort(int column, Qt::SortOrder order).

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

Reimplements: QAbstractItemModel::supportedDropActions() const.

QStandardItemModel unterstützt sowohl Kopieren als auch Verschieben.

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

Entfernt die angegebene column, ohne die Spaltenelemente zu löschen, und gibt eine Liste von Zeigern auf die entfernten Elemente zurück. Das Modell gibt das Eigentum an den Elementen frei. Für Elemente in der Spalte, die nicht gesetzt wurden, lauten die entsprechenden Zeiger in der Liste nullptr.

Siehe auch takeRow().

QStandardItem *QStandardItemModel::takeHorizontalHeaderItem(int column)

Entfernt das horizontale Kopfelement unter column aus der Kopfzeile, ohne es zu löschen, und gibt einen Zeiger auf das Element zurück. Das Modell gibt das Eigentum an dem Element frei.

Siehe auch horizontalHeaderItem() und takeVerticalHeaderItem().

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

Entfernt das Element bei (row, column), ohne es zu löschen. Das Modell gibt das Eigentum an dem Element frei.

Siehe auch item(), takeRow(), und takeColumn().

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

Entfernt die angegebene row, ohne die Zeilenelemente zu löschen, und gibt eine Liste von Zeigern auf die entfernten Elemente zurück. Das Modell gibt das Eigentum an den Elementen frei. Für Elemente in der Zeile, die nicht gesetzt wurden, werden die entsprechenden Zeiger in der Liste nullptr sein.

Siehe auch takeColumn().

QStandardItem *QStandardItemModel::takeVerticalHeaderItem(int row)

Entfernt das vertikale Kopfzeilen-Element unter row aus der Kopfzeile, ohne es zu löschen, und gibt einen Zeiger auf das Element zurück. Das Modell gibt das Eigentum an dem Element frei.

Siehe auch verticalHeaderItem() und takeHorizontalHeaderItem().

QStandardItem *QStandardItemModel::verticalHeaderItem(int row) const

Gibt die vertikale Kopfzeile für die Zeile row zurück, wenn eine solche festgelegt wurde; andernfalls wird nullptr zurückgegeben.

Siehe auch setVerticalHeaderItem() und horizontalHeaderItem().