Used to store data as defined by the software model/view paradigm. More...

Inheritance diagram for QStandardItemModel:

Public Signals
void	itemChanged (QStandardItem *item)

Public Signals inherited from QAbstractItemModel
void	columnsAboutToBeInserted (const QModelIndex &parent, int first, int last)

void	columnsAboutToBeMoved (const QModelIndex &sourceParent, int sourceStart, int sourceEnd, const QModelIndex &destinationParent, int destinationColumn)

void	columnsAboutToBeRemoved (const QModelIndex &parent, int first, int last)

void	columnsInserted (const QModelIndex &parent, int first, int last)

void	columnsMoved (const QModelIndex &sourceParent, int sourceStart, int sourceEnd, const QModelIndex &destinationParent, int destinationColumn)

void	columnsRemoved (const QModelIndex &parent, int first, int last)

void	dataChanged (const QModelIndex &topLeft, const QModelIndex &bottomRight, const QVector< int > &roles=QVector< int >())

void	headerDataChanged (Qt::Orientation orientation, int first, int last)

void	layoutAboutToBeChanged (const QList< QPersistentModelIndex > &parents=QList< QPersistentModelIndex >(), QAbstractItemModel::LayoutChangeHint hint=QAbstractItemModel::NoLayoutChangeHint)

void	layoutChanged (const QList< QPersistentModelIndex > &parents=QList< QPersistentModelIndex >(), QAbstractItemModel::LayoutChangeHint hint=QAbstractItemModel::NoLayoutChangeHint)

void	modelAboutToBeReset ()

void	modelReset ()

void	rowsAboutToBeInserted (const QModelIndex &parent, int first, int last)

void	rowsAboutToBeMoved (const QModelIndex &sourceParent, int sourceStart, int sourceEnd, const QModelIndex &destinationParent, int destinationRow)

void	rowsAboutToBeRemoved (const QModelIndex &parent, int first, int last)

void	rowsInserted (const QModelIndex &parent, int first, int last)

void	rowsMoved (const QModelIndex &sourceParent, int sourceStart, int sourceEnd, const QModelIndex &destinationParent, int destinationRow)

void	rowsRemoved (const QModelIndex &parent, int first, int last)

Public Signals inherited from QObject
void	destroyed (QObject *obj=nullptr)

void	objectNameChanged (const QString &objectName)

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

	QStandardItemModel (QObject *parent=nullptr)

	~QStandardItemModel ()

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

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

void	appendRow (QStandardItem *item)

void	clear ()

int	columnCount (const QModelIndex &parent=QModelIndex ()) const override

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

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

QList< QStandardItem * >	findItems (const QString &text, Qt::MatchFlags flags=Qt::MatchExactly, int column=0) const

Qt::ItemFlags	flags (const QModelIndex &index) const override

bool	hasChildren (const QModelIndex &parent=QModelIndex ()) const override

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

QStandardItem *	horizontalHeaderItem (int column) const

QModelIndex	index (int row, int column, const QModelIndex &parent=QModelIndex ()) const override

QModelIndex	indexFromItem (const QStandardItem *item) const

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

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

bool	insertColumns (int column, int count, const QModelIndex &parent=QModelIndex ()) override

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

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

void	insertRow (int row, QStandardItem *item)

bool	insertRows (int row, int count, const QModelIndex &parent=QModelIndex ()) override

QStandardItem *	invisibleRootItem () const

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

QMap< int, QVariant >	itemData (const QModelIndex &index) const override

QStandardItem *	itemFromIndex (const QModelIndex &index) const

const QStandardItem *	itemPrototype () const

QMimeData *	mimeData (const QModelIndexList &indexes) const override

QStringList	mimeTypes () const override

QObject *	parent () const

QModelIndex	parent (const QModelIndex &child) const override

bool	removeColumns (int column, int count, const QModelIndex &parent=QModelIndex ()) override

bool	removeRows (int row, int count, const QModelIndex &parent=QModelIndex ()) override

int	rowCount (const QModelIndex &parent=QModelIndex ()) const override

void	setColumnCount (int columns)

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

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

void	setHorizontalHeaderItem (int column, QStandardItem *item)

