Home · All Classes · Modules  · QSS HELP  · QSS 案例 · VER007 HOME

QStandardItem Class Reference
[QtGui module]

该QStandardItem类提供的项目与使用QStandardItemModel类。More...

Types

Methods

Special Methods

Detailed Description

该QStandardItem类提供的项目与使用QStandardItemModel类。

项目通常包含文字，图标或复选框。

每个项目都可以有自己的背景刷子设置与setBackground（）函数。当前的背景刷可以找到background（ ） 。每个项目的文本标籤可以有自己的字体和笔刷渲染。这些都与指定setFont（）和setForeground（）函数，并读取与font（）和foreground（ ） 。

默认情况下，项目的启用，可编辑，可选择辨认的，可同时用作拖动的来源又是释放的操作和放置目标。每个项目的标志可以通过调用改变setFlags（ ） 。辨认的项目可以选中和未选中的setCheckState（）函数。相应的checkState（ ）函数表示该项目目前是否已选中。

你可以通过调用一个项目存储应用程序特定的数据setData（ ） 。

每个项目可以有一个二维子项表。这使得它可以构建项目的层次结构。典型的分层结构是树，在这种情况下，子表是一个表，用一个柱（列表）。

子表的尺寸可以与设置setRowCount（）和setColumnCount（ ） 。物品可以放置在子表setChild（ ） 。获取一个指针，指向一个子项与child（ ） 。儿童的新的行和列，也可以插入insertRow（）和insertColumn（），或者追加appendRow（）和appendColumn（ ） 。当使用append和插入函数，子表的尺寸根据需要将增长。

儿童的现有行可以被删除removeRow（）或takeRow（）;相应地，一列可以具有去除removeColumn（）或takeColumn（ ） 。

一个项目的孩子可以通过调用进行排序sortChildren（ ） 。

Subclassing

当子类QStandardItem提供自定义项目，可以为他们定义新类型，使他们能够从基类区别开来。该type（）函数应该被重新实现返回一个新的类型的值等于或大于UserType。

重新实现data（）和setData（ ）如果要执行数据查询的自定义处理和/或控制项的数据是如何表示的。

重新实现clone（ ）如果你想QStandardItemModel要能够根据需要创建自定义项目类的实例（见QStandardItemModel.setItemPrototype（））。

重新实现read（）和write（ ）如果你想控制项目如何代表他们的序列化形式。

重新实现operator<（ ）如果你想控制项目比较的语义。operator<（ ）确定排序顺序与排序项目时，sortChildren（）或与QStandardItemModel.sort（ ） 。

Type Documentation

QStandardItem.ItemType

这个枚举变量描述了用于描述标准的项目的类型。

Constant Value Description
QStandardItem.Type 0 默认类型为标准的项目。
QStandardItem.UserType 1000 对于自定义类型的最小值。以下用户等级和积分值被Qt保留。

您可以定义新的用户类型QStandardItem子类以确保自定义项目经过特殊处理，例如，当项目进行排序。

See also type（ ） 。

Method Documentation

QStandardItem.__init__ (self)

构造一个项目。

QStandardItem.__init__ (self, QString text)

构造具有给定的项目text。

QStandardItem.__init__ (self, QIcon icon, QString text)

构造具有给定的项目icon和text。

QStandardItem.__init__ (self, int rows, int columns = 1)

构造与项目rows行和columns子项的列。

QStandardItem.__init__ (self, QStandardItem other)

构造的副本other。需要注意的是model（ ）不会被复制。

重新实现时，此功能非常有用clone（ ） 。

QString QStandardItem.accessibleDescription (self)

返回该项目的可访问的描述。

可访问的说明是使用辅助技术（即谁不能用互动的传统方式用户） 。

See also setAccessibleDescription（）和accessibleText（ ） 。

QString QStandardItem.accessibleText (self)

返回该项目的访问的文本。

在访问的文本所使用的辅助技术（即谁不能使用交互的常规手段的用户） 。

See also setAccessibleText（）和accessibleDescription（ ） 。

QStandardItem.appendColumn (self, list-of-QStandardItem aitems)

该aitems说法有它的所有权转移给Qt的。

含追加一列items。如果有必要，该行数将增加至大小items。

See also insertColumn（ ） 。

QStandardItem.appendRow (self, list-of-QStandardItem aitems)

该aitems说法有它的所有权转移给Qt的。

