The QStandardItem class provides an item for use with the QStandardItemModel class. More...

#include <qstandarditemmodel.h>

Inheritance diagram for QStandardItem:

Collaboration diagram for QStandardItem:

Public Types
enum	ItemType { Type = 0 , UserType = 1000 }

Public Member Functions
	QStandardItem ()

	QStandardItem (const QString &text)

	QStandardItem (const QIcon &icon, const QString &text)

	QStandardItem (int rows, int columns=1)

virtual	~QStandardItem ()

virtual QVariant	data (int role=Qt::UserRole+1) const

virtual void	multiData (QModelRoleDataSpan roleDataSpan) const

virtual void	setData (const QVariant &value, int role=Qt::UserRole+1)

void	clearData ()

QString	text () const

void	setText (const QString &text)

QIcon	icon () const

void	setIcon (const QIcon &icon)

QString	toolTip () const

void	setToolTip (const QString &toolTip)

QString	statusTip () const

void	setStatusTip (const QString &statusTip)

QSize	sizeHint () const

void	setSizeHint (const QSize &sizeHint)

QFont	font () const

void	setFont (const QFont &font)

Qt::Alignment	textAlignment () const

void	setTextAlignment (Qt::Alignment textAlignment)

QBrush	background () const

void	setBackground (const QBrush &brush)

QBrush	foreground () const

void	setForeground (const QBrush &brush)

Qt::CheckState	checkState () const

void	setCheckState (Qt::CheckState checkState)

QString	accessibleText () const

void	setAccessibleText (const QString &accessibleText)

QString	accessibleDescription () const

void	setAccessibleDescription (const QString &accessibleDescription)

Qt::ItemFlags	flags () const

void	setFlags (Qt::ItemFlags flags)

bool	isEnabled () const

void	setEnabled (bool enabled)

bool	isEditable () const

void	setEditable (bool editable)

bool	isSelectable () const

void	setSelectable (bool selectable)

bool	isCheckable () const

void	setCheckable (bool checkable)

bool	isAutoTristate () const

void	setAutoTristate (bool tristate)

bool	isUserTristate () const

void	setUserTristate (bool tristate)

QStandardItem *	parent () const

int	row () const

int	column () const

QModelIndex	index () const

QStandardItemModel *	model () const

int	rowCount () const

void	setRowCount (int rows)

int	columnCount () const

void	setColumnCount (int columns)

bool	hasChildren () const

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

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

void	setChild (int row, QStandardItem *item)

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

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

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

void	insertRows (int row, int count)

void	insertColumns (int column, int count)

void	removeRow (int row)

void	removeColumn (int column)

void	removeRows (int row, int count)

void	removeColumns (int column, int count)

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

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

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

void	insertRow (int row, QStandardItem *item)

void	appendRow (QStandardItem *item)

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

QList< QStandardItem * >	takeRow (int row)

QList< QStandardItem * >	takeColumn (int column)

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

virtual QStandardItem *	clone () const

virtual int	type () const

virtual void	read (QDataStream &in)

virtual void	write (QDataStream &out) const

virtual bool	operator< (const QStandardItem &other) const

Protected Member Functions
	QStandardItem (const QStandardItem &other)

	QStandardItem (QStandardItemPrivate &dd)

QStandardItem &	operator= (const QStandardItem &other)

void	emitDataChanged ()

Protected Attributes
QScopedPointer< QStandardItemPrivate >	d_ptr

Friends
class	QStandardItemModelPrivate

class	QStandardItemModel

Related Functions
(Note that these are not member functions.)
QDataStream &	operator>> (QDataStream &in, QStandardItem &item)

QDataStream &	operator<< (QDataStream &out, const QStandardItem &item)

Detailed Description

The QStandardItem class provides an item for use with the QStandardItemModel class.

Since: 4.2

\inmodule QtGui

Items usually contain text, icons, or checkboxes.

Each item can have its own background brush which is set with the setBackground() function. The current background brush can be found with background(). The text label for each item can be rendered with its own font and brush. These are specified with the setFont() and setForeground() functions, and read with font() and foreground().

By default, items are enabled, editable, selectable, checkable, and can be used both as the source of a drag and drop operation and as a drop target. Each item's flags can be changed by calling setFlags(). Checkable items can be checked and unchecked with the setCheckState() function. The corresponding checkState() function indicates whether the item is currently checked.

