QStandardItem ¶

函数 ¶

虚函数 ¶

子类化 ¶

当子类化 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() .

另请参阅

QStandardItemModel 项视图方便类 模型/视图编程

class QStandardItem ¶

QStandardItem(icon, text)

QStandardItem(other)

QStandardItem(text)

QStandardItem(rows[, columns=1])

param columns

int

param rows

int

param icon

QIcon

param other

QStandardItem

param text

unicode

Constructs an item.

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

PySide2.QtGui.QStandardItem. ItemType ¶

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

常量	描述
QStandardItem.Type	The default type for standard items.
QStandardItem.UserType	The minimum value for custom types. Values below are reserved by Qt.

可以定义新用户类型在 QStandardItem 子类以确保自定义项得到特殊处理；例如，当排序项时。

另请参阅

type()

PySide2.QtGui.QStandardItem. accessibleDescription ( ) ¶

返回类型

unicode

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

另请参阅

setAccessibleDescription() accessibleText()

PySide2.QtGui.QStandardItem. accessibleText ( ) ¶

返回类型

unicode

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

另请参阅

setAccessibleText() accessibleDescription()

PySide2.QtGui.QStandardItem. appendColumn ( items ) ¶

参数

items –

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

另请参阅

insertColumn()

PySide2.QtGui.QStandardItem. appendRow ( item ) ¶

参数

item – QStandardItem

这是重载函数。

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

参数

items –

PySide2.QtGui.QStandardItem. appendRows ( items ) ¶

参数

items –

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

另请参阅

insertRow()

PySide2.QtGui.QStandardItem. background ( ) ¶

返回类型

QBrush

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

另请参阅

foreground() setBackground()

PySide2.QtGui.QStandardItem. checkState ( ) ¶

返回类型

CheckState

Returns the checked state of the item.

另请参阅

setCheckState() isCheckable()

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

参数

• row – int

• column – int

返回类型

QStandardItem

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

另请参阅

setChild() takeChild() parent()

PySide2.QtGui.QStandardItem. clearData ( ) ¶

Removes all the data from all roles previously set.

另请参阅

data() setData()

PySide2.QtGui.QStandardItem. clone ( ) ¶

返回类型

QStandardItem

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

当子类化 QStandardItem , you can reimplement this function to provide QStandardItemModel with a factory that it can use to create new items on demand.

另请参阅

setItemPrototype() operator=()

PySide2.QtGui.QStandardItem. column ( ) ¶

返回类型

int

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

另请参阅

row() parent()

PySide2.QtGui.QStandardItem. columnCount ( ) ¶

返回类型

int

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

另请参阅

setColumnCount() rowCount()

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

参数

role – int

返回类型

object

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

注意

默认实现视 EditRole and DisplayRole 为引用相同数据。

另请参阅

setData()

PySide2.QtGui.QStandardItem. emitDataChanged ( ) ¶

促使关联此项的模型发射 dataChanged () 信号对于此项。

通常只需调用此函数若有子类化 QStandardItem 和重实现 data() and/or setData() .

另请参阅

setData()

PySide2.QtGui.QStandardItem. flags ( ) ¶

返回类型

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.

另请参阅

setFlags()

PySide2.QtGui.QStandardItem. font ( ) ¶

返回类型

QFont

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

另请参阅

setFont()

PySide2.QtGui.QStandardItem. foreground ( ) ¶

返回类型

QBrush

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

另请参阅

setForeground() background()

PySide2.QtGui.QStandardItem. hasChildren ( ) ¶

返回类型

bool

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

另请参阅

rowCount() columnCount() child()

PySide2.QtGui.QStandardItem. icon ( ) ¶

返回类型

QIcon

Returns the item’s icon.

另请参阅

setIcon() iconSize

PySide2.QtGui.QStandardItem. index ( ) ¶

返回类型

QModelIndex

返回 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 被返回。

另请参阅

model() itemFromIndex()

PySide2.QtGui.QStandardItem. insertColumn ( column , items ) ¶

参数

• column – int

• items –

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

另请参阅

insertColumns() insertRow()

PySide2.QtGui.QStandardItem. insertColumns ( column , count ) ¶

参数

• column – int

• count – int

插入 count columns of child items at column column .

另请参阅

insertColumn() insertRows()

PySide2.QtGui.QStandardItem. insertRow ( row , item ) ¶

参数

• row – int

• item – QStandardItem

这是重载函数。

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.

PySide2.QtGui.QStandardItem. insertRow ( row , items ) ¶

参数

• row – int

• items –

PySide2.QtGui.QStandardItem. insertRows ( row , items ) ¶

参数

• row – int

• items –

PySide2.QtGui.QStandardItem. insertRows ( row , count ) ¶

参数

• row – int

• count – int

插入 count rows of child items at row row .

另请参阅

insertRow() insertColumns()

PySide2.QtGui.QStandardItem. isAutoTristate ( ) ¶

返回类型

bool

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

