QListWidgetItem Class Reference
[QtGui module]
该QListWidgetItem类提供的项目与使用QListWidget项目视图类。More…
Types
enum ItemType { Type, UserType }
Methods
__init__ (self, QListWidget parent = None, int type = QListWidgetItem.Type)
__init__ (self, QString text, QListWidget parent = None, int type = QListWidgetItem.Type)
__init__ (self, QIcon icon, QString text, QListWidget parent = None, int type = QListWidgetItem.Type)
__init__ (self, QListWidgetItem other)
QBrush background (self)
QColor backgroundColor (self)
Qt.CheckState checkState (self)
QListWidgetItem clone (self)
QVariant data (self, int role)
Qt.ItemFlags flags (self)
QFont font (self)
QBrush foreground (self)
QIcon icon (self)
bool isHidden (self)
bool isSelected (self)
QListWidget listWidget (self)
read (self, QDataStream in)
setBackground (self, QBrush brush)
setBackgroundColor (self, QColor color)
setCheckState (self, Qt.CheckState state)
setData (self, int role, QVariant value)
setFlags (self, Qt.ItemFlags aflags)
setFont (self, QFont afont)
setForeground (self, QBrush brush)
setHidden (self, bool ahide)
setIcon (self, QIcon aicon)
setSelected (self, bool aselect)
setSizeHint (self, QSize size)
setStatusTip (self, QString astatusTip)
setText (self, QString atext)
setTextAlignment (self, int alignment)
setTextColor (self, QColor color)
setToolTip (self, QString atoolTip)
setWhatsThis (self, QString awhatsThis)
QSize sizeHint (self)
QString statusTip (self)
QString text (self)
int textAlignment (self)
QColor textColor (self)
QString toolTip (self)
int type (self)
QString whatsThis (self)
write (self, QDataStream out)
Special Methods
bool __ge__ (self, QListWidgetItem other)
bool __lt__ (self, QListWidgetItem other)
Detailed Description
该QListWidgetItem类提供的项目与使用QListWidget项目视图类。
一个QListWidgetItem代表一个单一的项目QListWidget。每个项目可容纳几条信息,并会适当地显示出来。
项目视图便利类使用一个典型的项目为基础的界面,而不是一个纯粹的模型/视图的方法。对于一个更加灵活的列表视图控件,可以考虑使用QListView类与标准模型。
列表项可以被自动插入到一个列表中,当它们被建造,通过指定列表控件:
new QListWidgetItem(tr("Hazel"), listWidget);
或者,列表项,也可以没有父窗口部件创建的,并在以后使用插入到列表QListWidget.insertItem( ) 。
列表项通常用于显示text()和一个icon( ) 。这些设置与setText()和setIcon()函数。文本的外观可与定制setFont( )setForeground()和setBackground( ) 。在列表项的文本可使用对齐setTextAlignment()函数。工具提示,状态提示和“这是什么? ”说明可以被添加到列表中的内容setToolTip( )setStatusTip()和setWhatsThis( ) 。
默认情况下,项目的启用,可选择,可复,可拖放操作的来源。
每个项目的标志可以通过调用改变setFlags( )用适当的值(见Qt.ItemFlags) 。辨认的项目可以被选中,未选中并与部分检查setCheckState()函数。相应的checkState( )函数表示该项目的当前选中状态。
该isHidden()函数可以被用来确定该项目是否被隐藏。若要隐藏某个项目,用setHidden( ) 。
Subclassing
当子类QListWidgetItem提供自定义项目,可以为他们使他们能够从标准的项目区分开来定义新的类型。对于需要此功能的子类,请确保调用基类的构造函数有一个新的类型值等于或大于UserType,内your构造函数。
Type Documentation
QListWidgetItem.ItemType
该枚举描述了用于描述列表插件项的类型。
Constant | Value | Description |
---|---|---|
QListWidgetItem.Type |
0 |
默认类型为列表控件的项目。 |
QListWidgetItem.UserType |
1000 |
对于自定义类型的最小值。以下用户等级和积分值被Qt保留。 |
您可以定义新的用户类型QListWidgetItem子类以确保自定义项目被特殊处理。
See also type( ) 。
Method Documentation
QListWidgetItem.__init__ (self, QListWidget parent = None, int type = QListWidgetItem.Type)
该parent的说法,如果不是没有,原因self通过Qt的,而不是PyQt的拥有。
构造指定一个空的列表控件项type用给定的parent。如果parent没有被指定,该项目将需要被插入到一个列表部件与QListWidget.insertItem( ) 。
这个构造函数插入项目到传递给构造函数的父模型。如果模型被排序,然后插入物的行为是不确定的,因为该模型将调用'<'
运营商的方法上,在这一点上,尚未建成的项目。为了避免不确定的行为,我们建议不要指定父和使用QListWidget.insertItem( )来代替。
See also type( ) 。
QListWidgetItem.__init__ (self, QString text, QListWidget parent = None, int type = QListWidgetItem.Type)
该parent的说法,如果不是没有,原因self通过Qt的,而不是PyQt的拥有。
构造指定一个空的列表控件项type用给定的text和parent。如果未指定父,则该项目将需要被插入到一个列表部件与QListWidget.insertItem( ) 。
这个构造函数插入项目到传递给构造函数的父模型。如果模型被排序,然后插入物的行为是不确定的,因为该模型将调用'<'
运营商的方法上,在这一点上,尚未建成的项目。为了避免不确定的行为,我们建议不要指定父和使用QListWidget.insertItem( )来代替。
See also type( ) 。
QListWidgetItem.__init__ (self, QIcon icon, QString text, QListWidget parent = None, int type = QListWidgetItem.Type)
该parent的说法,如果不是没有,原因self通过Qt的,而不是PyQt的拥有。
构造指定一个空的列表控件项type用给定的icon,text和parent。如果未指定父,则该项目将需要被插入到一个列表部件与QListWidget.insertItem( ) 。
这个构造函数插入项目到传递给构造函数的父模型。如果模型被排序,然后插入物的行为是不确定的,因为该模型将调用'<'
运营商的方法上,在这一点上,尚未建成的项目。为了避免不确定的行为,我们建议不要指定父和使用QListWidget.insertItem( )来代替。
See also type( ) 。
QListWidgetItem.__init__ (self, QListWidgetItem other)
构造的副本other。需要注意的是type()和listWidget( )不会被复制。
重新实现时,此功能非常有用clone( ) 。
这个函数是Qt 4.1中引入。
QBrush QListWidgetItem.background (self)
[
返回用于显示列表项的背景的画笔。
这个函数中引入了Qt 4.2中。
]($docs-qbrush.html)
See also setBackground()和foreground( ) 。
QColor QListWidgetItem.backgroundColor (self)
Qt.CheckState QListWidgetItem.checkState (self)
See also setCheckState()和flags( ) 。
QListWidgetItem QListWidgetItem.clone (self)
[
创建该项目的精确副本。
QVariant QListWidgetItem.data (self, int role)
返回的项目的数据对于一个给定role。如果你需要额外的角色或某些角色的特殊行为重新实现这个函数。
]($docs-qlistwidgetitem.html)
See also Qt.ItemDataRole和setData( ) 。
Qt.ItemFlags QListWidgetItem.flags (self)
返回该项目的标志为这个项目(见Qt.ItemFlags) 。
See also setFlags( ) 。
QFont QListWidgetItem.font (self)
[
返回用于显示该列表项的文本的字体。
]($docs-qfont.html)
QBrush QListWidgetItem.foreground (self)
[
返回用于显示列表项的前景(如文字)的笔刷。
这个函数中引入了Qt 4.2中。
]($docs-qbrush.html)
See also setForeground()和background( ) 。
QIcon QListWidgetItem.icon (self)
[
返回列表项的图标。
]($docs-qicon.html)
bool QListWidgetItem.isHidden (self)
返回True如果该项目是隐藏,否则返回False 。
这个函数中引入了Qt 4.2中。
See also setHidden( ) 。
bool QListWidgetItem.isSelected (self)
返回True如果该项目被选中,否则返回False 。
这个函数中引入了Qt 4.2中。
See also setSelected( ) 。
QListWidget QListWidgetItem.listWidget (self)
[
返回包含项目的列表控件。
QListWidgetItem.read (self, QDataStream in)
从流中读取的项目in。
]($docs-qlistwidget.html)
QListWidgetItem.setBackground (self, QBrush brush)
设置列表项的背景刷到给定brush。
这个函数中引入了Qt 4.2中。
See also background()和setForeground( ) 。
QListWidgetItem.setBackgroundColor (self, QColor color)
QListWidgetItem.setCheckState (self, Qt.CheckState state)
设置列表项的复选状态state。
See also checkState( ) 。
QListWidgetItem.setData (self, int role, QVariant value)
设置数据对于一个给定role为给定的value。如果你需要额外的角色或某些角色的特殊行为重新实现这个函数。
See also Qt.ItemDataRole和data( ) 。
QListWidgetItem.setFlags (self, Qt.ItemFlags aflags)
设置项标志为列表项flags。
See also flags()和Qt.ItemFlags。
QListWidgetItem.setFont (self, QFont afont)
画设定的项目给定的时使用的字体font。
See also font( ) 。
QListWidgetItem.setForeground (self, QBrush brush)
设置列表项的前景画笔给定的brush。
这个函数中引入了Qt 4.2中。
See also foreground()和setBackground( ) 。
QListWidgetItem.setHidden (self, bool ahide)
隐藏的项目,如果hide为True,否则显示的项目。
这个函数中引入了Qt 4.2中。
See also isHidden( ) 。
QListWidgetItem.setIcon (self, QIcon aicon)
设置为列表项的图标给定的icon。
See also icon( )text()和iconSize。
QListWidgetItem.setSelected (self, bool aselect)
设置项的选择状态,以select。
这个函数中引入了Qt 4.2中。
See also isSelected( ) 。
QListWidgetItem.setSizeHint (self, QSize size)
设置尺寸暗示的列表项是size。如果没有大小的提示设置,基于项目数据的项目代表将计算尺寸暗示。
这个函数是Qt 4.1中引入。
See also sizeHint( ) 。
QListWidgetItem.setStatusTip (self, QString astatusTip)
设置状态提示为列表项由指定的文本statusTip。QListWidgetmouseTracking需要启用此功能工作。
See also statusTip( )setToolTip( )setWhatsThis()和QWidget.setMouseTracking( ) 。
QListWidgetItem.setText (self, QString atext)
设置文本列表控件项的给定text。
See also text( ) 。
QListWidgetItem.setTextAlignment (self, int alignment)
设置列表项的文本对齐方式alignment。
See also textAlignment()和Qt.AlignmentFlag。
QListWidgetItem.setTextColor (self, QColor color)
QListWidgetItem.setToolTip (self, QString atoolTip)
设置工具提示的列表项由指定的文本toolTip。
See also toolTip( )setStatusTip()和setWhatsThis( ) 。
QListWidgetItem.setWhatsThis (self, QString awhatsThis)
设置“这是什么? ”帮助列表项由指定的文本whatsThis。
See also whatsThis( )setStatusTip()和setToolTip( ) 。
QSize QListWidgetItem.sizeHint (self)
[
返回列表项的大小提示集。
这个函数是Qt 4.1中引入。
]($docs-qsize.html)
See also setSizeHint( ) 。
QString QListWidgetItem.statusTip (self)
返回列表项的状态提示。
See also setStatusTip( ) 。
QString QListWidgetItem.text (self)
返回列表项的文本。
See also setText( ) 。
int QListWidgetItem.textAlignment (self)
返回文本对齐方式为列表项。
See also setTextAlignment()和Qt.AlignmentFlag。
QColor QListWidgetItem.textColor (self)
[
QString QListWidgetItem.toolTip (self)
返回列表项的工具提示。
]($docs-qcolor.html)
See also setToolTip( )statusTip()和whatsThis( ) 。
int QListWidgetItem.type (self)
返回传递给类型QListWidgetItem构造函数。
QString QListWidgetItem.whatsThis (self)
返回列表项的“这是什么? ”帮助文本。
See also setWhatsThis( )statusTip()和toolTip( ) 。
QListWidgetItem.write (self, QDataStream out)
写入流的项目out。
See also read( ) 。
bool QListWidgetItem.__ge__ (self, QListWidgetItem other)
bool QListWidgetItem.__lt__ (self, QListWidgetItem other)