QStandardItem

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

Synopsis

Functions

• def accessibleDescription ()

• def accessibleText ()

• def appendColumn (items)

• def appendRow (item)

• def appendRow (items)

• def appendRows (items)

• def background ()

• def checkState ()

• def child (row[, column=0])

• def clearData ()

• def column ()

• def columnCount ()

• def emitDataChanged ()

• def flags ()

• def font ()

• def foreground ()

• def hasChildren ()

• def icon ()

• def index ()

• def insertColumn (column, items)

• def insertColumns (column, count)

• def insertRow (row, item)

• def insertRow (row, items)

• def insertRows (row, count)

• def insertRows (row, items)

• def isAutoTristate ()

• def isCheckable ()

• def isDragEnabled ()

• def isDropEnabled ()

• def isEditable ()

• def isEnabled ()

• def isSelectable ()

• def isUserTristate ()

• def model ()

• def parent ()

• def removeColumn (column)

• def removeColumns (column, count)

• def removeRow (row)

• def removeRows (row, count)

• def row ()

• def rowCount ()

• def setAccessibleDescription (accessibleDescription)

• def setAccessibleText (accessibleText)

• def setAutoTristate (tristate)

• def setBackground (brush)

• def setCheckState (checkState)

• def setCheckable (checkable)

• def setChild (row, column, item)

• def setChild (row, item)

• def setColumnCount (columns)

• def setDragEnabled (dragEnabled)

• def setDropEnabled (dropEnabled)

• def setEditable (editable)

• def setEnabled (enabled)

• def setFlags (flags)

• def setFont (font)

• def setForeground (brush)

• def setIcon (icon)

• def setRowCount (rows)

• def setSelectable (selectable)

• def setSizeHint (sizeHint)

• def setStatusTip (statusTip)

• def setText (text)

• def setTextAlignment (textAlignment)

• def setToolTip (toolTip)

• def setUserTristate (tristate)

• def setWhatsThis (whatsThis)

• def sizeHint ()

• def sortChildren (column[, order=Qt.AscendingOrder])

• def statusTip ()

• def takeChild (row[, column=0])

• def takeColumn (column)

• def takeRow (row)

• def text ()

• def textAlignment ()

• def toolTip ()

• def whatsThis ()

Virtual functions

• def clone ()

• def data ([role=Qt.UserRole + 1])

• def read (in)

• def setData (value[, role=Qt.UserRole + 1])

• def type ()

• def write (out)

Detailed Description

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

Subclassing

When subclassing QStandardItem to provide custom items, it is possible to define new types for them so that they can be distinguished from the base class. The type() function should be reimplemented to return a new type value equal to or greater than UserType .

Reimplement data() and setData() if you want to perform custom handling of data queries and/or control how an item’s data is represented.

Reimplement clone() if you want QStandardItemModel to be able to create instances of your custom item class on demand (see setItemPrototype() ).

Reimplement read() and write() if you want to control how items are represented in their serialized form.

Reimplement operator if you want to control the semantics of item comparison. operator determines the sorted order when sorting items with sortChildren() or with sort() .

See also

QStandardItemModel Item View Convenience Classes Model/View Programming

class PySide6.QtGui.QStandardItem

PySide6.QtGui.QStandardItem(icon, text)

PySide6.QtGui.QStandardItem(other)

PySide6.QtGui.QStandardItem(text)

PySide6.QtGui.QStandardItem(rows[, columns=1])

Parameters

• icon – PySide6.QtGui.QIcon

• other – PySide6.QtGui.QStandardItem

• text – str

• rows – int

• columns – int

Constructs an item.

Constructs an item with the given icon and text.

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

This function is useful when reimplementing clone() .

Constructs an item with the given text.

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

PySide6.QtGui.QStandardItem.ItemType

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

Constant	Description
QStandardItem.Type	The default type for standard items.
QStandardItem.UserType	The minimum value for custom types. Values below 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()

PySide6.QtGui.QStandardItem.accessibleDescription()

Return type

str

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

PySide6.QtGui.QStandardItem.accessibleText()

Return type

str

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

PySide6.QtGui.QStandardItem.appendColumn(items)

Parameters

items –

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

See also

insertColumn()