含追加的行items。如果需要的话，列计数值增加到的大小items。

See also insertRow（ ） 。

QStandardItem.appendRow (self, QStandardItem aitem)

该aitem说法有它的所有权转移给Qt的。

这是一个重载函数。

含追加的行item。

当建立一个列表，或者只有一列树，该功能提供了一种方便的方式来追加新的单一项目。

QStandardItem.appendRows (self, list-of-QStandardItem aitems)

该aitems说法有它的所有权转移给Qt的。

含追加行items。列计数不会改变。

See also insertRow（ ） 。

QBrush QStandardItem.background (self)

返回用于呈现项的背景的画笔。

See also foreground（）和setBackground（ ） 。

Qt.CheckState QStandardItem.checkState (self)

返回项目的选中状态。

See also setCheckState（）和isCheckable（ ） 。

QStandardItem QStandardItem.child (self, int row, int column = 0)

返回位于（子项row，column）如果已设置，否则返回0 。

See also setChild（ ）takeChild（）和parent（ ） 。

QStandardItem QStandardItem.clone (self)

返回此文件的副本。该项目的孩子不会被复制。

当子类QStandardItem，你可以重新实现此功能提供QStandardItemModel用它可以用来创建随需应变的新项目工厂。

See also QStandardItemModel.setItemPrototype（）和operator=（ ） 。

int QStandardItem.column (self)

返回列该项目位于其父的子表，或-1，如果该项目没有父。

See also row（）和parent（ ） 。

int QStandardItem.columnCount (self)

返回子项列，该项目具有数量。

See also setColumnCount（）和rowCount（ ） 。

QVariant QStandardItem.data (self, int role = Qt.UserRole+1)

返回的项目的数据为给定的role，或无效QVariant如果不存在数据的作用。

Note:默认实现对待Qt.EditRole和Qt.DisplayRole为是指相同的数据。

See also setData（ ） 。

QStandardItem.emitDataChanged (self)

原因与此文件相关的模型发出dataChanged（）信号为这个项目。

你通常只需要调用这个函数，如果你有子类QStandardItem并重新实现data（ ）和/或setData（ ） 。

此功能被引入Qt的4.4 。

See also setData（ ） 。

Qt.ItemFlags QStandardItem.flags (self)

返回项标志的项目。

项目标志确定用户如何能够与项目交互。

默认情况下，项目的启用，可编辑，可选择辨认的，可同时用作拖动的来源又是释放的操作和放置目标。

See also setFlags（ ） 。

QFont QStandardItem.font (self)

返回用于呈现项的文本的字体。

See also setFont（ ） 。

QBrush QStandardItem.foreground (self)

返回用于呈现项目的前景（如文字）的笔刷。

See also setForeground（）和background（ ） 。

bool QStandardItem.hasChildren (self)

返回True如果资料有任何子女;否则返回False。

See also rowCount（ ）columnCount（）和child（ ） 。

QIcon QStandardItem.icon (self)

返回该项目的图标。

See also setIcon（）和iconSize。

QModelIndex QStandardItem.index (self)

返回QModelIndex与此文件相关。

当你需要调用一个功能项QModelIndex的API （例如QAbstractItemView） ，你可以调用这个函数来获得与该项目的位置在模型中的索引。

如果该项目没有与模型，无效的关联QModelIndex返回。

See also model（）和QStandardItemModel.itemFromIndex（ ） 。

QStandardItem.insertColumn (self, int column, list-of-QStandardItem items)

该items说法有它的所有权转移给Qt的。

在插入一列column containing items。如果有必要，该行数将增加至大小items。

See also insertColumns（）和insertRow（ ） 。

QStandardItem.insertColumns (self, int column, int count)

Inserts count在柱子项的列column。

See also insertColumn（）和insertRows（ ） 。

QStandardItem.insertRow (self, int row, list-of-QStandardItem items)

该items说法有它的所有权转移给Qt的。

插入一个一行row containing items。如果需要的话，列计数值增加到的大小items。

See also insertRows（）和insertColumn（ ） 。

QStandardItem.insertRow (self, int arow, QStandardItem aitem)

该aitem说法有它的所有权转移给Qt的。

这是一个重载函数。

插入一个一行row containing item。

当建立一个列表，或者只有一列树，该功能提供了一种方便的方式来插入一个新的项目。

QStandardItem.insertRows (self, int row, int count)