默认值为 false。

另请参阅

setAutoTristate() isCheckable() checkState()

PySide2.QtGui.QStandardItem. isCheckable ( ) ¶

返回类型

bool

Returns whether the item is user-checkable.

默认值为 false。

另请参阅

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

PySide2.QtGui.QStandardItem. isDragEnabled ( ) ¶

返回类型

bool

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

默认值为 true。

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

另请参阅

setDragEnabled() isDropEnabled() flags()

PySide2.QtGui.QStandardItem. isDropEnabled ( ) ¶

返回类型

bool

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

默认值为 true。

另请参阅

setDropEnabled() isDragEnabled() flags()

PySide2.QtGui.QStandardItem. isEditable ( ) ¶

返回类型

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 .

默认值为 true。

另请参阅

setEditable() flags()

PySide2.QtGui.QStandardItem. isEnabled ( ) ¶

返回类型

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

默认值为 true。

另请参阅

setEnabled() flags()

PySide2.QtGui.QStandardItem. isSelectable ( ) ¶

返回类型

bool

Returns whether the item is selectable by the user.

默认值为 true。

另请参阅

setSelectable() flags()

PySide2.QtGui.QStandardItem. isTristate ( ) ¶

返回类型

bool

注意

此函数被弃用。

使用 isAutoTristate() instead. For a tristate checkbox that the user can change between all three states, use isUserTristate() 代替。

PySide2.QtGui.QStandardItem. isUserTristate ( ) ¶

返回类型

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.

默认值为 false。

另请参阅

setUserTristate() isCheckable() checkState()

PySide2.QtGui.QStandardItem. model ( ) ¶

返回类型

QStandardItemModel

返回 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 .

另请参阅

index()

PySide2.QtGui.QStandardItem. parent ( ) ¶

返回类型

QStandardItem

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

注意

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

另请参阅

child() invisibleRootItem()

PySide2.QtGui.QStandardItem. read ( in ) ¶

参数

in – QDataStream

读取项从流 in . Only the data and flags of the item are read, not the child items.

另请参阅

write()

PySide2.QtGui.QStandardItem. removeColumn ( column ) ¶

参数

column – int

移除给定 column . The items that were in the column are deleted.

另请参阅

takeColumn() removeColumns() removeRow()

PySide2.QtGui.QStandardItem. removeColumns ( column , count ) ¶

参数

• column – int

• count – int

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

另请参阅

removeColumn() removeRows()

PySide2.QtGui.QStandardItem. removeRow ( row ) ¶

参数

row – int

移除给定 row . The items that were in the row are deleted.

另请参阅

takeRow() removeRows() removeColumn()

PySide2.QtGui.QStandardItem. removeRows ( row , count ) ¶

参数

• row – int

• count – int

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

另请参阅

removeRow() removeColumn()

PySide2.QtGui.QStandardItem. row ( ) ¶

返回类型

int

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

另请参阅

column() parent()

PySide2.QtGui.QStandardItem. rowCount ( ) ¶

返回类型

int

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

另请参阅

setRowCount() columnCount()

PySide2.QtGui.QStandardItem. setAccessibleDescription ( accessibleDescription ) ¶

参数

accessibleDescription – unicode

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

另请参阅

accessibleDescription() setAccessibleText()

PySide2.QtGui.QStandardItem. setAccessibleText ( accessibleText ) ¶

参数

accessibleText – unicode

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

另请参阅

accessibleText() setAccessibleDescription()

PySide2.QtGui.QStandardItem. setAutoTristate ( tristate ) ¶

参数

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

另请参阅

isAutoTristate() setCheckable() setCheckState()

PySide2.QtGui.QStandardItem. setBackground ( brush ) ¶

参数

brush – QBrush

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

另请参阅

background() setForeground()

PySide2.QtGui.QStandardItem. setCheckState ( checkState ) ¶

参数

checkState – CheckState

Sets the check state of the item to be state .

另请参阅

checkState() setCheckable()

PySide2.QtGui.QStandardItem. setCheckable ( checkable ) ¶

参数

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.

另请参阅

isCheckable() setCheckState() setUserTristate() setAutoTristate()

PySide2.QtGui.QStandardItem. setChild ( row , column , item ) ¶

参数

• row – int

• column – int

• item – QStandardItem

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

注意

传递 None as item removes the item.

另请参阅

child()

PySide2.QtGui.QStandardItem. setChild ( row , item ) ¶

参数

• row – int

• item – QStandardItem

这是重载函数。

Sets the child at row to item .

PySide2.QtGui.QStandardItem. setColumnCount ( columns ) ¶

参数

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.

另请参阅

columnCount() setRowCount()

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

参数

• value – object

• role – int

Sets the item’s data for the given role 到指定 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.

注意

默认实现视 EditRole and DisplayRole 为引用相同数据。

另请参阅

ItemDataRole data() setFlags()

PySide2.QtGui.QStandardItem. setDragEnabled ( dragEnabled ) ¶