void	setHorizontalHeaderLabels (const QStringList &labels)

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

void	setItem (int row, QStandardItem *item)

bool	setItemData (const QModelIndex &index, const QMap< int, QVariant > &roles) override

void	setItemPrototype (const QStandardItem *item)

void	setItemRoleNames (const QMultiHash< int, QString > &roleNames)

void	setRowCount (int rows)

void	setSortRole (int role)

void	setVerticalHeaderItem (int row, QStandardItem *item)

void	setVerticalHeaderLabels (const QStringList &labels)

void	sort (int column, Qt::SortOrder order=Qt::AscendingOrder) override

int	sortRole () const

Qt::DropActions	supportedDropActions () const override

QList< QStandardItem * >	takeColumn (int column)

QStandardItem *	takeHorizontalHeaderItem (int column)

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

QList< QStandardItem * >	takeRow (int row)

QStandardItem *	takeVerticalHeaderItem (int row)

QStandardItem *	verticalHeaderItem (int row) const

Public Methods inherited from QAbstractItemModel
	QAbstractItemModel (QObject *parent=nullptr)

virtual	~QAbstractItemModel ()

virtual QModelIndex	buddy (const QModelIndex &index) const

virtual bool	canDropMimeData (const QMimeData *data, Qt::DropAction action, int row, int column, const QModelIndex &parent) const

virtual bool	canFetchMore (const QModelIndex &parent) const

virtual void	fetchMore (const QModelIndex &parent)

bool	hasIndex (int row, int column, const QModelIndex &parent=QModelIndex ()) const

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

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

virtual QModelIndexList	match (const QModelIndex &start, int role, const QVariant &value, int hits=1, Qt::MatchFlags flags=Qt::MatchFlags (Qt::MatchStartsWith\|Qt::MatchWrap)) const

bool	moveColumn (const QModelIndex &sourceParent, int sourceColumn, const QModelIndex &destinationParent, int destinationChild)

virtual bool	moveColumns (const QModelIndex &sourceParent, int sourceColumn, int count, const QModelIndex &destinationParent, int destinationChild)

bool	moveRow (const QModelIndex &sourceParent, int sourceRow, const QModelIndex &destinationParent, int destinationChild)

virtual bool	moveRows (const QModelIndex &sourceParent, int sourceRow, int count, const QModelIndex &destinationParent, int destinationChild)

QObject *	parent () const

bool	removeColumn (int column, const QModelIndex &parent=QModelIndex ())

bool	removeRow (int row, const QModelIndex &parent=QModelIndex ())

virtual QMultiHash< int, QString >	roleNames () const

virtual QModelIndex	sibling (int row, int column, const QModelIndex &index) const

virtual QSize	span (const QModelIndex &index) const

virtual Qt::DropActions	supportedDragActions () const

Public Methods inherited from QObject
	QObject (QObject *parent=nullptr)

	~QObject ()

bool	blockSignals (bool block)

const QList< QObject * > &	children () const

bool	connect (const QObject *sender, const QString &signalMethod, const QString &location, const QString &slotMethod, Qt::ConnectionType type=Qt::AutoConnection)

bool	connect (const QObject *sender, const QString &signalMethod, const QString &slotMethod, Qt::ConnectionType type=Qt::AutoConnection)

bool	disconnect (const QObject *receiver, const QString &slotMethod=QString ()) const

bool	disconnect (const QString &signalMethod, const QString &location, const QObject *receiver=nullptr, const QString &slotMethod=QString ()) const

bool	disconnect (const QString &signalMethod=QString (), const QObject *receiver=nullptr, const QString &slotMethod=QString ()) const

void	dumpObjectInfo ()

void	dumpObjectTree ()

QList< QString >	dynamicPropertyNames () const

virtual bool	event (QEvent *event)

virtual bool	eventFilter (QObject watched, QEvent event)

template<typename T >
T	findChild (const QString &childName=QString ()) const

template<class T >
QList< T >	findChildren (const QRegularExpression &regExp, Qt::FindChildOptions options=Qt::FindChildrenRecursively) const

template<class T >
QList< T >	findChildren (const QString &childName=QString (), Qt::FindChildOptions options=Qt::FindChildrenRecursively) const

