QStandardItemModel Class▲
-
Header: QStandardItemModel
-
CMake:
find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
-
qmake: QT += gui
-
Inherits: https://
-
Group: QStandardItemModel is part of model-view
Detailed Description▲
https:// can be used as a repository for standard Qt data types. It is one of the Model/View Classes and is part of Qt's model/view framework.
https:// provides a classic item-based approach to working with the model. The items in a https:// are provided by https://.
https:// implements the https:// interface, which means that the model can be used to provide data in any view that supports that interface (such as QListView, QTableView and QTreeView, and your own custom views). For performance and flexibility, you may want to subclass https:// to provide support for different kinds of data repositories. For example, the https:// provides a model interface to the underlying file system.
When you want a list or tree, you typically create an empty https:// and use https://() to add items to the model, and https://() to access an item. If your model represents a table, you typically pass the dimensions of the table to the https:// constructor and use https://() to position items into the table. You can also use https://() and https://() to alter the dimensions of the model. To insert items, use https://() or https://(), and to remove items, use https://() or https://().
You can set the header labels of your model with https://() and https://().
You can search for items in the model with https://(), and sort the model by calling https://().
Call https://() to remove all items from the model.
An example usage of https:// to create a table:
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);
}
}An example usage of https:// to create a tree:
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;
}After setting the model on a view, you typically want to react to user actions, such as an item being clicked. Since a QAbstractItemView provides https://-based signals and functions, you need a way to obtain the https:// that corresponds to a given https://, and vice versa. https://() and https://() provide this mapping. Typical usage of https://() includes obtaining the item at the current index in a view, and obtaining the item that corresponds to an index carried by a QAbstractItemView signal, such as QAbstractItemView::clicked(). First you connect the view's signal to a slot in your class:
QTreeView *treeView = new QTreeView(this);
treeView->setModel(myStandardItemModel);
connect(treeView, &QTreeView::clicked,
this, &MyWidget::clicked);When you receive the signal, you call https://() on the given model index to get a pointer to the item:
void MyWidget::clicked(const QModelIndex &index)
{
QStandardItem *item = myStandardItemModel->itemFromIndex(index);
// Do stuff with the item ...
}Conversely, you must obtain the https:// of an item when you want to invoke a model/view function that takes an index as argument. You can obtain the index either by using the model's https://() function, or, equivalently, by calling https://():
treeView->scrollTo(item->index());You are, of course, not required to use the item-based approach; you could instead rely entirely on the https:// interface when working with the model, or use a combination of the two as appropriate.
See Also▲
See also https://, https://, QAbstractItemModel, Simple Tree Model example, Item View Convenience Classes
Property Documentation▲
[bindable] sortRole : int▲
This property supports https:// bindings.
This property holds the item role that is used to query the model's data when sorting items
The default value is https://.
See Also▲
See also https://(), https://()
Member Function Documentation▲
[explicit] QStandardItemModel::QStandardItemModel(QObject *parent = nullptr)▲
Constructs a new item model with the given parent.
QStandardItemModel::QStandardItemModel(int rows, int columns, QObject *parent = nullptr)▲
Constructs a new item model that initially has rows rows and columns columns, and that has the given parent.
[virtual] QStandardItemModel::~QStandardItemModel()▲
Destructs the model. The model destroys all its items.
void QStandardItemModel::appendColumn(const QList<QStandardItem *> &items)▲
Appends a column containing items. If necessary, the row count is increased to the size of items.
See Also▲
See also https://(), https://()
void QStandardItemModel::appendRow(const QList<QStandardItem *> &items)▲
Appends a row containing items. If necessary, the column count is increased to the size of items.
See Also▲
See also https://(), https://()
void QStandardItemModel::appendRow(QStandardItem *item)▲
This is an overloaded function.
When building a list or a tree that has only one column, this function provides a convenient way to append a single new item.
void QStandardItemModel::clear()▲
Removes all items (including header items) from the model and sets the number of rows and columns to zero.
See Also▲
See also https://(), https://()
[override virtual] bool QStandardItemModel::clearItemData(const QModelIndex &index)▲
Reimplements: https://.
[override virtual] int QStandardItemModel::columnCount(const QModelIndex &parent = QModelIndex()) const▲
[override virtual] QVariant QStandardItemModel::data(const QModelIndex &index, int role = Qt::DisplayRole) const▲
[override virtual] bool QStandardItemModel::dropMimeData(const QMimeData *data, Qt::DropAction action, int row, int column, const QModelIndex &parent)▲
Reimplements: https://.
QList<QStandardItem *> QStandardItemModel::findItems(const QString &text, Qt::MatchFlags flags = Qt::MatchExactly, int column = 0) const▲
Returns a list of items that match the given text, using the given flags, in the given column.
[override virtual] Qt::ItemFlags QStandardItemModel::flags(const QModelIndex &index) const▲
Reimplements: https://.
[override virtual] bool QStandardItemModel::hasChildren(const QModelIndex &parent = QModelIndex()) const▲
Reimplements: https://.
[override virtual] QVariant QStandardItemModel::headerData(int section, Qt::Orientation orientation, int role = Qt::DisplayRole) const▲
QStandardItem *QStandardItemModel::horizontalHeaderItem(int column) const▲
Returns the horizontal header item for column if one has been set; otherwise returns nullptr.
See Also▲
See also https://(), https://()
[override virtual] QModelIndex QStandardItemModel::index(int row, int column, const QModelIndex &parent = QModelIndex()) const▲
Reimplements: https://.
QModelIndex QStandardItemModel::indexFromItem(const QStandardItem *item) const▲
Returns the https:// associated with the given item.
Use this function when you want to perform an operation that requires the https:// of the item, such as QAbstractItemView::scrollTo(). https://() is provided as convenience; it is equivalent to calling this function.
See Also▲
See also https://(), https://()
void QStandardItemModel::insertColumn(int column, const QList<QStandardItem *> &items)▲
Inserts a column at column containing items. If necessary, the row count is increased to the size of items.
See Also▲
See also https://(), https://(), https://()
bool QStandardItemModel::insertColumn(int column, const QModelIndex &parent = QModelIndex())▲
Inserts a single column before the given column in the child items of the parent specified. Returns true if the column is inserted; otherwise returns false.
See Also▲
See also https://(), https://(), https://()
[override virtual] bool QStandardItemModel::insertColumns(int column, int count, const QModelIndex &parent = QModelIndex())▲
Reimplements: https://.
void QStandardItemModel::insertRow(int row, const QList<QStandardItem *> &items)▲
Inserts a row at row containing items. If necessary, the column count is increased to the size of items.
See Also▲
See also https://(), https://(), https://()
void QStandardItemModel::insertRow(int row, QStandardItem *item)▲
This is an overloaded function.
Inserts a row at row containing item.
When building a list or a tree that has only one column, this function provides a convenient way to append a single new item.
bool QStandardItemModel::insertRow(int row, const QModelIndex &parent = QModelIndex())▲
Inserts a single row before the given row in the child items of the parent specified. Returns true if the row is inserted; otherwise returns false.
See Also▲
See also https://(), https://(), https://()
[override virtual] bool QStandardItemModel::insertRows(int row, int count, const QModelIndex &parent = QModelIndex())▲
Reimplements: https://.
QStandardItem *QStandardItemModel::invisibleRootItem() const▲
Returns the model's invisible root item.
The invisible root item provides access to the model's top-level items through the https:// API, making it possible to write functions that can treat top-level items and their children in a uniform way; for example, recursive functions involving a tree model.
Calling https://() on the https:// object retrieved from this function is not valid.
QStandardItem *QStandardItemModel::item(int row, int column = 0) const▲
Returns the item for the given row and column if one has been set; otherwise returns nullptr.
See Also▲
See also https://(), https://(), https://()
void QStandardItemModel::itemChanged(QStandardItem *item)▲
This signal is emitted whenever the data of item has changed.
[override virtual] QMap<int, QVariant> QStandardItemModel::itemData(const QModelIndex &index) const▲
QStandardItem *QStandardItemModel::itemFromIndex(const QModelIndex &index) const▲
Returns a pointer to the https:// associated with the given index.
Calling this function is typically the initial step when processing https://-based signals from a view, such as QAbstractItemView::activated(). In your slot, you call itemFromIndex(), with the https:// carried by the signal as argument, to obtain a pointer to the corresponding https://.
Note that this function will lazily create an item for the index (using https://()), and set it in the parent item's child table, if no item already exists at that index.
If index is an invalid index, this function returns nullptr.
See Also▲
See also https://()
const QStandardItem *QStandardItemModel::itemPrototype() const▲
Returns the item prototype used by the model. The model uses the item prototype as an item factory when it needs to construct new items on demand (for instance, when a view or item delegate calls https://()).
See Also▲
See also https://()
[override virtual] QMimeData *QStandardItemModel::mimeData(const QModelIndexList &indexes) const▲
Reimplements: https://.
[override virtual] QStringList QStandardItemModel::mimeTypes() const▲
Reimplements: https://.
[override virtual] void QStandardItemModel::multiData(const QModelIndex &index, QModelRoleDataSpan roleDataSpan) const▲
Reimplements: https://.
[override virtual] QModelIndex QStandardItemModel::parent(const QModelIndex &child) const▲
Reimplements: https://.
[override virtual] bool QStandardItemModel::removeColumns(int column, int count, const QModelIndex &parent = QModelIndex())▲
Reimplements: https://.
[override virtual] bool QStandardItemModel::removeRows(int row, int count, const QModelIndex &parent = QModelIndex())▲
Reimplements: https://.
[override virtual] QHash<int, QByteArray> QStandardItemModel::roleNames() const▲
Reimplements: https://.
reimp
[override virtual] int QStandardItemModel::rowCount(const QModelIndex &parent = QModelIndex()) const▲
void QStandardItemModel::setColumnCount(int columns)▲
Sets the number of columns in this model to columns. If this is less than https://(), the data in the unwanted columns is discarded.
See Also▲
See also https://(), https://()
[override virtual] bool QStandardItemModel::setData(const QModelIndex &index, const QVariant &value, int role = Qt::EditRole)▲
[override virtual] bool QStandardItemModel::setHeaderData(int section, Qt::Orientation orientation, const QVariant &value, int role = Qt::EditRole)▲
void QStandardItemModel::setHorizontalHeaderItem(int column, QStandardItem *item)▲
Sets the horizontal header item for column to item. The model takes ownership of the item. If necessary, the column count is increased to fit the item. The previous header item (if there was one) is deleted.
See Also▲
See also https://(), https://(), https://()
void QStandardItemModel::setHorizontalHeaderLabels(const QStringList &labels)▲
Sets the horizontal header labels using labels. If necessary, the column count is increased to the size of labels.
See Also▲
See also https://()
void QStandardItemModel::setItem(int row, int column, QStandardItem *item)▲
Sets the item for the given row and column to item. The model takes ownership of the item. If necessary, the row count and column count are increased to fit the item. The previous item at the given location (if there was one) is deleted.
See Also▲
See also https://()
void QStandardItemModel::setItem(int row, QStandardItem *item)▲
This is an overloaded function.
[override virtual] bool QStandardItemModel::setItemData(const QModelIndex &index, const QMap<int, QVariant> &roles)▲
void QStandardItemModel::setItemPrototype(const QStandardItem *item)▲
Sets the item prototype for the model to the specified item. The model takes ownership of the prototype.
The item prototype acts as a https:// factory, by relying on the https://() function. To provide your own prototype, subclass https://, reimplement https://() and set the prototype to be an instance of your custom class. Whenever https:// needs to create an item on demand (for instance, when a view or item delegate calls https://())), the new items will be instances of your custom class.
See Also▲
See also https://(), https://()
void QStandardItemModel::setItemRoleNames(const QHash<int, QByteArray> &roleNames)▲
Sets the item role names to roleNames.
void QStandardItemModel::setRowCount(int rows)▲
Sets the number of rows in this model to rows. If this is less than https://(), the data in the unwanted rows is discarded.
See Also▲
See also https://(), https://()
void QStandardItemModel::setVerticalHeaderItem(int row, QStandardItem *item)▲
Sets the vertical header item for row to item. The model takes ownership of the item. If necessary, the row count is increased to fit the item. The previous header item (if there was one) is deleted.
See Also▲
See also https://(), https://(), https://()
void QStandardItemModel::setVerticalHeaderLabels(const QStringList &labels)▲
Sets the vertical header labels using labels. If necessary, the row count is increased to the size of labels.
See Also▲
See also https://()
[override virtual] void QStandardItemModel::sort(int column, Qt::SortOrder order = Qt::AscendingOrder)▲
Reimplements: https://.
[override virtual] Qt::DropActions QStandardItemModel::supportedDropActions() const▲
Reimplements: https://.
https:// supports both copy and move.
QList<QStandardItem *> QStandardItemModel::takeColumn(int column)▲
Removes the given column without deleting the column items, and returns a list of pointers to the removed items. The model releases ownership of the items. For items in the column that have not been set, the corresponding pointers in the list will be nullptr.
See Also▲
See also https://()
QStandardItem *QStandardItemModel::takeHorizontalHeaderItem(int column)▲
Removes the horizontal header item at column from the header without deleting it, and returns a pointer to the item. The model releases ownership of the item.
See Also▲
See also https://(), https://()
QStandardItem *QStandardItemModel::takeItem(int row, int column = 0)▲
Removes the item at (row, column) without deleting it. The model releases ownership of the item.
See Also▲
See also https://(), https://(), https://()
QList<QStandardItem *> QStandardItemModel::takeRow(int row)▲
Removes the given row without deleting the row items, and returns a list of pointers to the removed items. The model releases ownership of the items. For items in the row that have not been set, the corresponding pointers in the list will be nullptr.
See Also▲
See also https://()
QStandardItem *QStandardItemModel::takeVerticalHeaderItem(int row)▲
Removes the vertical header item at row from the header without deleting it, and returns a pointer to the item. The model releases ownership of the item.
See Also▲
See also https://(), https://()
QStandardItem *QStandardItemModel::verticalHeaderItem(int row) const▲
Returns the vertical header item for row row if one has been set; otherwise returns nullptr.
See Also▲
See also https://(), https://()