- class QListWidgetItem#
《QListWidgetItem》类为使用《QListWidget》项目视图类提供了一个项。 更多…
概要#
方法#
def
__init__()
def
background()
def
checkState()
def
flags()
def
font()
def
foreground()
def
icon()
def
isHidden()
def
isSelected()
定义
text()
定义
type()
虚方法#
备注
本文档可能包含自动从C++翻译为Python的片段。我们始终欢迎对片段翻译的贡献。如果您发现翻译有问题,也可以通过在https:/bugreports.qt.io/projects/PYSIDE上创建问题来告诉我们。
详细描述#
警告
本节包含自动从C++翻译为Python的片段,可能包含错误。
QListWidgetItem
表示一个QListWidget
中的单个项。每个项目可以包含多个信息项,并将相应地显示它们。项视图便利类使用经典的基于项的界面,而非纯模型/视图方法。对于更灵活的列表视图小部件,请考虑使用具有标准模型的
QListView
类。可以在构造函数中指定列表小部件,将列表项自动插入到列表中。
QListWidgetItem(tr("Hazel"), listWidget)
或者,也可以在没有父小部件的情况下创建列表项,之后使用
insertItem()
将其插入列表中。列表项通常用于显示
text()
和一个icon()
。这些可以通过setText()
和setIcon()
函数来设置。可以使用setFont()
、setForeground()
和setBackground()
自定义文本的外观。可以使用 setTextAlignment() 函数对列表项中的文本进行对齐。可以使用setToolTip()
、setStatusTip()
和setWhatsThis()
向列表项添加工具提示、状态提示和 "这是什么" 帮助。默认情况下,项是启用、可选、可勾选的,并且可以是拖放操作的源。
可以通过调用带有相应值(参见 Qt::ItemFlags)的
setFlags()
来更改每个项的标志。可勾选项可以使用 setCheckState() 函数进行勾选、取消勾选和部分勾选。相应的 checkState() 函数表示项的当前勾选状态。可以使用 isHidden() 函数来确定项是否隐藏。要隐藏项,请使用 setHidden() 。
继承#
当通过提供自定义项来继承
QListWidgetItem
时,可以定义新类型,使它们能够与标准项区分开来。对于需要此功能的子类,确保您在 您的 构造函数中调用基类构造函数,带有等于或大于UserType
的新类型值。- class ItemType#
(继承自
enum.IntEnum
) 此枚举描述了用于描述列表小部件项的类型。常量
描述
QListWidgetItem.Type
列表小部件项的默认类型。
QListWidgetItem.UserType
自定义类型的最低值。低于 UserType 的值由 Qt 保留。
您可以在
QListWidgetItem
子类中定义新的用户类型,以确保自定义项被特殊处理。也可参见
- __init__(icon, text[, listview=None[, type=list()]])#
- 参数列表
icon –
QIcon
text – str
listview –
QListWidget
type – int
使用指定的
type
创建一个空的列表小部件项,并具有给定的icon
,text
和parent
。如果没有指定父级,则需要使用insertItem()
将项插入到列表小部件中。此构造函数将项插入到构造函数中传入的父级的模型中。如果模型已排序,则插入行为是不确定的,因为模型会调用项的
'<'
操作符方法,但在这一点上,项尚未构造。为了避免不确定的行为,我们建议不要指定父级,并使用insertItem()
。也可参见
- __init__([listview=None[, type=list()]])
- 参数列表
listview –
QListWidget
type – int
使用给定的
parent
创建一个空的指定type
的列表小部件项。如果未指定parent
,则该项需要通过insertItem()
插入到列表小部件中。此构造函数将项插入到构造函数中传入的父级的模型中。如果模型已排序,则插入行为是不确定的,因为模型会调用项的
'<'
操作符方法,但在这一点上,项尚未构造。为了避免不确定的行为,我们建议不要指定父级,并使用insertItem()
。也可参见
- __init__(text[, listview=None[, type=list()]])
- 参数列表
text – str
listview –
QListWidget
type – int
使用给定的
text
和parent
创建一个空的指定type
的列表小部件项。如果未指定父项,则该项需通过insertItem()
插入到列表小部件中。此构造函数将项插入到构造函数中传入的父级的模型中。如果模型已排序,则插入行为是不确定的,因为模型会调用项的
'<'
操作符方法,但在这一点上,项尚未构造。为了避免不确定的行为,我们建议不要指定父级,并使用insertItem()
。也可参见
- __init__(other)
- 参数列表
other –
QListWidgetItem
创建
other
的副本。注意,type()
和listWidget()
不会复制。当重新实现
clone()
时,此功能很有用。返回用于显示列表项背景的画刷。
返回列表项的选中状态(请参阅 Qt::CheckState)。
也可参见
- clone()#
- 返回类型::
创建项目的精确副本。
- data(role)#
- 参数列表
role – int
- 返回类型::
对象
返回指定
role
的项目数据。需要更多角色或特定角色的特殊行为时,请重新实现此函数。也可参见
返回此项目的项目标志(见 Qt::ItemFlags)。
也可参见
返回用于显示此列表项目文本的字体。
也可参见
返回用于显示列表项目前景(例如文本)的画刷。
返回列表项的图标。
- isHidden()#
- 返回类型::
bool
如果项目被隐藏,则返回
true
;否则返回false
。也可参见
- isSelected()#
- 返回类型::
bool
如果项目被选中,则返回
true
;否则返回false
。也可参见
- listWidget()#
- 返回类型::
返回包含项目的列表窗口。
- __lt__(other)#
- 参数列表
other –
QListWidgetItem
- 返回类型::
bool
如果此项目的文本小于
other
项目的文本,则返回true
;否则返回false
。- read(in)#
- 参数列表
in –
QDataStream
从流
in
中读取项。也可参见
将列表项的背景画笔设置为指定的
brush
。设置一个默认构造的画笔将让视图使用样式默认的颜色。- setCheckState(state)#
- 参数列表
state –
CheckState
将列表项的复选状态设置为
state
。也可参见
- setData(role, value)#
- 参数列表
role – int
value – 对象
将给定
role
的数据设置为给定的value
。如果您需要额外的角色或对某些角色有特定的行为,则重新实现此函数。将列表项的项标志设置为
flags
。也可参见
flags()
ItemFlags
将用于绘制项的字体设置为给定的
font
。也可参见
将列表项的前景色设置为指定的
brush
。设置默认构造的画刷将使视图使用样式中的默认颜色。- setHidden(hide)#
- 参数列表
hide – bool
如果
hide
为真,则隐藏项目;否则显示项目。也可参见
将列表项的图标设置为给定的
icon
。- setSelected(select)#
- 参数列表
select – bool
将项目的选择状态设置为
select
。也可参见
将列表项的大小提示设置为
size
。如果没有设置大小提示或size
无效,则项目代理将根据项目数据计算大小提示。也可参见
- setStatusTip(statusTip)#
- 参数列表
statusTip – str
将列表项的状态提示设置为
statusTip
指定的文本。需要启用QListWidget
的鼠标跟踪才能使用此功能。- setText(text)#
- 参数列表
text – str
将列表小部件项的文本设置为给定的
text
。也可参见
- setTextAlignment(alignment)#
- 参数列表
alignment –
AlignmentFlag
的组合
设置列表项的文本对齐方式为
alignment
。- setTextAlignment(alignment)
- 参数列表
alignment –
AlignmentFlag
- setTextAlignment(alignment)
- 参数列表
alignment – int
备注
此函数已弃用。
使用接受 Qt::Alignment 参数的重载版本。
设置列表项的文本对齐方式为
alignment
。也可参见
textAlignment()
Alignment
- setToolTip(toolTip)#
- 参数列表
toolTip – str
将列表项的工具提示设置为
toolTip
指定的文本。- setWhatsThis(whatsThis)#
- 参数列表
whatsThis – str
将列表项的 “这是什么?” 帮助信息设置为
whatsThis
指定的文本。返回为列表项设置的大小提示。
也可参见
- 状态提示()#
- 返回类型::
字符串
返回列表项的状态提示。
- 文本()#
- 返回类型::
字符串
返回列表项的文本。
也可参见
- 文本对齐()#
- 返回类型::
整数
返回列表项的文本对齐方式。
备注
此函数返回一个整数是出于历史原因。在Qt 7中,它将被更改为返回Qt::Alignment。
也可参见
对齐
- 工具提示()#
- 返回类型::
字符串
返回列表项的工具提示。
- 类型()#
- 返回类型::
整数
返回传递给
QListWidgetItem
构造函数的类型。- 这是什么?()#
- 返回类型::
字符串
返回列表项的“这是什么?”帮助文本。
- write(out)#
- 参数列表
out –
QDataStream
将项写入流
out
。也可参见