You can store application-specific data in an item by calling setData().

Each item can have a two-dimensional table of child items. This makes it possible to build hierarchies of items. The typical hierarchy is the tree, in which case the child table is a table with a single column (a list).

The dimensions of the child table can be set with setRowCount() and setColumnCount(). Items can be positioned in the child table with setChild(). Get a pointer to a child item with child(). New rows and columns of children can also be inserted with insertRow() and insertColumn(), or appended with appendRow() and appendColumn(). When using the append and insert functions, the dimensions of the child table will grow as needed.

An existing row of children can be removed with removeRow() or takeRow(); correspondingly, a column can be removed with removeColumn() or takeColumn().

An item's children can be sorted by calling sortChildren().

Definition at line 59 of file qstandarditemmodel.h.

Member Enumeration Documentation

◆ ItemType

enum QStandardItem::ItemType

This enum describes the types that are used to describe standard items.

\value Type The default type for standard items. \value UserType The minimum value for custom types. Values below UserType are reserved by Qt.

You can define new user types in QStandardItem subclasses to ensure that custom items are treated specially; for example, when items are sorted.

See also: type()

Enumerator
Type
UserType

Definition at line 228 of file qstandarditemmodel.h.

Constructor & Destructor Documentation

◆ QStandardItem() [1/6]

QStandardItem::QStandardItem ( )

Constructs an item.

Definition at line 802 of file qstandarditemmodel.cpp.

Here is the caller graph for this function:

◆ QStandardItem() [2/6]

QStandardItem::QStandardItem ( const QString & text )

explicit

Constructs an item with the given text.

Definition at line 810 of file qstandarditemmodel.cpp.

Here is the call graph for this function:

◆ QStandardItem() [3/6]

QStandardItem::QStandardItem	(	const QIcon &	icon,
		const QString &	text
	)

Constructs an item with the given icon and text.

Definition at line 819 of file qstandarditemmodel.cpp.

Here is the call graph for this function:

◆ QStandardItem() [4/6]

QStandardItem::QStandardItem	(	int	rows,
		int	columns = `1`
	)

explicit

Constructs an item with rows rows and columns columns of child items.

Definition at line 828 of file qstandarditemmodel.cpp.

Here is the call graph for this function:

◆ ~QStandardItem()

QStandardItem::~QStandardItem ( )

virtual

Destructs the item. This causes the item's children to be destructed as well.

Definition at line 876 of file qstandarditemmodel.cpp.

Here is the call graph for this function:

◆ QStandardItem() [5/6]

QStandardItem::QStandardItem ( const QStandardItem & other )

protected

Constructs a copy of other. Note that model() is not copied.

This function is useful when reimplementing clone().

Definition at line 851 of file qstandarditemmodel.cpp.

Here is the call graph for this function:

◆ QStandardItem() [6/6]

QStandardItem::QStandardItem ( QStandardItemPrivate & dd )

protected

Definition at line 838 of file qstandarditemmodel.cpp.

Member Function Documentation

◆ accessibleDescription()

QString QStandardItem::accessibleDescription ( ) const

inline

Returns the item's accessible description.

The accessible description is used by assistive technologies (i.e. for users who cannot use conventional means of interaction).

See also: setAccessibleDescription(), accessibleText()

Definition at line 137 of file qstandarditemmodel.h.

◆ accessibleText()

QString QStandardItem::accessibleText ( ) const

inline

Returns the item's accessible text.

The accessible text is used by assistive technologies (i.e. for users who cannot use conventional means of interaction).

See also: setAccessibleText(), accessibleDescription()

Definition at line 132 of file qstandarditemmodel.h.

◆ appendColumn()

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

inline

Appends a column containing items. If necessary, the row count is increased to the size of items.

See also: insertColumn()

Definition at line 303 of file qstandarditemmodel.h.

Here is the caller graph for this function:

◆ appendRow() [1/2]

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

inline

Appends a row containing items. If necessary, the column count is increased to the size of items.

See also: insertRow()

Definition at line 297 of file qstandarditemmodel.h.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ appendRow() [2/2]

void QStandardItem::appendRow ( QStandardItem * item )

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

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

Definition at line 309 of file qstandarditemmodel.h.

Here is the call graph for this function:

◆ appendRows()

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

inline

Appends rows containing items. The column count will not change.