Inserts items在row。列计数不会改变。

See also insertRow（）和insertColumn（ ） 。

QStandardItem.insertRows (self, int row, list-of-QStandardItem items)

该items说法有它的所有权转移给Qt的。

Inserts count在一行行的子项row。

See also insertRow（）和insertColumns（ ） 。

bool QStandardItem.isCheckable (self)

返回该项目是否是用户可选中。

默认值是False 。

See also setCheckable（ ）checkState（）和isTristate（ ） 。

bool QStandardItem.isDragEnabled (self)

返回该项目是否启用拖动。一个项目，是拖拉启用可以由用户进行拖动。

默认值是True 。

请注意，项目必须拖着在视图中启用拖放到工作;看QAbstractItemView.dragEnabled。

See also setDragEnabled（ ）isDropEnabled（）和flags（ ） 。

bool QStandardItem.isDropEnabled (self)

返回该项目是否下降启用。当一个项目是下拉使能时，它可以作为一个放置目标。

默认值是True 。

See also setDropEnabled（ ）isDragEnabled（）和flags（ ） 。

bool QStandardItem.isEditable (self)

返回是否该项目可以由用户进行编辑。

当一个项目是可编辑的（并启用） ，用户可以通过调用视图的编辑触发器中的一个编辑的项目;见QAbstractItemView.editTriggers。

默认值是True 。

See also setEditable（）和flags（ ） 。

bool QStandardItem.isEnabled (self)

返回该项是否已启用。

当一个项目被启用，用户可以与它进行交互。可能的类型的交互是由其它产品的标志，如指定isEditable（）和isSelectable（ ） 。

默认值是True 。

See also setEnabled（）和flags（ ） 。

bool QStandardItem.isSelectable (self)

返回该产品是否是由用户选择的。

默认值是True 。

See also setSelectable（）和flags（ ） 。

bool QStandardItem.isTristate (self)

该项目的回报是否是三态的，也就是说，如果它是可复用三个分开的状态。

默认值是False 。

See also setTristate（ ）isCheckable（）和checkState（ ） 。

QStandardItemModel QStandardItem.model (self)

返回QStandardItemModel此项目属于。

如果该项目不属于模型的另一个项目的一个孩子，这个函数返回0 。

See also index（ ） 。

QStandardItem QStandardItem.parent (self)

返回该项目的父项目，或者0，如果该项目没有父。

See also child（ ） 。

QStandardItem.read (self, QDataStream in)

从流中读取的项目in。唯一的项的数据和标志读，而不是子项。

See also write（ ） 。

QStandardItem.removeColumn (self, int column)

删除给定的column。这是该列中的项被删除。

See also takeColumn（ ）removeColumns（）和removeRow（ ） 。

QStandardItem.removeColumns (self, int column, int count)

移除count在列的列column。这是这些列中的项将被删除。

See also removeColumn（）和removeRows（ ） 。

QStandardItem.removeRow (self, int row)

删除给定的row。这是该行中的项目被删除。

See also takeRow（ ）removeRows（）和removeColumn（ ） 。

QStandardItem.removeRows (self, int row, int count)

移除count在一行行row。这是在这些行中的项目都将被删除。

See also removeRow（）和removeColumn（ ） 。

int QStandardItem.row (self)

返回该行所在的项目位于其父的子表，或-1，如果该项目没有父。

See also column（）和parent（ ） 。

int QStandardItem.rowCount (self)

返回该项目具有子项的行数。

See also setRowCount（）和columnCount（ ） 。

QStandardItem.setAccessibleDescription (self, QString aaccessibleDescription)

设置项目的访问描述为字符串由指定的accessibleDescription。

可访问的说明是使用辅助技术（即谁不能用互动的传统方式用户） 。

See also accessibleDescription（）和setAccessibleText（ ） 。

QStandardItem.setAccessibleText (self, QString aaccessibleText)

设置项目的访问的文本由指定的字符串accessibleText。

在访问的文本所使用的辅助技术（即谁不能使用交互的常规手段的用户） 。

See also accessibleText（）和setAccessibleDescription（ ） 。

QStandardItem.setBackground (self, QBrush abrush)

设置项的背景刷到指定的brush。

See also background（）和setForeground（ ） 。

QStandardItem.setCheckable (self, bool checkable)

设置项是否是用户可选中。如果checkable诚然，该项目可以由用户进行检查，否则用户无法检查的项目。