bool	inherits (const QString &className) const

void	installEventFilter (QObject *filterObj)

bool	isWidgetType () const

bool	isWindowType () const

void	killTimer (int id)

const QMetaObject *	metaObject () const

void	moveToThread (QThread *targetThread)

QString	objectName () const

QObject *	parent () const

template<class T = QVariant>
T	property (const QString &name) const

void	removeEventFilter (QObject *obj)

void	setObjectName (const QString &name)

void	setParent (QObject *parent)

bool	setProperty (const QString &name, const QVariant &value)

bool	signalsBlocked () const

int	startTimer (int interval, Qt::TimerType timerType=Qt::CoarseTimer)

QThread *	thread () const

Properties
	sortRole

Properties inherited from QObject
	objectName

Friends
class	QStandardItem

Additional Inherited Members
Public Slots inherited from QAbstractItemModel
virtual void	revert ()

virtual bool	submit ()

Public Slots inherited from QObject
void	deleteLater ()

Static Public Methods inherited from QObject
static bool	connect (const QObject sender, const QMetaMethod &signalMethod, const QObject receiver, const QMetaMethod &slotMethod, Qt::ConnectionType type=Qt::AutoConnection)

static bool	connect (const QObject sender, const QString &signalMethod, const QObject receiver, const QString &slotMethod, Qt::ConnectionType type=Qt::AutoConnection, const QString &location=QString ())

static bool	connect (const QObject sender, const QString &signalMethod, const QString &location, const QObject receiver, const QString &slotMethod, Qt::ConnectionType type=Qt::AutoConnection)

template<class Sender , class SignalClass , class... SignalArgs, class Receiver , class SlotClass , class... SlotArgs, class SlotReturn >
static bool	connect (const Sender sender, void (SignalClass::signalMethod)(SignalArgs...), const Receiver receiver, SlotReturn (SlotClass::slotMethod)(SlotArgs...), Qt::ConnectionType type=Qt::AutoConnection)

template<class Sender , class SignalClass , class... SignalArgs, class Receiver , class T >
static bool	connect (const Sender sender, void (SignalClass::signalMethod)(SignalArgs...), const Receiver *receiver, T slotLambda, Qt::ConnectionType type=Qt::AutoConnection)

static bool	disconnect (const QObject sender, const QMetaMethod &signalMethod, const QObject receiver, const QMetaMethod &slotMethod)

static bool	disconnect (const QObject sender, const QString &signalMethod, const QObject receiver, const QString &slotMethod)

static bool	disconnect (const QObject sender, const QString &signalMethod, const QString &location, const QObject receiver, const QString &slotMethod)

static bool	disconnect (const QObject sender, std::nullptr_t, const QObject receiver, std::nullptr_t)

template<class Sender , class SignalClass , class... SignalArgs, class Receiver , class SlotClass , class... SlotArgs, class SlotReturn >
static bool	disconnect (const Sender sender, void (SignalClass::signalMethod)(SignalArgs...), const Receiver receiver, SlotReturn (SlotClass::slotMethod)(SlotArgs...))

template<class Sender , class SignalClass , class... SignalArgs, class Receiver >
static bool	disconnect (const Sender sender, void (SignalClass::signalMethod)(SignalArgs...), const Receiver *receiver, std::nullptr_t slotMethod=nullptr)

template<class Sender , class SignalClass , class... SignalArgs, class Receiver , class T >
static bool	disconnect (const Sender sender, void (SignalClass::signalMethod)(SignalArgs...), const Receiver *receiver, T slotMethod)

static QMetaObject &	staticMetaObject ()

static QString	tr (const char text, const char comment=nullptr, std::optional< int > numArg=std::optional< int >())

Protected Slots inherited from QAbstractItemModel
void	resetInternalData ()

Protected Methods inherited from QAbstractItemModel
void	beginInsertColumns (const QModelIndex &parent, int first, int last)

void	beginInsertRows (const QModelIndex &parent, int first, int last)

bool	beginMoveColumns (const QModelIndex &sourceParent, int sourceFirst, int sourceLast, const QModelIndex &destinationParent, int destinationColumn)