See also: insertRow()

Definition at line 300 of file qstandarditemmodel.h.

◆ background()

QBrush QStandardItem::background ( ) const

inline

Returns the brush used to render the item's background.

See also: foreground(), setBackground()

Definition at line 117 of file qstandarditemmodel.h.

◆ checkState()

Qt::CheckState QStandardItem::checkState ( ) const

inline

Returns the checked state of the item.

See also: setCheckState(), isCheckable()

Definition at line 127 of file qstandarditemmodel.h.

◆ child()

QStandardItem * QStandardItem::child	(	int	row,
		int	column = `0`
	)		const

Returns the child item at (row, column) if one has been set; otherwise returns \nullptr.

See also: setChild(), takeChild(), parent()

Definition at line 1871 of file qstandarditemmodel.cpp.

Here is the caller graph for this function:

◆ clearData()

void QStandardItem::clearData ( )

Since: 5.12 Removes all the data from all roles previously set.

See also: data(), setData()

Definition at line 950 of file qstandarditemmodel.cpp.

Here is the caller graph for this function:

◆ clone()

QStandardItem * QStandardItem::clone ( ) const

virtual

Returns a copy of this item. The item's children are not copied.

When subclassing QStandardItem, you can reimplement this function to provide QStandardItemModel with a factory that it can use to create new items on demand.

See also: QStandardItemModel::setItemPrototype(), operator=()

Reimplemented in CustomItem, and CustomItem.

Definition at line 2048 of file qstandarditemmodel.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ column()

int QStandardItem::column ( ) const

Returns the column where the item is located in its parent's child table, or -1 if the item has no parent.

See also: row(), parent()

Definition at line 1521 of file qstandarditemmodel.cpp.

Here is the caller graph for this function:

◆ columnCount()

int QStandardItem::columnCount ( ) const

Returns the number of child item columns that the item has.

See also: setColumnCount(), rowCount()

Definition at line 1610 of file qstandarditemmodel.cpp.

Here is the caller graph for this function:

◆ data()

QVariant QStandardItem::data ( int role = Qt::UserRole + 1 ) const

virtual

Returns the item's data for the given role, or an invalid QVariant if there is no data for the role.

Note: The default implementation treats Qt::EditRole and Qt::DisplayRole as referring to the same data.

Definition at line 967 of file qstandarditemmodel.cpp.

Here is the caller graph for this function:

◆ emitDataChanged()

void QStandardItem::emitDataChanged ( )

protected

Since: 4.4

Causes the model associated with this item to emit a \l{QAbstractItemModel::dataChanged()}{dataChanged}() signal for this item.

You normally only need to call this function if you have subclassed QStandardItem and reimplemented data() and/or setData().

See also: setData()

Definition at line 1006 of file qstandarditemmodel.cpp.

◆ flags()

Qt::ItemFlags QStandardItem::flags ( ) const

Returns the item flags for the item.

The item flags determine how the user can interact with the item.

By default, items are enabled, editable, selectable, checkable, and can be used both as the source of a drag and drop operation and as a drop target.

See also: setFlags()

Definition at line 1036 of file qstandarditemmodel.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ font()

QFont QStandardItem::font ( ) const

inline

Returns the font used to render the item's text.

See also: setFont()

Definition at line 107 of file qstandarditemmodel.h.

Here is the caller graph for this function:

◆ foreground()

QBrush QStandardItem::foreground ( ) const

inline

Returns the brush used to render the item's foreground (e.g. text).

See also: setForeground(), background()

Definition at line 122 of file qstandarditemmodel.h.

◆ hasChildren()

bool QStandardItem::hasChildren ( ) const

Returns true if this item has any children; otherwise returns false.

See also: rowCount(), columnCount(), child()

Definition at line 1838 of file qstandarditemmodel.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ icon()

QIcon QStandardItem::icon ( ) const

inline

Returns the item's icon.

See also: setIcon(), {QAbstractItemView::iconSize}{iconSize}

Definition at line 78 of file qstandarditemmodel.h.

Here is the caller graph for this function:

◆ index()

QModelIndex QStandardItem::index ( ) const

Returns the QModelIndex associated with this item.

When you need to invoke item functionality in a QModelIndex-based API (e.g. QAbstractItemView), you can call this function to obtain an index that corresponds to the item's location in the model.

If the item is not associated with a model, an invalid QModelIndex is returned.