PySide6.QtGui.QStandardItem.appendRow(item)

Parameters

item – PySide6.QtGui.QStandardItem

This is an overloaded function.

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.

PySide6.QtGui.QStandardItem.appendRow(items)

Parameters

items –

PySide6.QtGui.QStandardItem.appendRows(items)

Parameters

items –

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

See also

insertRow()

PySide6.QtGui.QStandardItem.background()

Return type

PySide6.QtGui.QBrush

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

See also

foreground() setBackground()

PySide6.QtGui.QStandardItem.checkState()

Return type

CheckState

Returns the checked state of the item.

See also

setCheckState() isCheckable()

PySide6.QtGui.QStandardItem.child(row[, column=0])

Parameters

• row – int

• column – int

Return type

PySide6.QtGui.QStandardItem

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

See also

setChild() takeChild() parent()

PySide6.QtGui.QStandardItem.clearData()

Removes all the data from all roles previously set.

See also

data() setData()

PySide6.QtGui.QStandardItem.clone()

Return type

PySide6.QtGui.QStandardItem

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

setItemPrototype() operator=()

PySide6.QtGui.QStandardItem.column()

Return type

int

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

PySide6.QtGui.QStandardItem.columnCount()

Return type

int

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

See also

setColumnCount() rowCount()

PySide6.QtGui.QStandardItem.data([role=Qt.UserRole + 1])

Parameters

role – int

Return type

object

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 EditRole and DisplayRole as referring to the same data.

See also

setData()

PySide6.QtGui.QStandardItem.emitDataChanged()

Causes the model associated with this item to emit a 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()

PySide6.QtGui.QStandardItem.flags()

Return type

ItemFlags

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

PySide6.QtGui.QStandardItem.font()

Return type

PySide6.QtGui.QFont

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

See also

setFont()

PySide6.QtGui.QStandardItem.foreground()

Return type

PySide6.QtGui.QBrush

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

See also

setForeground() background()

PySide6.QtGui.QStandardItem.hasChildren()

Return type

bool

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

See also

rowCount() columnCount() child()

PySide6.QtGui.QStandardItem.icon()

Return type

PySide6.QtGui.QIcon

Returns the item’s icon.

See also

setIcon() iconSize

PySide6.QtGui.QStandardItem.index()

Return type

PySide6.QtCore.QModelIndex

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

PySide6.QtGui.QStandardItem.insertColumn(column, items)

Parameters

• column – int

• items –

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

See also

insertColumns() insertRow()

PySide6.QtGui.QStandardItem.insertColumns(column, count)

Parameters

• column – int

• count – int

Inserts count columns of child items at column column.

See also

insertColumn() insertRows()

PySide6.QtGui.QStandardItem.insertRow(row, item)

Parameters

• row – int

• item – PySide6.QtGui.QStandardItem

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

PySide6.QtGui.QStandardItem.insertRow(row, items)

Parameters

• row – int

• items –

PySide6.QtGui.QStandardItem.insertRows(row, items)

Parameters

• row – int

• items –

PySide6.QtGui.QStandardItem.insertRows(row, count)

Parameters

• row – int

• count – int

Inserts count rows of child items at row row.

See also

insertRow() insertColumns()

PySide6.QtGui.QStandardItem.isAutoTristate()

Return type

bool

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

The default value is false.

See also

setAutoTristate() isCheckable() checkState()

PySide6.QtGui.QStandardItem.isCheckable()

Return type

bool

Returns whether the item is user-checkable.

The default value is false.

See also

setCheckable() checkState() isUserTristate() isAutoTristate()

PySide6.QtGui.QStandardItem.isDragEnabled()

Return type

bool

Returns whether the item is drag enabled. An item that is drag enabled can be dragged by the user.

The default value is true.

Note that item dragging must be enabled in the view for dragging to work; see dragEnabled .

See also

setDragEnabled() isDropEnabled() flags()

PySide6.QtGui.QStandardItem.isDropEnabled()

Return type

bool

Returns whether the item is drop enabled. When an item is drop enabled, it can be used as a drop target.

The default value is true.

See also

setDropEnabled() isDragEnabled() flags()

PySide6.QtGui.QStandardItem.isEditable()

Return type

bool

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 editTriggers .