bool	beginMoveRows (const QModelIndex &sourceParent, int sourceFirst, int sourceLast, const QModelIndex &destinationParent, int destinationRow)

void	beginRemoveColumns (const QModelIndex &parent, int first, int last)

void	beginRemoveRows (const QModelIndex &parent, int first, int last)

void	beginResetModel ()

void	changePersistentIndex (const QModelIndex &from, const QModelIndex &to)

void	changePersistentIndexList (const QModelIndexList &from, const QModelIndexList &to)

QModelIndex	createIndex (int row, int column, quintptr id) const

QModelIndex	createIndex (int row, int column, void *data=nullptr) const

void	endInsertColumns ()

void	endInsertRows ()

void	endMoveColumns ()

void	endMoveRows ()

void	endRemoveColumns ()

void	endRemoveRows ()

void	endResetModel ()

QModelIndexList	persistentIndexList () const

Protected Methods inherited from QObject
virtual void	childEvent (QChildEvent *event)

virtual void	connectNotify (const QMetaMethod &signalMethod) const

virtual void	customEvent (QEvent *event)

virtual void	disconnectNotify (const QMetaMethod &signalMethod) const

bool	isSignalConnected (const QMetaMethod &signalMethod) const

int	receivers (const QString &signal) const

QObject *	sender () const

int	senderSignalIndex () const

virtual void	timerEvent (QTimerEvent *event)

Related Functions inherited from QObject
T	qobject_cast (QObject *object)

	QObjectList

Detailed Description

The QStandardItemModel class is used to store data as defined by the software model/view paradigm. The data in a QStandardItemModel is added by first creating a QStandardItem and then passing it to the model by calling one of the append methods. This model can be used with any of the view classes like QListView, QTableView, QTreeView or any third party custom view classes.

Usage

When using a QStandardItemModel for a list or tree view construct an empty model and use appendRow() to add items to the model.

If the data will be displayed in a table it may be helpful to pass the dimensions of the table to the QStandardItemModel constructor and then use setItem() to add a QStandardItem.

The setRowCount() and setColumnCount() methods can be used to alter the dimensions of the model. To insert items use insertRow() or insertColumn(). To remove items use removeRow() or removeColumn(). Call clear() to remove all items from the model.

The headers labels in a the model are set by using setHorizontalHeaderLabels() or setVerticalHeaderLabels(). You can search for items in the model with findItems() and sort the model by calling sort().

Example

The following is an example showing how to use QStandardItemModel to create a table view.

QStandardItemModel model(4, 4);
 
for (int row = 0; row < 4; ++row) {
 
  for (int column = 0; column < 4; ++column) {
      QStandardItem *item = new QStandardItem(QString("row %0, column %1").formatArg(row).formatArg(column));
      model.setItem(row, column, item);
  }
 
}

The following is an example showing how to use QStandardItemModel to create a tree view.

QStandardItemModel model;
QStandardItem *parentItem = model.invisibleRootItem();
 
for (int i = 0; i < 4; ++i) {
    QStandardItem *item = new QStandardItem(QString("item %0").formatArg(i));
    parentItem->appendRow(item);
    parentItem = item;
}

Model Indexes

After calling setModel() on a view and passing the model, typically you will want to configure the view to handle user actions such as an item being clicked. Handling these actions usually requires obtaining the QModelIndex to find the QStandardItem. The methods itemFromIndex() and indexFromItem() provide functionality to convert between the model index and an item.

In the following example a connection is set up between the signal from the view to a slot in your class. When the signal is emitted the model index will be passed to the your slot. From the slot method call the itemFromIndex() to obtain a pointer to the item which clicked.

{
   QTreeView *treeView = new QTreeView(this);
   treeView->setModel(myStandardItemModel);
 
   connect(treeView, SIGNAL(clicked(QModelIndex)), this, SLOT(clicked(QModelIndex)));
}
 
 
// slot implementation
void MyWidget::clicked(const QModelIndex &index)
{
   QStandardItem *item = myStandardItemModel->itemFromIndex(index);
 
   // ...
}

See also: QStandardItem, QAbstractItemModel, Model/View Architecture

Constructor & Destructor Documentation

QStandardItemModel::QStandardItemModel ( QObject * parent = nullptr )

