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

Documentation des fonctions membres

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

Construit un nouveau modèle d'élément avec l'adresse parent.

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

Construit un nouveau modèle d'élément qui a initialement des lignes rows et des colonnes columns, et qui a la valeur parent.

[virtual noexcept] QStandardItemModel::~QStandardItemModel()

Détruit le modèle. Le modèle détruit tous ses éléments.

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

Ajoute une colonne contenant items. Si nécessaire, le nombre de lignes est augmenté pour atteindre la taille de items.

Voir également insertColumn() et appendRow().

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

Ajoute une ligne contenant items. Si nécessaire, le nombre de colonnes est augmenté pour atteindre la taille de items.

Voir également insertRow() et appendColumn().

void QStandardItemModel::appendRow(QStandardItem *item)

Lors de la construction d'une liste ou d'un arbre ne comportant qu'une seule colonne, cette fonction offre un moyen pratique d'ajouter une nouvelle colonne item.

void QStandardItemModel::clear()

Supprime tous les éléments (y compris les éléments d'en-tête) du modèle et met le nombre de lignes et de colonnes à zéro.

Voir également removeColumns() et removeRows().

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

Réimplémente : QAbstractItemModel::clearItemData(const QModelIndex &index).

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

Réimplémente : QAbstractItemModel::columnCount(const QModelIndex &parent) const.

Voir également setColumnCount().

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

Réimplémente : QAbstractItemModel::data(const QModelIndex &index, int role) const.

Voir également setData().

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

Réimplémente : 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

Renvoie une liste d'éléments qui correspondent à text, en utilisant flags, dans column.

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

Réimplémente : QAbstractItemModel::flags(const QModelIndex &index) const.

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

Réimplémente : QAbstractItemModel::hasChildren(const QModelIndex &parent) const.

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

Réimplémente : QAbstractItemModel::headerData(int section, Qt::Orientation orientation, int role) const.

Voir également setHeaderData().

QStandardItem *QStandardItemModel::horizontalHeaderItem(int column) const

Renvoie l'élément d'en-tête horizontal pour column si un tel élément a été défini ; sinon, renvoie nullptr.

Voir aussi setHorizontalHeaderItem() et verticalHeaderItem().

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

Réimplémente : QAbstractItemModel::index(int row, int column, const QModelIndex &parent) const.

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

Renvoie l'adresse QModelIndex associée à l'adresse item donnée.

Utilisez cette fonction lorsque vous souhaitez effectuer une opération qui nécessite QModelIndex de l'élément, comme QAbstractItemView::scrollTo(). QStandardItem::index() est fourni par commodité ; il équivaut à l'appel de cette fonction.

Voir également itemFromIndex() et QStandardItem::index().

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

Insère une colonne à column contenant items. Si nécessaire, le nombre de lignes est augmenté pour atteindre la taille de items.

Voir également takeColumn(), appendColumn() et insertRow().

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

Insère une colonne unique avant l'élément column dans les éléments enfants de l'élément parent spécifié. Renvoie true si la colonne est insérée, sinon renvoie false.

Voir aussi insertColumns(), insertRow() et removeColumn().

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

Réimplémente : QAbstractItemModel::insertColumns(int column, int count, const QModelIndex &parent).

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

Insère une ligne à row contenant items. Si nécessaire, le nombre de colonnes est augmenté pour atteindre la taille de items.

Voir également takeRow(), appendRow() et insertColumn().

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

Insère une seule ligne avant le site row dans les éléments enfants du site parent spécifié. Retourne true si la ligne est insérée, sinon retourne false.

Voir aussi insertRows(), insertColumn() et removeRow().

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

Insère une ligne à row contenant item.

Lors de la construction d'une liste ou d'un arbre ne comportant qu'une seule colonne, cette fonction offre un moyen pratique d'ajouter un seul nouvel élément.

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

Réimplémente : QAbstractItemModel::insertRows(int row, int count, const QModelIndex &parent).

QStandardItem *QStandardItemModel::invisibleRootItem() const

Renvoie l'élément racine invisible du modèle.

L'élément racine invisible permet d'accéder aux éléments de premier niveau du modèle via l'API QStandardItem, ce qui permet d'écrire des fonctions qui peuvent traiter les éléments de premier niveau et leurs enfants de manière uniforme ; par exemple, des fonctions récursives impliquant un modèle arborescent.

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

Renvoie l'élément correspondant à row et column si un élément a été défini ; sinon, il renvoie nullptr.

Voir aussi setItem(), takeItem() et itemFromIndex().

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

Ce signal est émis lorsque les données de item ont changé.

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

Réimplémente : QAbstractItemModel::itemData(const QModelIndex &index) const.

Voir également setItemData().

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

Renvoie un pointeur sur QStandardItem associé à index.

L'appel à cette fonction est généralement l'étape initiale du traitement des signaux basés sur QModelIndex à partir d'une vue, comme QAbstractItemView::activated(). Dans votre slot, vous appelez itemFromIndex(), avec le QModelIndex porté par le signal comme argument, pour obtenir un pointeur sur le QStandardItem correspondant.

Notez que cette fonction créera paresseusement un élément pour l'index (en utilisant itemPrototype()), et le placera dans la table des enfants de l'élément parent, si aucun élément n'existe déjà à cet index.

Si index est un index invalide, cette fonction renvoie nullptr.

Voir aussi indexFromItem().

const QStandardItem *QStandardItemModel::itemPrototype() const

Renvoie le prototype d'élément utilisé par le modèle. Le modèle utilise le prototype d'élément comme une fabrique d'éléments lorsqu'il doit construire de nouveaux éléments à la demande (par exemple, lorsqu'un délégué de vue ou d'élément appelle setData()).

Voir aussi setItemPrototype().

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

Réimplémente : QAbstractItemModel::mimeData(const QModelIndexList &indexes) const.

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

Réimplémente : QAbstractItemModel::mimeTypes() const.

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

Réimplémente : QAbstractItemModel::multiData(const QModelIndex &index, QModelRoleDataSpan roleDataSpan) const.

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

Réimplémente : QAbstractItemModel::parent(const QModelIndex &index) const.

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

Réimplémente : QAbstractItemModel::removeColumns(int column, int count, const QModelIndex &parent).

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

Réimplémente : QAbstractItemModel::removeRows(int row, int count, const QModelIndex &parent).

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

Réimplémente : QAbstractItemModel::roleNames() const.

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

Réimplémente : QAbstractItemModel::rowCount(const QModelIndex &parent) const.

Voir également setRowCount().

void QStandardItemModel::setColumnCount(int columns)

Fixe le nombre de colonnes de ce modèle à columns. Si ce nombre est inférieur à columnCount(), les données des colonnes non désirées sont supprimées.

Voir également columnCount() et setRowCount().

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

Réimplémente : QAbstractItemModel::setData(const QModelIndex &index, const QVariant &value, int role).

Voir également data().

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

Réimplémente : QAbstractItemModel::setHeaderData(int section, Qt::Orientation orientation, const QVariant &value, int role).

Voir également headerData().

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

Définit l'élément d'en-tête horizontal pour column à item. Le modèle prend en charge l'élément. Si nécessaire, le nombre de colonnes est augmenté pour s'adapter à l'élément. L'élément d'en-tête précédent (s'il y en avait un) est supprimé.