该项目委讬将呈现辨认的项目与项目旁边的文本的复选框。

See also isCheckable（ ）setCheckState（）和setTristate（ ） 。

QStandardItem.setCheckState (self, Qt.CheckState acheckState)

设置为项目的选中状态state。

See also checkState（）和setCheckable（ ） 。

QStandardItem.setChild (self, int row, int column, QStandardItem item)

该item说法有它的所有权转移给Qt的。

设置在子项（row，column）至item。此产品（父项）需要的所有权item。如果必要，行数和列数都增加，以适应产品。

See also child（ ） 。

QStandardItem.setChild (self, int arow, QStandardItem aitem)

该aitem说法有它的所有权转移给Qt的。

这是一个重载函数。

设定孩子row至item。

QStandardItem.setColumnCount (self, int columns)

设置子项的列数columns。如果它小于columnCount（） ，在不需要的列中的数据将被丢弃。

See also columnCount（）和setRowCount（ ） 。

QStandardItem.setData (self, QVariant value, int role = Qt.UserRole+1)

设置项的数据为给定的role到指定的value。

如果子类QStandardItem并且重新实现这个功能，你重新实现应该调用emitDataChanged（ ）如果你不使用setData调用的基实现（ ） 。这将确保如使用模型视图通知的变化。

Note:默认实现对待Qt.EditRole和Qt.DisplayRole为是指相同的数据。

See also Qt.ItemDataRole，data（）和setFlags（ ） 。

QStandardItem.setDragEnabled (self, bool dragEnabled)

设置项是否启用拖动。如果dragEnabled诚然，该项目可以由用户拖动，否则，用户无法拖曳项目。

请注意，您还需要确保该项目拖动在视图中启用;见QAbstractItemView.dragEnabled。

See also isDragEnabled（ ）setDropEnabled（）和setFlags（ ） 。

QStandardItem.setDropEnabled (self, bool dropEnabled)

设置项是否下降启用。如果dropEnabled诚然，该项目可作为放置目标，否则不能。

请注意，您还需要确保滴在视图中启用;见QWidget.acceptDrops（）; ，且该模型支持所需的放置动作;见QAbstractItemModel.supportedDropActions（ ） 。

See also isDropEnabled（ ）setDragEnabled（）和setFlags（ ） 。

QStandardItem.setEditable (self, bool editable)

设置项是否可以编辑。如果editable诚然，该项目可以由用户进行编辑，否则用户无法编辑的项目。

如何通过视图的编辑触发器来确定用户可以编辑视图中的项目;见QAbstractItemView.editTriggers。

See also isEditable（）和setFlags（ ） 。

QStandardItem.setEnabled (self, bool enabled)

设置该项是否已启用。如果enabled为真，则该项目被使能，这意味着用户可以与产品进行交互;若enabled为假，则用户不能与项目交互。

此标志优先于其他项目的标志;如如果项目没有被启用，它不能由用户选择的，即使Qt.ItemIsSelectable标志已设置。

See also isEnabled（ ）Qt.ItemIsEnabled和setFlags（ ） 。

QStandardItem.setFlags (self, Qt.ItemFlags flags)

设置项标志的项目flags。

项目标志确定用户如何能够与项目交互。这通常被用于禁用的项目。

See also flags（）和setData（ ） 。

QStandardItem.setFont (self, QFont afont)

设置用于显示项目的文字给定的字体font。

See also font（ ）setText（）和setForeground（ ） 。

QStandardItem.setForeground (self, QBrush abrush)

设置用于显示项目的前景（如文本）给定的画笔brush。

See also foreground（ ）setBackground（）和setFont（ ） 。

QStandardItem.setIcon (self, QIcon aicon)

设置项的图标icon规定。

See also icon（ ） 。

QStandardItem.setRowCount (self, int rows)

设置的子项目行数rows。如果它小于rowCount（） ，在不需要的行中的数据将被丢弃。

See also rowCount（）和setColumnCount（ ） 。

QStandardItem.setSelectable (self, bool selectable)

设置项是否可选。如果selectable诚然，该项目可以由用户来选择，否则，用户无法选择该项目。

您可以通过操纵自己的视图属性控制选择行为和模式，见QAbstractItemView.selectionMode和QAbstractItemView.selectionBehavior。

See also isSelectable（）和setFlags（ ） 。

QStandardItem.setSizeHint (self, QSize asizeHint)