The default value is true.

See also

setEditable() flags()

PySide6.QtGui.QStandardItem.isEnabled()

Return type

bool

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

PySide6.QtGui.QStandardItem.isSelectable()

Return type

bool

Returns whether the item is selectable by the user.

The default value is true.

See also

setSelectable() flags()

PySide6.QtGui.QStandardItem.isUserTristate()

Return type

bool

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

PySide6.QtGui.QStandardItem.model()

Return type

PySide6.QtGui.QStandardItemModel

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 None.

See also

index()

PySide6.QtGui.QStandardItem.parent()

Return type

PySide6.QtGui.QStandardItem

Returns the item’s parent item, or None if the item has no parent.

Note

For toplevel items returns None. To receive toplevel item’s parent use invisibleRootItem() instead.

See also

child() invisibleRootItem()

PySide6.QtGui.QStandardItem.read(in)

Parameters

in – PySide6.QtCore.QDataStream

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

See also

write()

PySide6.QtGui.QStandardItem.removeColumn(column)

Parameters

column – int

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

See also

takeColumn() removeColumns() removeRow()

PySide6.QtGui.QStandardItem.removeColumns(column, count)

Parameters

• column – int

• count – int

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

See also

removeColumn() removeRows()

PySide6.QtGui.QStandardItem.removeRow(row)

Parameters

row – int

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

See also

takeRow() removeRows() removeColumn()

PySide6.QtGui.QStandardItem.removeRows(row, count)

Parameters

• row – int

• count – int

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

See also

removeRow() removeColumn()

PySide6.QtGui.QStandardItem.row()

Return type

int

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

PySide6.QtGui.QStandardItem.rowCount()

Return type

int

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

See also

setRowCount() columnCount()

PySide6.QtGui.QStandardItem.setAccessibleDescription(accessibleDescription)

Parameters

accessibleDescription – str

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

PySide6.QtGui.QStandardItem.setAccessibleText(accessibleText)

Parameters

accessibleText – str

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

PySide6.QtGui.QStandardItem.setAutoTristate(tristate)

Parameters

tristate – bool

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).

See also

isAutoTristate() setCheckable() setCheckState()

PySide6.QtGui.QStandardItem.setBackground(brush)

Parameters

brush – PySide6.QtGui.QBrush

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

See also

background() setForeground()

PySide6.QtGui.QStandardItem.setCheckState(checkState)

Parameters

checkState – CheckState

Sets the check state of the item to be state.

See also

checkState() setCheckable()

PySide6.QtGui.QStandardItem.setCheckable(checkable)

Parameters

checkable – bool

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

PySide6.QtGui.QStandardItem.setChild(row, column, item)

Parameters

• row – int

• column – int

• item – PySide6.QtGui.QStandardItem

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 None as item removes the item.

See also

child()

PySide6.QtGui.QStandardItem.setChild(row, item)

Parameters

• row – int

• item – PySide6.QtGui.QStandardItem

This is an overloaded function.

Sets the child at row to item.

PySide6.QtGui.QStandardItem.setColumnCount(columns)

Parameters

columns – int

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

PySide6.QtGui.QStandardItem.setData(value[, role=Qt.UserRole + 1])

Parameters

• value – object

• role – int

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 . This will ensure that e.g. views using the model are notified of the changes.

Note

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

See also

ItemDataRole data() setFlags()

PySide6.QtGui.QStandardItem.setDragEnabled(dragEnabled)

Parameters

dragEnabled – bool

Sets whether the item is drag enabled. If dragEnabled is true, the item can be dragged by the user; otherwise, the user cannot drag the item.

Note that you also need to ensure that item dragging is enabled in the view; see dragEnabled .

See also

isDragEnabled() setDropEnabled() setFlags()

PySide6.QtGui.QStandardItem.setDropEnabled(dropEnabled)

Parameters

dropEnabled – bool

Sets whether the item is drop enabled. If dropEnabled is true, the item can be used as a drop target; otherwise, it cannot.

Note that you also need to ensure that drops are enabled in the view; see acceptDrops() ; and that the model supports the desired drop actions; see supportedDropActions() .

See also

isDropEnabled() setDragEnabled() setFlags()

