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

Documentación de las funciones miembro

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

Construye un nuevo modelo de artículo con la dirección parent.

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

Construye un nuevo modelo de artículo que inicialmente tiene rows filas y columns columnas, y que tiene el parent dado.

[virtual noexcept] QStandardItemModel::~QStandardItemModel()

Destruye el modelo. El modelo destruye todos sus objetos.

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

Añade una columna que contiene items. Si es necesario, el recuento de filas se incrementa hasta el tamaño de items.

Véase también insertColumn() y appendRow().

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

Añade una fila que contiene items. Si es necesario, el recuento de columnas se incrementa hasta el tamaño de items.

Véase también insertRow() y appendColumn().

void QStandardItemModel::appendRow(QStandardItem *item)

Cuando se construye una lista o un árbol que sólo tiene una columna, esta función proporciona una forma cómoda de añadir una nueva item.

void QStandardItemModel::clear()

Elimina todos los elementos (incluidos los de cabecera) del modelo y pone a cero el número de filas y columnas.

Véase también removeColumns() y removeRows().

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

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

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

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

Véase también setColumnCount().

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

Reimplementa: QAbstractItemModel::data(const QModelIndex &index, int rol) const.

Véase también setData().

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

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

Devuelve una lista de elementos que coinciden con el text dado , utilizando el flags dado , en el column dado .

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

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

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

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

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

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

Véase también setHeaderData().

QStandardItem *QStandardItemModel::horizontalHeaderItem(int column) const

Devuelve el elemento de cabecera horizontal para column si se ha establecido uno; en caso contrario devuelve nullptr.

Véase también setHorizontalHeaderItem() y verticalHeaderItem().

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

Reimplementa: QAbstractItemModel::index(int fila, int columna, const QModelIndex &parent) const.

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

Devuelve el QModelIndex asociado al item dado.

Utilice esta función cuando desee realizar una operación que requiera el QModelIndex del elemento, como QAbstractItemView::scrollTo(). QStandardItem::index() se proporciona por comodidad; equivale a llamar a esta función.

Véase también itemFromIndex() y QStandardItem::index().

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

Inserta una columna en column que contiene items. Si es necesario, el recuento de filas se incrementa hasta el tamaño de items.

Véase también takeColumn(), appendColumn() y insertRow().

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

Inserta una sola columna antes del column dado en los elementos hijos del parent especificado. Devuelve true si se inserta la columna; en caso contrario devuelve false.

Véase también insertColumns(), insertRow() y removeColumn().

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

Reimplementa: QAbstractItemModel::insertColumns(int columna, int cuenta, const QModelIndex &parent).

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

Inserta una fila en row que contiene items. Si es necesario, el recuento de columnas se incrementa hasta el tamaño de items.

Véase también takeRow(), appendRow() y insertColumn().

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

Inserta una única fila antes del row dado en los elementos hijos del parent especificado. Devuelve true si se inserta la fila; en caso contrario devuelve false.

Véase también insertRows(), insertColumn() y removeRow().

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

Inserta una fila en row que contiene item.

Cuando se construye una lista o un árbol que sólo tiene una columna, esta función proporciona una manera conveniente de añadir un solo elemento nuevo.

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

Reimplementa: QAbstractItemModel::insertRows(int fila, int recuento, const QModelIndex &parent).

QStandardItem *QStandardItemModel::invisibleRootItem() const

Devuelve el elemento raíz invisible del modelo.

El elemento raíz invisible proporciona acceso a los elementos de nivel superior del modelo a través de la API QStandardItem, lo que permite escribir funciones que pueden tratar los elementos de nivel superior y sus hijos de manera uniforme; por ejemplo, funciones recursivas que implican un modelo de árbol.

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

Devuelve el elemento para el row dado y column si se ha establecido uno; de lo contrario devuelve nullptr.

Véase también setItem(), takeItem() y itemFromIndex().

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

Esta señal se emite cuando cambian los datos de item.

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

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

Véase también setItemData().

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

Devuelve un puntero al QStandardItem asociado con el index dado.

Llamar a esta función suele ser el paso inicial cuando se procesan señales basadas en QModelIndex desde una vista, como QAbstractItemView::activated(). En su ranura, se llama a itemFromIndex(), con el QModelIndex que lleva la señal como argumento, para obtener un puntero al QStandardItem correspondiente.

Tenga en cuenta que esta función creará perezosamente un ítem para el índice (usando itemPrototype()), y lo establecerá en la tabla hija del ítem padre, si no existe ya ningún ítem en ese índice.

Si index es un índice inválido, esta función devuelve nullptr.

Véase también indexFromItem().

const QStandardItem *QStandardItemModel::itemPrototype() const

Devuelve el prototipo de elemento utilizado por el modelo. El modelo utiliza el prototipo de elemento como una fábrica de elementos cuando necesita construir nuevos elementos bajo demanda (por ejemplo, cuando un delegado de vista o elemento llama a setData()).

Véase también setItemPrototype().

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

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

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