设置尺寸暗示该项目是size。如果没有大小的提示设置，基于项目数据的项目代表将计算尺寸暗示。

See also sizeHint（ ） 。

QStandardItem.setStatusTip (self, QString astatusTip)

设置项目的状态提示由指定的字符串statusTip。

See also statusTip（ ）setToolTip（）和setWhatsThis（ ） 。

QStandardItem.setText (self, QString atext)

设置项的文字到text规定。

See also text（ ）setFont（）和setForeground（ ） 。

QStandardItem.setTextAlignment (self, Qt.Alignment atextAlignment)

设置文本对齐方式为项目的文字到alignment规定。

See also textAlignment（ ） 。

QStandardItem.setToolTip (self, QString atoolTip)

设置项的提示通过指定的字符串toolTip。

See also toolTip（ ）setStatusTip（）和setWhatsThis（ ） 。

QStandardItem.setTristate (self, bool tristate)

设置项是否为三态。如果tristate诚然，该项目是可复用三个独立的状态，否则，该项目是可复用两种状态。 （请注意，这也要求产品可复见isCheckable（ ） 。 ）

See also isTristate（ ）setCheckable（）和setCheckState（ ） 。

QStandardItem.setWhatsThis (self, QString awhatsThis)

设置项的“这是什么？ ”有助于通过指定的字符串whatsThis。

See also whatsThis（ ）setStatusTip（）和setToolTip（ ） 。

QSize QStandardItem.sizeHint (self)

返回该项目的尺寸暗示组，或无效QSize如果没有尺寸暗示已定。

如果没有大小提示已设置的基础上，项目数据的项目代表将计算尺寸暗示。

See also setSizeHint（ ） 。

QStandardItem.sortChildren (self, int column, Qt.SortOrder order = Qt.AscendingOrder)

排序的项目的使用给定的孩子order通过在给定的值column。

Note:这个函数是递归的，因此它排序的项目，其孙子女，等孩子们

See also operator<（ ） 。

QString QStandardItem.statusTip (self)

返回项目的状态提示。

See also setStatusTip（ ）toolTip（）和whatsThis（ ） 。

QStandardItem QStandardItem.takeChild (self, int row, int column = 0)

The QStandardItem result

删除的子项（row，column）而不删除它，并返回一个指向的项目。如果没有孩子在给定的位置，那么这个函数返回0 。

注意，这个函数，不象takeRow（）和takeColumn（ ） ，不影响子表的尺寸。

See also child（ ）takeRow（）和takeColumn（ ） 。

list-of-QStandardItem QStandardItem.takeColumn (self, int column)

该list-of-QStandardItem结果

移除column不删除的列项，并返回指针列表的删除的项。在尚未设定的列项，列表中的相应指针将是0 。

See also removeColumn（ ）insertColumn（）和takeRow（ ） 。

list-of-QStandardItem QStandardItem.takeRow (self, int row)

该list-of-QStandardItem结果

移除row不删除的行项目，并返回指针列表的删除的项目。对于没有被设置的行中的项目，列表中的相应指针将是0 。

See also removeRow（ ）insertRow（）和takeColumn（ ） 。

QString QStandardItem.text (self)

返回项的文本。这是这是呈现给用户在视图中的文本。

See also setText（ ） 。

Qt.Alignment QStandardItem.textAlignment (self)

返回文本对齐方式项的文本。

See also setTextAlignment（ ） 。

QString QStandardItem.toolTip (self)

返回该项目的工具提示。

See also setToolTip（ ）statusTip（）和whatsThis（ ） 。

int QStandardItem.type (self)

返回此项目的类型。该类型用于从基类区分自定义项目。当子类QStandardItem，你应该重新实现这个函数，并返回一个新的值大于或等于UserType。

See also QStandardItem.Type。

QString QStandardItem.whatsThis (self)

返回该项目的“这是什么？ ”帮助。

See also setWhatsThis（ ）toolTip（）和statusTip（ ） 。

QStandardItem.write (self, QDataStream out)

写入流的项目out。该项目的唯一的数据和标志都写，不是孩子的项目。

See also read（ ） 。

bool QStandardItem.__ge__ (self, QStandardItem other)

bool QStandardItem.__lt__ (self, QStandardItem other)



PyQt 4.10.3 for X11 Copyright © Riverbank Computing Ltd and Nokia 2012 Qt 4.8.5