explicit

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 the given number of rows and columns with the given parent.

QStandardItemModel::~QStandardItemModel ( )

Destroys the model and all of its items.

Method Documentation

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: insertColumn(), appendRow()

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: insertRow(), appendColumn()

void QStandardItemModel::appendRow ( QStandardItem * item )

inline

When building a list or a tree that has only one column, this method provides a convenient way to append a single new item.

void QStandardItemModel::clear ( )

Removes all items and header items from the model and sets the number of rows and columns to zero.

See also: removeColumns(), removeRows()

int QStandardItemModel::columnCount ( const QModelIndex & parent = QModelIndex() ) const

overridevirtual

See also: setColumnCount()

Implements QAbstractItemModel::columnCount()

QVariant QStandardItemModel::data	(	const QModelIndex &	index,
		int	role = `Qt::DisplayRole`
	)		const

overridevirtual

See also: setData()

Implements QAbstractItemModel::data()

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

overridevirtual

Reimplemented from QAbstractItemModel::dropMimeData()

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.

Qt::ItemFlags QStandardItemModel::flags ( const QModelIndex & index ) const

overridevirtual

Reimplemented from QAbstractItemModel::flags()

bool QStandardItemModel::hasChildren ( const QModelIndex & parent = QModelIndex() ) const

overridevirtual

Reimplemented from QAbstractItemModel::hasChildren()

QVariant QStandardItemModel::headerData	(	int	section,
		Qt::Orientation	orientation,
		int	role = `Qt::DisplayRole`
	)		const

overridevirtual

See also: setHeaderData()

Reimplemented from QAbstractItemModel::headerData()

QStandardItem * QStandardItemModel::horizontalHeaderItem ( int column ) const

Returns the horizontal header item for column if one has been set, otherwise returns a nullptr.

See also: setHorizontalHeaderItem(), verticalHeaderItem()

QModelIndex QStandardItemModel::index	(	int	row,
		int	column,
		const QModelIndex &	parent = `QModelIndex()`
	)		const

overridevirtual

Implements QAbstractItemModel::index()

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

Returns the QModelIndex associated with the given item. Use this method when performing an operation which requires a QModelIndex.

See also: itemFromIndex(), QStandardItem::index()

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: takeColumn(), appendColumn(), insertRow()

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

inline

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: insertColumns(), insertRow(), removeColumn()

bool QStandardItemModel::insertColumns	(	int	column,
		int	count,
		const QModelIndex &	parent = `QModelIndex()`
	)

overridevirtual

Reimplemented from QAbstractItemModel::insertColumns()

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: takeRow(), appendRow(), insertColumn()

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

inline

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: insertRows(), insertColumn(), removeRow()

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

inline

Inserts a row at row containing item. When building a list or a tree that has only one column, this method provides a convenient way to append a single new item.

bool QStandardItemModel::insertRows	(	int	row,
		int	count,
		const QModelIndex &	parent = `QModelIndex()`
	)

overridevirtual

Reimplemented from QAbstractItemModel::insertRows()

QStandardItem * QStandardItemModel::invisibleRootItem ( ) const

Returns the model's invisible root item. The invisible root item is the parent for all visible top level itmes.

Note: Calling index() on this root item 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 a nullptr.

See also: setItem(), takeItem(), itemFromIndex()

void QStandardItemModel::itemChanged ( QStandardItem * item )

signal

This signal is emitted every time the data for item changes.

QMap< int, QVariant > QStandardItemModel::itemData ( const QModelIndex & index ) const

overridevirtual

See also: setItemData()

Reimplemented from QAbstractItemModel::itemData()

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

Returns a pointer to the QStandardItem associated with the given index. If index is invalid this method returns a nullptr.

See also: indexFromItem()

const QStandardItem * QStandardItemModel::itemPrototype ( ) const

Returns a blank item. The model makes a copy of this item prototype when it needs to construct new items.

See also: setItemPrototype()

QMimeData * QStandardItemModel::mimeData ( const QModelIndexList & indexes ) const

overridevirtual

Reimplemented from QAbstractItemModel::mimeData()

QStringList QStandardItemModel::mimeTypes ( ) const