参数

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 .

另请参阅

isDragEnabled() setDropEnabled() setFlags()

PySide2.QtGui.QStandardItem. setDropEnabled ( dropEnabled ) ¶

参数

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

另请参阅

isDropEnabled() setDragEnabled() setFlags()

PySide2.QtGui.QStandardItem. setEditable ( editable ) ¶

参数

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 .

另请参阅

isEditable() setFlags()

PySide2.QtGui.QStandardItem. setEnabled ( enabled ) ¶

参数

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.

另请参阅

isEnabled() ItemIsEnabled setFlags()

PySide2.QtGui.QStandardItem. setFlags ( flags ) ¶

参数

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.

另请参阅

flags() setData()

PySide2.QtGui.QStandardItem. setFont ( font ) ¶

参数

font – QFont

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

另请参阅

font() setText() setForeground()

PySide2.QtGui.QStandardItem. setForeground ( brush ) ¶

参数

brush – QBrush

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

另请参阅

foreground() setBackground() setFont()

PySide2.QtGui.QStandardItem. setIcon ( icon ) ¶

参数

icon – QIcon

Sets the item’s icon to the icon 指定。

另请参阅

icon()

PySide2.QtGui.QStandardItem. setRowCount ( rows ) ¶

参数

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.

另请参阅

rowCount() setColumnCount()

PySide2.QtGui.QStandardItem. setSelectable ( selectable ) ¶

参数

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 .

另请参阅

isSelectable() setFlags()

PySide2.QtGui.QStandardItem. setSizeHint ( sizeHint ) ¶

参数

sizeHint – 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.

另请参阅

sizeHint()

PySide2.QtGui.QStandardItem. setStatusTip ( statusTip ) ¶

参数

statusTip – unicode

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

另请参阅

statusTip() setToolTip() setWhatsThis()

PySide2.QtGui.QStandardItem. setText ( text ) ¶

参数

text – unicode

Sets the item’s text to the text 指定。

另请参阅

text() setFont() setForeground()

PySide2.QtGui.QStandardItem. setTextAlignment ( textAlignment ) ¶

参数

textAlignment – Alignment

Sets the text alignment for the item’s text to the alignment 指定。

另请参阅

textAlignment()

PySide2.QtGui.QStandardItem. setToolTip ( toolTip ) ¶

参数

toolTip – unicode

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

另请参阅

toolTip() setStatusTip() setWhatsThis()

PySide2.QtGui.QStandardItem. setTristate ( tristate ) ¶

参数

tristate – bool

注意

此函数被弃用。

使用 setAutoTristate (bool tristate) instead. For a tristate checkbox that the user can change between all three states, use setUserTristate (bool tristate) instead.

另请参阅

isTristate()

PySide2.QtGui.QStandardItem. setUserTristate ( tristate ) ¶

参数

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

另请参阅

isUserTristate() setCheckable() setCheckState()

PySide2.QtGui.QStandardItem. setWhatsThis ( whatsThis ) ¶

参数

whatsThis – unicode

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

另请参阅

whatsThis() setStatusTip() setToolTip()

PySide2.QtGui.QStandardItem. sizeHint ( ) ¶

返回类型

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.

另请参阅

setSizeHint()

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

参数

• column – int

• order – SortOrder

排序项的子级使用给定 order ，通过值在给定 column .

注意

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

另请参阅

operator

PySide2.QtGui.QStandardItem. statusTip ( ) ¶

返回类型

unicode

Returns the item’s status tip.

另请参阅

setStatusTip() toolTip() whatsThis()

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

参数

• row – int

• column – int

返回类型

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.

另请参阅

child() takeRow() takeColumn()

PySide2.QtGui.QStandardItem. takeColumn ( column ) ¶

参数

column – int

返回类型

移除 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 .

另请参阅

removeColumn() insertColumn() takeRow()

PySide2.QtGui.QStandardItem. takeRow ( row ) ¶

参数

row – int

返回类型

移除 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 .

另请参阅

removeRow() insertRow() takeColumn()

PySide2.QtGui.QStandardItem. text ( ) ¶

返回类型

unicode

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

另请参阅

setText()

PySide2.QtGui.QStandardItem. textAlignment ( ) ¶

返回类型

Alignment

Returns the text alignment for the item’s text.

另请参阅

setTextAlignment()

PySide2.QtGui.QStandardItem. toolTip ( ) ¶

返回类型

unicode

Returns the item’s tooltip.

另请参阅

setToolTip() statusTip() whatsThis()

PySide2.QtGui.QStandardItem. 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 .

另请参阅

Type

PySide2.QtGui.QStandardItem. whatsThis ( ) ¶

返回类型

unicode

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

另请参阅

setWhatsThis() toolTip() statusTip()

PySide2.QtGui.QStandardItem. write ( out ) ¶

参数

out – QDataStream

把项写入流 out . Only the data and flags of the item are written, not the child items.

另请参阅

read()