Reimplementa: QAbstractItemModel::mimeTypes() const.

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

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

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

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

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

Reimplementa: QAbstractItemModel::removeColumns(int columna, int cuenta, const QModelIndex &parent).

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

Reimplementa: QAbstractItemModel::removeRows(int fila, int recuento, const QModelIndex &parent).

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

Reimplementa: QAbstractItemModel::roleNames() const.

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

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

Véase también setRowCount().

void QStandardItemModel::setColumnCount(int columns)

Establece el número de columnas de este modelo en columns. Si es inferior a columnCount(), se descartan los datos de las columnas no deseadas.

Véase también columnCount() y setRowCount().

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

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

Véase también data().

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

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

Véase también headerData().

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

Establece el elemento de cabecera horizontal para column en item. El modelo se apropia del elemento. Si es necesario, se aumenta el número de columnas para que quepa el elemento. El elemento de cabecera anterior (si existía) se elimina.

Véase también horizontalHeaderItem(), setHorizontalHeaderLabels(), y setVerticalHeaderItem().

void QStandardItemModel::setHorizontalHeaderLabels(const QStringList &labels)

Establece las etiquetas de cabecera horizontales utilizando labels. Si es necesario, aumenta el número de columnas hasta el tamaño de labels.

Véase también setHorizontalHeaderItem().

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

Establece el elemento para los datos row y column en item. El modelo se apropia del elemento. Si es necesario, el recuento de filas y columnas se incrementa para ajustarse al elemento. El elemento anterior en la ubicación dada (si había uno) se elimina.

Véase también item().

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

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

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

Véase también itemData().

void QStandardItemModel::setItemPrototype(const QStandardItem *item)

Establece el prototipo de elemento para el modelo en la dirección item especificada. El modelo se apropia del prototipo.

El prototipo de elemento actúa como una fábrica de QStandardItem, dependiendo de la función QStandardItem::clone(). Para proporcionar su propio prototipo, subclase QStandardItem, reimplemente QStandardItem::clone() y configure el prototipo para que sea una instancia de su clase personalizada. Siempre que QStandardItemModel necesite crear un elemento bajo demanda (por ejemplo, cuando un delegado de vista o elemento llame a setData())), los nuevos elementos serán instancias de tu clase personalizada.

Véase también itemPrototype() y QStandardItem::clone().

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

Establece los nombres de los roles de los elementos en roleNames.

void QStandardItemModel::setRowCount(int rows)

Establece el número de filas de este modelo en rows. Si es inferior a rowCount(), se descartan los datos de las filas no deseadas.

Véase también rowCount() y setColumnCount().

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

Establece el elemento de cabecera vertical para row en item. El modelo se apropia del elemento. Si es necesario, se aumenta el número de filas para que quepa el elemento. El elemento de cabecera anterior (si existía) se elimina.

Véase también verticalHeaderItem(), setVerticalHeaderLabels(), y setHorizontalHeaderItem().

void QStandardItemModel::setVerticalHeaderLabels(const QStringList &labels)

Establece las etiquetas de cabecera verticales utilizando labels. Si es necesario, el recuento de filas se incrementa hasta el tamaño de labels.

Véase también setVerticalHeaderItem().

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

Reimplementa: QAbstractItemModel::sort(int columna, Qt::SortOrder orden).

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

Reimplementa: QAbstractItemModel::supportedDropActions() const.

QStandardItemModel soporta tanto copiar como mover.

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

Elimina el column dado sin borrar los elementos de la columna, y devuelve una lista de punteros a los elementos eliminados. El modelo libera la propiedad de los elementos. Para los elementos de la columna que no se hayan establecido, los punteros correspondientes de la lista serán nullptr.

Véase también takeRow().

QStandardItem *QStandardItemModel::takeHorizontalHeaderItem(int column)

Elimina el elemento de cabecera horizontal en column de la cabecera sin borrarlo, y devuelve un puntero al elemento. El modelo libera la propiedad del elemento.

Véase también horizontalHeaderItem() y takeVerticalHeaderItem().

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

Elimina el elemento en (row, column) sin borrarlo. El modelo libera la propiedad del elemento.

Véase también item(), takeRow() y takeColumn().

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

Elimina el row dado sin borrar los elementos de la fila, y devuelve una lista de punteros a los elementos eliminados. El modelo libera la propiedad de los elementos. Para los elementos de la fila que no se hayan establecido, los punteros correspondientes de la lista serán nullptr.

Véase también takeColumn().

QStandardItem *QStandardItemModel::takeVerticalHeaderItem(int row)

Elimina el elemento de cabecera vertical en row de la cabecera sin borrarlo, y devuelve un puntero al elemento. El modelo libera la propiedad del elemento.

Véase también verticalHeaderItem() y takeHorizontalHeaderItem().

QStandardItem *QStandardItemModel::verticalHeaderItem(int row) const

Devuelve el elemento de cabecera vertical de la fila row si se ha establecido uno; en caso contrario devuelve nullptr.

Véase también setVerticalHeaderItem() y horizontalHeaderItem().