QStandardItem¶
The
QStandardItem
class provides an item for use with theQStandardItemModel
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
isTristate
()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
setTristate
(tristate)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¶
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 withbackground()
. The text label for each item can be rendered with its own font and brush. These are specified with thesetFont()
andsetForeground()
functions, and read withfont()
andforeground()
.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 thesetCheckState()
function. The correspondingcheckState()
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()
andsetColumnCount()
. Items can be positioned in the child table withsetChild()
. Get a pointer to a child item withchild()
. New rows and columns of children can also be inserted withinsertRow()
andinsertColumn()
, or appended withappendRow()
andappendColumn()
. 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()
ortakeRow()
; correspondingly, a column can be removed withremoveColumn()
ortakeColumn()
.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. Thetype()
function should be reimplemented to return a new type value equal to or greater thanUserType
.Reimplement
data()
andsetData()
if you want to perform custom handling of data queries and/or control how an item’s data is represented.Reimplement
clone()
if you wantQStandardItemModel
to be able to create instances of your custom item class on demand (seesetItemPrototype()
).Reimplement
read()
andwrite()
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 withsortChildren()
or withsort()
.
- class PySide2.QtGui.QStandardItem¶
PySide2.QtGui.QStandardItem(icon, text)
PySide2.QtGui.QStandardItem(other)
PySide2.QtGui.QStandardItem(text)
PySide2.QtGui.QStandardItem(rows[, columns=1])
- param columns:
int
- param rows:
int
- param icon:
- param other:
- param text:
str
Constructs an item.
Constructs an item with
rows
rows andcolumns
columns of child items.
- PySide2.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
- PySide2.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).
- PySide2.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).
- PySide2.QtGui.QStandardItem.appendColumn(items)¶
- Parameters:
items –
Appends a column containing
items
. If necessary, the row count is increased to the size ofitems
.See also
- PySide2.QtGui.QStandardItem.appendRow(item)¶
- Parameters:
item –
PySide2.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.
- PySide2.QtGui.QStandardItem.appendRow(items)
- Parameters:
items –
- PySide2.QtGui.QStandardItem.appendRows(items)¶
- Parameters:
items –
Appends rows containing
items
. The column count will not change.See also
- PySide2.QtGui.QStandardItem.background()¶
- Return type:
Returns the brush used to render the item’s background.
See also
- PySide2.QtGui.QStandardItem.checkState()¶
- Return type:
Returns the checked state of the item.
See also
- PySide2.QtGui.QStandardItem.child(row[, column=0])¶
- Parameters:
row – int
column – int
- Return type:
Returns the child item at (
row
,column
) if one has been set; otherwise returnsNone
.See also
- PySide2.QtGui.QStandardItem.clearData()¶
Removes all the data from all roles previously set.
- PySide2.QtGui.QStandardItem.clone()¶
- Return type:
Returns a copy of this item. The item’s children are not copied.
When subclassing
QStandardItem
, you can reimplement this function to provideQStandardItemModel
with a factory that it can use to create new items on demand.See also
setItemPrototype()
operator=()
- PySide2.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.
- PySide2.QtGui.QStandardItem.columnCount()¶
- Return type:
int
Returns the number of child item columns that the item has.
See also
- PySide2.QtGui.QStandardItem.data([role=Qt.UserRole + 1])¶
- Parameters:
role – int
- Return type:
object
Returns the item’s data for the given
role
, or an invalidQVariant
if there is no data for the role.Note
The default implementation treats
EditRole
andDisplayRole
as referring to the same data.See also
- PySide2.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 reimplementeddata()
and/orsetData()
.See also
- PySide2.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
- PySide2.QtGui.QStandardItem.font()¶
- Return type:
Returns the font used to render the item’s text.
See also
- PySide2.QtGui.QStandardItem.foreground()¶
- Return type:
Returns the brush used to render the item’s foreground (e.g. text).
See also
- PySide2.QtGui.QStandardItem.hasChildren()¶
- Return type:
bool
Returns
true
if this item has any children; otherwise returnsfalse
.See also
- PySide2.QtGui.QStandardItem.icon()¶
- Return type:
Returns the item’s icon.
See also
setIcon()
iconSize
- PySide2.QtGui.QStandardItem.index()¶
- Return type:
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
- PySide2.QtGui.QStandardItem.insertColumn(column, items)¶
- Parameters:
column – int
items –
Inserts a column at
column
containingitems
. If necessary, the row count is increased to the size ofitems
.See also
- PySide2.QtGui.QStandardItem.insertColumns(column, count)¶
- Parameters:
column – int
count – int
Inserts
count
columns of child items at columncolumn
.See also
- PySide2.QtGui.QStandardItem.insertRow(row, item)¶
- Parameters:
row – int
item –
PySide2.QtGui.QStandardItem
This is an overloaded function.
Inserts a row at
row
containingitem
.When building a list or a tree that has only one column, this function provides a convenient way to insert a single new item.
- PySide2.QtGui.QStandardItem.insertRow(row, items)
- Parameters:
row – int
items –
- PySide2.QtGui.QStandardItem.insertRows(row, items)¶
- Parameters:
row – int
items –
- PySide2.QtGui.QStandardItem.insertRows(row, count)
- Parameters:
row – int
count – int
Inserts
count
rows of child items at rowrow
.See also
- PySide2.QtGui.QStandardItem.isAutoTristate()¶
- Return type:
bool
Returns whether the item is tristate and is controlled by
QTreeWidget
.The default value is false.
See also
- PySide2.QtGui.QStandardItem.isCheckable()¶
- Return type:
bool
Returns whether the item is user-checkable.
The default value is false.
- PySide2.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
- PySide2.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
- PySide2.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
- PySide2.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()
andisSelectable()
.The default value is true.
See also
- PySide2.QtGui.QStandardItem.isSelectable()¶
- Return type:
bool
Returns whether the item is selectable by the user.
The default value is true.
See also
- PySide2.QtGui.QStandardItem.isTristate()¶
- Return type:
bool
Note
This function is deprecated.
Use
isAutoTristate()
instead. For a tristate checkbox that the user can change between all three states, useisUserTristate()
instead.
- PySide2.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
- PySide2.QtGui.QStandardItem.model()¶
- Return type:
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
- PySide2.QtGui.QStandardItem.parent()¶
- Return type:
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 useinvisibleRootItem()
instead.See also
- PySide2.QtGui.QStandardItem.read(in)¶
- Parameters:
Reads the item from stream
in
. Only the data and flags of the item are read, not the child items.See also
- PySide2.QtGui.QStandardItem.removeColumn(column)¶
- Parameters:
column – int
Removes the given
column
. The items that were in the column are deleted.See also
- PySide2.QtGui.QStandardItem.removeColumns(column, count)¶
- Parameters:
column – int
count – int
Removes
count
columns at columncolumn
. The items that were in those columns are deleted.See also
- PySide2.QtGui.QStandardItem.removeRow(row)¶
- Parameters:
row – int
Removes the given
row
. The items that were in the row are deleted.See also
- PySide2.QtGui.QStandardItem.removeRows(row, count)¶
- Parameters:
row – int
count – int
Removes
count
rows at rowrow
. The items that were in those rows are deleted.See also
- PySide2.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.
- PySide2.QtGui.QStandardItem.rowCount()¶
- Return type:
int
Returns the number of child item rows that the item has.
See also
- PySide2.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).
- PySide2.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).
- PySide2.QtGui.QStandardItem.setAutoTristate(tristate)¶
- Parameters:
tristate – bool
Determines that the item is tristate and controlled by
QTreeWidget
iftristate
istrue
. This enables automatic management of the state of parent items inQTreeWidget
(checked if all children are checked, unchecked if all children are unchecked, or partially checked if only some children are checked).
- PySide2.QtGui.QStandardItem.setBackground(brush)¶
- Parameters:
brush –
PySide2.QtGui.QBrush
Sets the item’s background brush to the specified
brush
.See also
- PySide2.QtGui.QStandardItem.setCheckState(checkState)¶
- Parameters:
checkState –
CheckState
Sets the check state of the item to be
state
.See also
- PySide2.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.
- PySide2.QtGui.QStandardItem.setChild(row, column, item)¶
- Parameters:
row – int
column – int
item –
PySide2.QtGui.QStandardItem
Sets the child item at (
row
,column
) toitem
. This item (the parent item) takes ownership ofitem
. If necessary, the row count and column count are increased to fit the item.Note
Passing
None
asitem
removes the item.See also
- PySide2.QtGui.QStandardItem.setChild(row, item)
- Parameters:
row – int
item –
PySide2.QtGui.QStandardItem
This is an overloaded function.
Sets the child at
row
toitem
.
- PySide2.QtGui.QStandardItem.setColumnCount(columns)¶
- Parameters:
columns – int
Sets the number of child item columns to
columns
. If this is less thancolumnCount()
, the data in the unwanted columns is discarded.See also
- PySide2.QtGui.QStandardItem.setData(value[, role=Qt.UserRole + 1])¶
- Parameters:
value – object
role – int
Sets the item’s data for the given
role
to the specifiedvalue
.If you subclass
QStandardItem
and reimplement this function, your reimplementation should callemitDataChanged()
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
andDisplayRole
as referring to the same data.See also
ItemDataRole
data()
setFlags()
- PySide2.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
- PySide2.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; seesupportedDropActions()
.See also
- PySide2.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
- PySide2.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; ifenabled
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()
- PySide2.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.
- PySide2.QtGui.QStandardItem.setFont(font)¶
- Parameters:
font –
PySide2.QtGui.QFont
Sets the font used to display the item’s text to the given
font
.See also
- PySide2.QtGui.QStandardItem.setForeground(brush)¶
- Parameters:
brush –
PySide2.QtGui.QBrush
Sets the brush used to display the item’s foreground (e.g. text) to the given
brush
.See also
- PySide2.QtGui.QStandardItem.setIcon(icon)¶
- Parameters:
icon –
PySide2.QtGui.QIcon
Sets the item’s icon to the
icon
specified.See also
- PySide2.QtGui.QStandardItem.setRowCount(rows)¶
- Parameters:
rows – int
Sets the number of child item rows to
rows
. If this is less thanrowCount()
, the data in the unwanted rows is discarded.See also
- PySide2.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
andselectionBehavior
.See also
- PySide2.QtGui.QStandardItem.setSizeHint(sizeHint)¶
- Parameters:
sizeHint –
PySide2.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
- PySide2.QtGui.QStandardItem.setStatusTip(statusTip)¶
- Parameters:
statusTip – str
Sets the item’s status tip to the string specified by
statusTip
.See also
- PySide2.QtGui.QStandardItem.setText(text)¶
- Parameters:
text – str
Sets the item’s text to the
text
specified.See also
- PySide2.QtGui.QStandardItem.setTextAlignment(textAlignment)¶
- Parameters:
textAlignment –
Alignment
Sets the text alignment for the item’s text to the
alignment
specified.See also
- PySide2.QtGui.QStandardItem.setToolTip(toolTip)¶
- Parameters:
toolTip – str
Sets the item’s tooltip to the string specified by
toolTip
.See also
- PySide2.QtGui.QStandardItem.setTristate(tristate)¶
- Parameters:
tristate – bool
Note
This function is deprecated.
Use
setAutoTristate
(bool tristate) instead. For a tristate checkbox that the user can change between all three states, usesetUserTristate
(bool tristate) instead.See also
- PySide2.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; seeisCheckable()
.)
- PySide2.QtGui.QStandardItem.setWhatsThis(whatsThis)¶
- Parameters:
whatsThis – str
Sets the item’s “What’s This?” help to the string specified by
whatsThis
.See also
- PySide2.QtGui.QStandardItem.sizeHint()¶
- Return type:
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
- PySide2.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 givencolumn
.Note
This function is recursive, therefore it sorts the children of the item, its grandchildren, etc.
See also
operator
- PySide2.QtGui.QStandardItem.statusTip()¶
- Return type:
str
Returns the item’s status tip.
See also
- PySide2.QtGui.QStandardItem.takeChild(row[, column=0])¶
- Parameters:
row – int
column – int
- Return type:
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 returnsNone
.Note that this function, unlike
takeRow()
andtakeColumn()
, does not affect the dimensions of the child table.See also
- PySide2.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 beNone
.See also
- PySide2.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 beNone
.See also
- PySide2.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
- PySide2.QtGui.QStandardItem.textAlignment()¶
- Return type:
Alignment
Returns the text alignment for the item’s text.
See also
- PySide2.QtGui.QStandardItem.toolTip()¶
- Return type:
str
Returns the item’s tooltip.
See also
- PySide2.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 toUserType
.See also
Type
- PySide2.QtGui.QStandardItem.whatsThis()¶
- Return type:
str
Returns the item’s “What’s This?” help.
See also
- PySide2.QtGui.QStandardItem.write(out)¶
- Parameters:
Writes the item to stream
out
. Only the data and flags of the item are written, not the child items.See also
© 2022 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.