See also: model(), QStandardItemModel::itemFromIndex()

Definition at line 1540 of file qstandarditemmodel.cpp.

Here is the caller graph for this function:

◆ insertColumn()

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

Definition at line 1651 of file qstandarditemmodel.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ insertColumns()

void QStandardItem::insertColumns	(	int	column,
		int	count
	)

Inserts count columns of child items at column column.

See also: insertColumn(), insertRows()

Definition at line 1681 of file qstandarditemmodel.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ insertRow() [1/2]

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

Definition at line 1622 of file qstandarditemmodel.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ insertRow() [2/2]

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

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

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 insert a single new item.

Definition at line 306 of file qstandarditemmodel.h.

Here is the call graph for this function:

◆ insertRows() [1/2]

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

Inserts items at row. The column count won't be changed.

See also: insertRow(), insertColumn()

Definition at line 1637 of file qstandarditemmodel.cpp.

Here is the caller graph for this function:

◆ insertRows() [2/2]

void QStandardItem::insertRows	(	int	row,
		int	count
	)

Inserts count rows of child items at row row.

See also: insertRow(), insertColumns()

Definition at line 1666 of file qstandarditemmodel.cpp.

Here is the call graph for this function:

◆ isAutoTristate()

bool QStandardItem::isAutoTristate ( ) const

inline

Returns whether the item is tristate and is controlled by QTreeWidget.

The default value is false.

Since: 5.6

See also: setAutoTristate(), isCheckable(), checkState()

Definition at line 165 of file qstandarditemmodel.h.

◆ isCheckable()

bool QStandardItem::isCheckable ( ) const

inline

Returns whether the item is user-checkable.

The default value is false.

See also: setCheckable(), checkState(), isUserTristate(), isAutoTristate()

Definition at line 160 of file qstandarditemmodel.h.

Here is the caller graph for this function:

◆ isEditable()

bool QStandardItem::isEditable ( ) const

inline

Returns whether the item can be edited by the user.

When an item is editable (and enabled), the user can edit the item by invoking one of the view's edit triggers; see QAbstractItemView::editTriggers.

The default value is true.

See also: setEditable(), flags()

Definition at line 150 of file qstandarditemmodel.h.

◆ isEnabled()

bool QStandardItem::isEnabled ( ) const

inline

Returns whether the item is enabled.

When an item is enabled, the user can interact with it. The possible types of interaction are specified by the other item flags, such as isEditable() and isSelectable().

The default value is true.

See also: setEnabled(), flags()

Definition at line 145 of file qstandarditemmodel.h.

◆ isSelectable()

bool QStandardItem::isSelectable ( ) const

inline

Returns whether the item is selectable by the user.

The default value is true.

See also: setSelectable(), flags()

Definition at line 155 of file qstandarditemmodel.h.

◆ isUserTristate()

bool QStandardItem::isUserTristate ( ) const

inline

Since: 5.6

Returns whether the item is tristate; that is, if it's checkable with three separate states and the user can cycle through all three states.

The default value is false.

See also: setUserTristate(), isCheckable(), checkState()

Definition at line 170 of file qstandarditemmodel.h.

◆ model()

QStandardItemModel * QStandardItem::model ( ) const

Returns the QStandardItemModel that this item belongs to.

If the item is not a child of another item that belongs to the model, this function returns \nullptr.

See also: index()

Definition at line 1554 of file qstandarditemmodel.cpp.

Here is the caller graph for this function:

◆ multiData()

void QStandardItem::multiData ( QModelRoleDataSpan roleDataSpan ) const

virtual

Since: 6.0

Fills the roleDataSpan span with the data from this item.

The default implementation simply calls data() for each role in the span.

See also: data()

Definition at line 988 of file qstandarditemmodel.cpp.

Here is the call graph for this function:

◆ operator<()

bool QStandardItem::operator< ( const QStandardItem & other ) const

virtual

Returns true if this item is less than other; otherwise returns false.

The default implementation uses the data for the item's sort role (see QStandardItemModel::sortRole) to perform the comparison if the item belongs to a model; otherwise, the data for the item's Qt::DisplayRole (text()) is used to perform the comparison.

sortChildren() and QStandardItemModel::sort() use this function when sorting items. If you want custom sorting, you can subclass QStandardItem and reimplement this function.