overridevirtual

Reimplemented from QAbstractItemModel::mimeTypes()

QObject * QObject::parent ( ) const

using

Returns a pointer to the parent object.

See also: setParent(), children()

QModelIndex QStandardItemModel::parent ( const QModelIndex & child ) const

overridevirtual

Implements QAbstractItemModel::parent()

bool QStandardItemModel::removeColumns	(	int	column,
		int	count,
		const QModelIndex &	parent = `QModelIndex()`
	)

overridevirtual

Reimplemented from QAbstractItemModel::removeColumns()

bool QStandardItemModel::removeRows	(	int	row,
		int	count,
		const QModelIndex &	parent = `QModelIndex()`
	)

overridevirtual

Reimplemented from QAbstractItemModel::removeRows()

int QStandardItemModel::rowCount ( const QModelIndex & parent = QModelIndex() ) const

overridevirtual

See also: setRowCount()

Implements QAbstractItemModel::rowCount()

void QStandardItemModel::setColumnCount ( int columns )

Sets the number of columns in this model to columns. If this is less than columnCount() the data in the unwanted columns is discarded.

See also: columnCount(), setRowCount()

bool QStandardItemModel::setData	(	const QModelIndex &	index,
		const QVariant &	value,
		int	role = `Qt::EditRole`
	)

overridevirtual

See also: data()

Reimplemented from QAbstractItemModel::setData()

bool QStandardItemModel::setHeaderData	(	int	section,
		Qt::Orientation	orientation,
		const QVariant &	value,
		int	role = `Qt::EditRole`
	)

overridevirtual

See also: headerData()

Reimplemented from QAbstractItemModel::setHeaderData()

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 is deleted.

See also: horizontalHeaderItem(), setHorizontalHeaderLabels(), setVerticalHeaderItem()

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: setHorizontalHeaderItem()

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 is deleted.

See also: item()

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

inline

Sets the item for the given row 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 is deleted.

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

overridevirtual

See also: itemData()

Reimplemented from QAbstractItemModel::setItemData()

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 is used to create new items by calling the QStandardItem::clone() method. To provide a custom prototype inherit from QStandardItem and reimplement QStandardItem::clone().

See also: itemPrototype(), QStandardItem::clone()

void QStandardItemModel::setItemRoleNames ( const QMultiHash< int, QString > & 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 rowCount() the data in the unwanted rows is discarded.

See also: rowCount(), setColumnCount()

void QStandardItemModel::setSortRole ( int role )

Sets the value of the property to role.

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 is deleted.

See also: verticalHeaderItem(), setVerticalHeaderLabels(), setHorizontalHeaderItem()

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: setVerticalHeaderItem()

void QStandardItemModel::sort	(	int	column,
		Qt::SortOrder	order = `Qt::AscendingOrder`
	)

overridevirtual

Reimplemented from QAbstractItemModel::sort()

int QStandardItemModel::sortRole ( ) const

Returns the value of the property.

Qt::DropActions QStandardItemModel::supportedDropActions ( ) const

overridevirtual

QStandardItemModel supports both copy and move.

Reimplemented from QAbstractItemModel::supportedDropActions()

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

Removes the given column without deleting the column items. 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 a nullptr.

See also: takeRow()

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: horizontalHeaderItem(), takeVerticalHeaderItem()

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: item(), takeRow(), takeColumn()

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 a nullptr.

See also: takeColumn()

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: verticalHeaderItem(), takeHorizontalHeaderItem()

QStandardItem * QStandardItemModel::verticalHeaderItem ( int row ) const

Returns the vertical header item for the given row if one has been set, otherwise returns a nullptr.

See also: setVerticalHeaderItem(), horizontalHeaderItem()

Property Documentation

QStandardItemModel::sortRole

This property holds the item role that is used to query the model's data when sorting items.

The default value is Qt::DisplayRole.

See also: sort(), QStandardItem::sortChildren()

Properties	Class Methods
read	sortRole
write	setSortRole

Public Signals

Public Methods

Properties

Friends

Additional Inherited Members

Detailed Description

Usage

Example

Model Indexes

Constructor & Destructor Documentation

Method Documentation

Property Documentation