PySide6.QtGui.QStandardItem.setEditable(editable)

Parameters

editable – bool

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 editTriggers .

See also

isEditable() setFlags()

PySide6.QtGui.QStandardItem.setEnabled(enabled)

Parameters

enabled – bool

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 ItemIsSelectable flag has been set.

See also

isEnabled() ItemIsEnabled setFlags()

PySide6.QtGui.QStandardItem.setFlags(flags)

Parameters

flags – ItemFlags

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

PySide6.QtGui.QStandardItem.setFont(font)

Parameters

font – PySide6.QtGui.QFont

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

See also

font() setText() setForeground()

PySide6.QtGui.QStandardItem.setForeground(brush)

Parameters

brush – PySide6.QtGui.QBrush

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

See also

foreground() setBackground() setFont()

PySide6.QtGui.QStandardItem.setIcon(icon)

Parameters

icon – PySide6.QtGui.QIcon

Sets the item’s icon to the icon specified.

See also

icon()

PySide6.QtGui.QStandardItem.setRowCount(rows)

Parameters

rows – int

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

PySide6.QtGui.QStandardItem.setSelectable(selectable)

Parameters

selectable – bool

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 selectionMode and selectionBehavior .

See also

isSelectable() setFlags()

PySide6.QtGui.QStandardItem.setSizeHint(sizeHint)

Parameters

sizeHint – PySide6.QtCore.QSize

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

PySide6.QtGui.QStandardItem.setStatusTip(statusTip)

Parameters

statusTip – str

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

See also

statusTip() setToolTip() setWhatsThis()

PySide6.QtGui.QStandardItem.setText(text)

Parameters

text – str

Sets the item’s text to the text specified.

See also

text() setFont() setForeground()

PySide6.QtGui.QStandardItem.setTextAlignment(textAlignment)

Parameters

textAlignment – Alignment

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

See also

textAlignment()

PySide6.QtGui.QStandardItem.setToolTip(toolTip)

Parameters

toolTip – str

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

See also

toolTip() setStatusTip() setWhatsThis()

PySide6.QtGui.QStandardItem.setUserTristate(tristate)

Parameters

tristate – bool

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

See also

isUserTristate() setCheckable() setCheckState()

PySide6.QtGui.QStandardItem.setWhatsThis(whatsThis)

Parameters

whatsThis – str

Sets the item’s “What’s This?” help to the string specified by whatsThis.

See also

whatsThis() setStatusTip() setToolTip()

PySide6.QtGui.QStandardItem.sizeHint()

Return type

PySide6.QtCore.QSize

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

PySide6.QtGui.QStandardItem.sortChildren(column[, order=Qt.AscendingOrder])

Parameters

• column – int

• order – SortOrder

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

PySide6.QtGui.QStandardItem.statusTip()

Return type

str

Returns the item’s status tip.

See also

setStatusTip() toolTip() whatsThis()

PySide6.QtGui.QStandardItem.takeChild(row[, column=0])

Parameters

• row – int

• column – int

Return type

PySide6.QtGui.QStandardItem

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 None.

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

See also

child() takeRow() takeColumn()

PySide6.QtGui.QStandardItem.takeColumn(column)

Parameters

column – int

Return type

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 None.

See also

removeColumn() insertColumn() takeRow()

PySide6.QtGui.QStandardItem.takeRow(row)

Parameters

row – int

Return type

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 None.

See also

removeRow() insertRow() takeColumn()

PySide6.QtGui.QStandardItem.text()

Return type

str

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

See also

setText()

PySide6.QtGui.QStandardItem.textAlignment()

Return type

Alignment

Returns the text alignment for the item’s text.

See also

setTextAlignment()

PySide6.QtGui.QStandardItem.toolTip()

Return type

str

Returns the item’s tooltip.

See also

setToolTip() statusTip() whatsThis()

PySide6.QtGui.QStandardItem.type()

Return type

int

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 UserType .

See also

Type

PySide6.QtGui.QStandardItem.whatsThis()

Return type

str

Returns the item’s “What’s This?” help.

See also

setWhatsThis() toolTip() statusTip()

PySide6.QtGui.QStandardItem.write(out)

Parameters

out – PySide6.QtCore.QDataStream

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

See also

read()