Reimplemented in CustomItem.

Definition at line 2007 of file qstandarditemmodel.cpp.

Here is the call graph for this function:

◆ operator=()

QStandardItem & QStandardItem::operator= ( const QStandardItem & other )

protected

Assigns other's data and flags to this item. Note that type() and model() are not copied.

This function is useful when reimplementing clone().

Definition at line 865 of file qstandarditemmodel.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ parent()

QStandardItem * QStandardItem::parent ( ) const

Returns the item's parent item, or \nullptr if the item has no parent.

Note: For toplevel items parent() returns \nullptr. To receive toplevel item's parent use QStandardItemModel::invisibleRootItem() instead.

See also: child(), QStandardItemModel::invisibleRootItem()

Definition at line 896 of file qstandarditemmodel.cpp.

Here is the caller graph for this function:

◆ read()

void QStandardItem::read ( QDataStream & in )

virtual

Reads the item from stream in. Only the data and flags of the item are read, not the child items.

See also: write()

Definition at line 2074 of file qstandarditemmodel.cpp.

Here is the call graph for this function:

◆ removeColumn()

void QStandardItem::removeColumn ( int column )

Removes the given column. The items that were in the column are deleted.

See also: takeColumn(), removeColumns(), removeRow()

Definition at line 1773 of file qstandarditemmodel.cpp.

Here is the call graph for this function:

◆ removeColumns()

void QStandardItem::removeColumns	(	int	column,
		int	count
	)

Removes count columns at column column. The items that were in those columns are deleted.

See also: removeColumn(), removeRows()

Definition at line 1811 of file qstandarditemmodel.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ removeRow()

void QStandardItem::removeRow ( int row )

Removes the given row. The items that were in the row are deleted.

See also: takeRow(), removeRows(), removeColumn()

Definition at line 1762 of file qstandarditemmodel.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ removeRows()

void QStandardItem::removeRows	(	int	row,
		int	count
	)

Removes count rows at row row. The items that were in those rows are deleted.

See also: removeRow(), removeColumn()

Definition at line 1784 of file qstandarditemmodel.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ row()

int QStandardItem::row ( ) const

Returns the row where the item is located in its parent's child table, or -1 if the item has no parent.

See also: column(), parent()

Definition at line 1508 of file qstandarditemmodel.cpp.

Here is the caller graph for this function:

◆ rowCount()

int QStandardItem::rowCount ( ) const

Returns the number of child item rows that the item has.

See also: setRowCount(), columnCount()

Definition at line 1582 of file qstandarditemmodel.cpp.

Here is the caller graph for this function:

◆ setAccessibleDescription()

void QStandardItem::setAccessibleDescription ( const QString & accessibleDescription )

inline

Sets the item's accessible description to the string specified by accessibleDescription.

The accessible description is used by assistive technologies (i.e. for users who cannot use conventional means of interaction).

See also: accessibleDescription(), setAccessibleText()

Definition at line 291 of file qstandarditemmodel.h.

Here is the call graph for this function:

◆ setAccessibleText()

void QStandardItem::setAccessibleText ( const QString & accessibleText )

inline

Sets the item's accessible text to the string specified by accessibleText.

The accessible text is used by assistive technologies (i.e. for users who cannot use conventional means of interaction).

See also: accessibleText(), setAccessibleDescription()

Definition at line 288 of file qstandarditemmodel.h.

Here is the call graph for this function:

◆ setAutoTristate()

void QStandardItem::setAutoTristate ( bool tristate )

Determines that the item is tristate and controlled by QTreeWidget if tristate is true. This enables automatic management of the state of parent items in QTreeWidget (checked if all children are checked, unchecked if all children are unchecked, or partially checked if only some children are checked).

Since: 5.6

See also: isAutoTristate(), setCheckable(), setCheckState()

Definition at line 1398 of file qstandarditemmodel.cpp.

◆ setBackground()

void QStandardItem::setBackground ( const QBrush & brush )

inline

Sets the item's background brush to the specified brush.

See also: background(), setForeground()

Definition at line 279 of file qstandarditemmodel.h.

Here is the call graph for this function:

◆ setCheckable()

void QStandardItem::setCheckable ( bool checkable )

Sets whether the item is user-checkable. If checkable is true, the item can be checked by the user; otherwise, the user cannot check the item.

The item delegate will render a checkable item with a check box next to the item's text.