Voir également horizontalHeaderItem(), setHorizontalHeaderLabels() et setVerticalHeaderItem().

void QStandardItemModel::setHorizontalHeaderLabels(const QStringList &labels)

Définit les étiquettes d'en-tête horizontales à l'aide de labels. Si nécessaire, le nombre de colonnes est augmenté pour atteindre la taille de labels.

Voir aussi setHorizontalHeaderItem().

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

Définit l'élément pour les données row et column à item. Le modèle prend en charge l'élément. Si nécessaire, le nombre de lignes et de colonnes est augmenté pour s'adapter à l'élément. L'élément précédent à l'emplacement donné (s'il y en avait un) est supprimé.

Voir également item().

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

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

Réimplémente : QAbstractItemModel::setItemData(const QModelIndex &index, const QMap<int, QVariant> &roles).

Voir également itemData().

void QStandardItemModel::setItemPrototype(const QStandardItem *item)

Définit le prototype de l'élément pour le modèle à la valeur spécifiée item. Le modèle est propriétaire du prototype.

Le prototype d'élément agit comme une usine QStandardItem, en s'appuyant sur la fonction QStandardItem::clone(). Pour fournir votre propre prototype, sous-classez QStandardItem, réimplémentez QStandardItem::clone() et définissez le prototype comme une instance de votre classe personnalisée. Chaque fois que QStandardItemModel doit créer un élément à la demande (par exemple, lorsqu'un délégué de vue ou d'élément appelle setData()), les nouveaux éléments seront des instances de votre classe personnalisée.

Voir également itemPrototype() et QStandardItem::clone().

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

Définit les noms de rôle des éléments sur roleNames.

void QStandardItemModel::setRowCount(int rows)

Fixe le nombre de lignes de ce modèle à rows. Si ce nombre est inférieur à rowCount(), les données des lignes non désirées sont supprimées.

Voir également rowCount() et setColumnCount().

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

Définit l'élément d'en-tête vertical pour row à item. Le modèle prend en charge l'élément. Si nécessaire, le nombre de lignes est augmenté pour s'adapter à l'élément. L'élément d'en-tête précédent (s'il y en avait un) est supprimé.