See also: isCheckable(), setCheckState(), setUserTristate(), setAutoTristate()

Definition at line 1367 of file qstandarditemmodel.cpp.

Here is the call graph for this function:

◆ setCheckState()

void QStandardItem::setCheckState ( Qt::CheckState state )

inline

Sets the check state of the item to be state.

See also: checkState(), setCheckable()

Definition at line 285 of file qstandarditemmodel.h.

Here is the call graph for this function:

◆ setChild() [1/2]

void QStandardItem::setChild	(	int	row,
		int	column,
		QStandardItem *	item
	)

Sets the child item at (row, column) to item. This item (the parent item) takes ownership of item. If necessary, the row count and column count are increased to fit the item.

Note: Passing \nullptr as item removes the item.

See also: child()

Definition at line 1852 of file qstandarditemmodel.cpp.

◆ setChild() [2/2]

void QStandardItem::setChild	(	int	row,
		QStandardItem *	item
	)

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Sets the child at row to item.

Definition at line 294 of file qstandarditemmodel.h.

◆ setColumnCount()

void QStandardItem::setColumnCount ( int columns )

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

See also: columnCount(), setRowCount()

Definition at line 1594 of file qstandarditemmodel.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setData()

void QStandardItem::setData	(	const QVariant &	value,
		int	role = `Qt::UserRole + 1`
	)

virtual

Sets the item's data for the given role to the specified value.

If you subclass QStandardItem and reimplement this function, your reimplementation should call emitDataChanged() if you do not call the base implementation of setData(). This will ensure that e.g. views using the model are notified of the changes.

Note: The default implementation treats Qt::EditRole and Qt::DisplayRole as referring to the same data.

See also: Qt::ItemDataRole, data(), setFlags()

Definition at line 917 of file qstandarditemmodel.cpp.

Here is the caller graph for this function:

◆ setEditable()

void QStandardItem::setEditable ( bool editable )

Sets whether the item is editable. If editable is true, the item can be edited by the user; otherwise, the user cannot edit the item.

How the user can edit items in a view is determined by the view's edit triggers; see QAbstractItemView::editTriggers.

See also: isEditable(), setFlags()

Definition at line 1311 of file qstandarditemmodel.cpp.

◆ setEnabled()

void QStandardItem::setEnabled ( bool enabled )

Sets whether the item is enabled. If enabled is true, the item is enabled, meaning that the user can interact with the item; if enabled is false, the user cannot interact with the item.

This flag takes precedence over the other item flags; e.g. if an item is not enabled, it cannot be selected by the user, even if the Qt::ItemIsSelectable flag has been set.

See also: isEnabled(), Qt::ItemIsEnabled, setFlags()

Definition at line 1282 of file qstandarditemmodel.cpp.

◆ setFlags()

void QStandardItem::setFlags ( Qt::ItemFlags flags )

Sets the item flags for the item to flags.

The item flags determine how the user can interact with the item. This is often used to disable an item.

See also: flags(), setData()

Definition at line 1021 of file qstandarditemmodel.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setFont()

void QStandardItem::setFont ( const QFont & font )

inline

Sets the font used to display the item's text to the given font.

See also: font(), setText(), setForeground()

Definition at line 273 of file qstandarditemmodel.h.

Here is the call graph for this function:

◆ setForeground()

void QStandardItem::setForeground ( const QBrush & brush )

inline

Sets the brush used to display the item's foreground (e.g. text) to the given brush.

See also: foreground(), setBackground(), setFont()

Definition at line 282 of file qstandarditemmodel.h.

Here is the call graph for this function:

◆ setIcon()

void QStandardItem::setIcon ( const QIcon & icon )

inline

Sets the item's icon to the icon specified.

Definition at line 254 of file qstandarditemmodel.h.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setRowCount()

void QStandardItem::setRowCount ( int rows )

Sets the number of child item rows to rows. If this is less than rowCount(), the data in the unwanted rows is discarded.

See also: rowCount(), setColumnCount()

Definition at line 1566 of file qstandarditemmodel.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setSelectable()

void QStandardItem::setSelectable ( bool selectable )

Sets whether the item is selectable. If selectable is true, the item can be selected by the user; otherwise, the user cannot select the item.

You can control the selection behavior and mode by manipulating their view properties; see QAbstractItemView::selectionMode and QAbstractItemView::selectionBehavior.

See also: isSelectable(), setFlags()

Definition at line 1341 of file qstandarditemmodel.cpp.

◆ setSizeHint()

void QStandardItem::setSizeHint ( const QSize & size )

inline

Sets the size hint for the item to be size. If no size hint is set, the item delegate will compute the size hint based on the item data.

See also: sizeHint()

Definition at line 270 of file qstandarditemmodel.h.

Here is the call graph for this function:

◆ setStatusTip()

void QStandardItem::setStatusTip ( const QString & statusTip )

inline

Sets the item's status tip to the string specified by statusTip.

See also: statusTip(), setToolTip(), setWhatsThis()

Definition at line 261 of file qstandarditemmodel.h.

Here is the call graph for this function:

◆ setText()

void QStandardItem::setText ( const QString & text )

inline

Sets the item's text to the text specified.

See also: text(), setFont(), setForeground()

Definition at line 251 of file qstandarditemmodel.h.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setTextAlignment()

void QStandardItem::setTextAlignment ( Qt::Alignment alignment )

inline

Sets the text alignment for the item's text to the alignment specified.

See also: textAlignment()

Definition at line 276 of file qstandarditemmodel.h.

Here is the call graph for this function:

◆ setToolTip()

void QStandardItem::setToolTip ( const QString & toolTip )

inline

Sets the item's tooltip to the string specified by toolTip.

See also: toolTip(), setStatusTip(), setWhatsThis()

Definition at line 257 of file qstandarditemmodel.h.

Here is the call graph for this function:

◆ setUserTristate()

void QStandardItem::setUserTristate ( bool tristate )

Sets whether the item is tristate and controlled by the user. If tristate is true, the user can cycle through three separate states; otherwise, the item is checkable with two states. (Note that this also requires that the item is checkable; see isCheckable().)

Since: 5.6

See also: isUserTristate(), setCheckable(), setCheckState()

Definition at line 1424 of file qstandarditemmodel.cpp.

◆ sizeHint()

QSize QStandardItem::sizeHint ( ) const

inline

Returns the size hint set for the item, or an invalid QSize if no size hint has been set.

If no size hint has been set, the item delegate will compute the size hint based on the item data.

See also: setSizeHint()

Definition at line 102 of file qstandarditemmodel.h.

◆ sortChildren()

void QStandardItem::sortChildren	(	int	column,
		Qt::SortOrder	order = `Qt::AscendingOrder`
	)

Sorts the children of the item using the given order, by the values in the given column.

Note: This function is recursive, therefore it sorts the children of the item, its grandchildren, etc.

See also: {operator<()}

Definition at line 2023 of file qstandarditemmodel.cpp.

Here is the call graph for this function:

◆ statusTip()

QString QStandardItem::statusTip ( ) const

inline

Returns the item's status tip.

See also: setStatusTip(), toolTip(), whatsThis()

Definition at line 89 of file qstandarditemmodel.h.

◆ takeChild()

QStandardItem * QStandardItem::takeChild	(	int	row,
		int	column = `0`
	)

Removes the child item at (row, column) without deleting it, and returns a pointer to the item. If there was no child at the given location, then this function returns \nullptr.

Note that this function, unlike takeRow() and takeColumn(), does not affect the dimensions of the child table.

See also: child(), takeRow(), takeColumn()

Definition at line 1890 of file qstandarditemmodel.cpp.

Here is the call graph for this function:

◆ takeColumn()

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

Removes column without deleting the column items, and returns a list of pointers to the removed items. For items in the column that have not been set, the corresponding pointers in the list will be \nullptr.

See also: removeColumn(), insertColumn(), takeRow()

Definition at line 1970 of file qstandarditemmodel.cpp.

Here is the call graph for this function:

◆ takeRow()

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

Removes row without deleting the row items, and returns a list of pointers to the removed items. For items in the row that have not been set, the corresponding pointers in the list will be \nullptr.

See also: removeRow(), insertRow(), takeColumn()

Definition at line 1936 of file qstandarditemmodel.cpp.

Here is the call graph for this function:

◆ text()

QString QStandardItem::text ( ) const

inline

Returns the item's text. This is the text that's presented to the user in a view.

See also: setText()

Definition at line 73 of file qstandarditemmodel.h.

Here is the caller graph for this function:

◆ textAlignment()