Voir aussi verticalHeaderItem(), setVerticalHeaderLabels() et setHorizontalHeaderItem().

void QStandardItemModel::setVerticalHeaderLabels(const QStringList &labels)

Définit les étiquettes d'en-tête verticales à l'aide de labels. Si nécessaire, le nombre de lignes est augmenté pour atteindre la taille de labels.

Voir aussi setVerticalHeaderItem().

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

Réimplémente : QAbstractItemModel::sort(int column, Qt::SortOrder order).

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

Réimplémente : QAbstractItemModel::supportedDropActions() const.

QStandardItemModel supporte à la fois la copie et le déplacement.

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

Supprime le site column sans supprimer les éléments de la colonne et renvoie une liste de pointeurs vers les éléments supprimés. Le modèle libère la propriété des éléments. Pour les éléments de la colonne qui n'ont pas été définis, les pointeurs correspondants dans la liste seront nullptr.

Voir aussi takeRow().

QStandardItem *QStandardItemModel::takeHorizontalHeaderItem(int column)

Retire de l'en-tête l'élément d'en-tête horizontal situé à l'adresse column, sans le supprimer, et renvoie un pointeur sur l'élément. Le modèle libère la propriété de l'élément.

Voir également horizontalHeaderItem() et takeVerticalHeaderItem().

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

Supprime l'élément à (row, column) sans le supprimer. Le modèle libère la propriété de l'élément.

Voir aussi item(), takeRow() et takeColumn().

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

Supprime le site row sans supprimer les éléments de la ligne et renvoie une liste de pointeurs vers les éléments supprimés. Le modèle libère la propriété des éléments. Pour les éléments de la ligne qui n'ont pas été définis, les pointeurs correspondants dans la liste seront nullptr.

Voir aussi takeColumn().

QStandardItem *QStandardItemModel::takeVerticalHeaderItem(int row)

Retire de l'en-tête l'élément d'en-tête vertical situé à l'adresse row, sans le supprimer, et renvoie un pointeur sur l'élément. Le modèle libère la propriété de l'élément.

Voir aussi verticalHeaderItem() et takeHorizontalHeaderItem().

QStandardItem *QStandardItemModel::verticalHeaderItem(int row) const

Renvoie l'élément d'en-tête vertical pour la ligne row si un tel élément a été défini ; sinon, renvoie nullptr.

Voir aussi setVerticalHeaderItem() et horizontalHeaderItem().