int QStandardItem::textAlignment ( ) const

inline

Returns the text alignment for the item's text.

Definition at line 112 of file qstandarditemmodel.h.

◆ toolTip()

QString QStandardItem::toolTip ( ) const

inline

Returns the item's tooltip.

See also: setToolTip(), statusTip(), whatsThis()

Definition at line 83 of file qstandarditemmodel.h.

◆ type()

int QStandardItem::type ( ) const

virtual

Returns the type of this item. The type is used to distinguish custom items from the base class. When subclassing QStandardItem, you should reimplement this function and return a new value greater than or equal to \l UserType.

See also: QStandardItem::Type

Reimplemented in CustomItem, CustomItem, CustomItem, and CustomItem.

Definition at line 2061 of file qstandarditemmodel.cpp.

◆ write()

void QStandardItem::write ( QDataStream & out ) const

virtual

Writes the item to stream out. Only the data and flags of the item are written, not the child items.

See also: read()

Definition at line 2089 of file qstandarditemmodel.cpp.

Here is the call graph for this function:

Friends And Related Function Documentation

◆ operator<<()

QDataStream & operator<<	(	QDataStream &	out,
		const QStandardItem &	item
	)

Since: 4.2

Writes the QStandardItem item to stream out.

This operator uses QStandardItem::write().

See also: {Serializing Qt Data Types}

Definition at line 2122 of file qstandarditemmodel.cpp.

◆ operator>>()

QDataStream & operator>>	(	QDataStream &	in,
		QStandardItem &	item
	)

Since: 4.2

Reads a QStandardItem from stream in into item.

This operator uses QStandardItem::read().

See also: {Serializing Qt Data Types}

Definition at line 2106 of file qstandarditemmodel.cpp.

◆ QStandardItemModel

friend class QStandardItemModel

friend

Definition at line 248 of file qstandarditemmodel.h.

◆ QStandardItemModelPrivate

friend class QStandardItemModelPrivate

friend

Definition at line 247 of file qstandarditemmodel.h.

Member Data Documentation

◆ d_ptr

QScopedPointer<QStandardItemPrivate> QStandardItem::d_ptr

protected

Definition at line 241 of file qstandarditemmodel.h.

The documentation for this class was generated from the following files:

src/gui/itemmodels/qstandarditemmodel.h
src/gui/itemmodels/qstandarditemmodel.cpp

Public Types

Public Member Functions

Protected Member Functions

Protected Attributes

Friends

Related Functions

Detailed Description

Member Enumeration Documentation

◆ ItemType

Constructor & Destructor Documentation

◆ QStandardItem() [1/6]

◆ QStandardItem() [2/6]

◆ QStandardItem() [3/6]

◆ QStandardItem() [4/6]

◆ ~QStandardItem()

◆ QStandardItem() [5/6]

◆ QStandardItem() [6/6]

Member Function Documentation

◆ accessibleDescription()

◆ accessibleText()

◆ appendColumn()

◆ appendRow() [1/2]

◆ appendRow() [2/2]

◆ appendRows()

◆ background()

◆ checkState()

◆ child()

◆ clearData()

◆ clone()

◆ column()

◆ columnCount()

◆ data()

◆ emitDataChanged()

◆ flags()

◆ font()

◆ foreground()

◆ hasChildren()

◆ icon()

◆ index()

◆ insertColumn()

◆ insertColumns()

◆ insertRow() [1/2]

◆ insertRow() [2/2]

◆ insertRows() [1/2]

◆ insertRows() [2/2]

◆ isAutoTristate()

◆ isCheckable()

◆ isEditable()

◆ isEnabled()

◆ isSelectable()

◆ isUserTristate()

◆ model()

◆ multiData()

◆ operator<()

◆ operator=()

◆ parent()

◆ read()

◆ removeColumn()

◆ removeColumns()

◆ removeRow()

◆ removeRows()

◆ row()

◆ rowCount()

◆ setAccessibleDescription()

◆ setAccessibleText()

◆ setAutoTristate()

◆ setBackground()

◆ setCheckable()

◆ setCheckState()

◆ setChild() [1/2]

◆ setChild() [2/2]

◆ setColumnCount()

◆ setData()

◆ setEditable()

◆ setEnabled()

◆ setFlags()

◆ setFont()

◆ setForeground()

◆ setIcon()

◆ setRowCount()