class QTableWidgetItem#

QTableWidgetItem 类提供了用于 QTableWidget 类的项目。 更多信息…

概述#

方法#

虚函数链接到本标题

注意

这份文档可能包含从C++自动翻译成Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题，也可以通过在https:/bugreports.qt.io/projects/PYSIDE创建工单的方式通知我们

详细介绍#

警告

本节包含从C++自动翻译成Python的代码片段，可能存在错误。

表格项用于存储表格小部件的信息片段。项目通常包含文本、图标或复选框

QTableWidgetItem 类是一个方便类，它取代了Qt 3中的 QTableItem 类。它提供了一个可以与 QTableWidget 类一起使用的项目。

顶级项在没有父项的情况下构建，然后根据行和列的编号对指定位置插入

newItem = QTableWidgetItem(tr("%1").arg(()
    pow(row, column+1)))
tableWidget.setItem(row, column, newItem)

每个项目都可以有自己的背景刷，可以通过 setBackground() 函数设置。当前背景刷可以通过 background() 找到。每个项目的文本标签可以使用自己的字体和画刷渲染。这些是通过 setFont() 和 setForeground() 函数指定的，并通过 font() 和 foreground() 读取。

默认情况下，项是启用的、可编辑的、可选择的、可勾选的，并且可以用作拖放操作的数据源和目标。可以通过调用setFlags()方法并传入适当的值来更改每个项的标志（参见Qt::ItemFlags）。可勾选项可以使用setCheckState()函数进行勾选和取消勾选。相关的checkState()函数表示当前项是否被勾选。

子类化

在使用QTableWidgetItem来提供自定义项时，可以为他们定义新类型，以便能将它们与标准项区分开来。需要此功能的子类的构造函数需要调用基类构造函数，并传递一个新类型值，此值等于或大于UserType 。

class ItemType#

(inherits enum.IntEnum) 此枚举描述了用于描述表格项的类型。

常量

描述

QTableWidgetItem.Type

表格项的默认类型。

QTableWidgetItem.UserType

自定义类型的最小值。低于UserType的值由Qt保留。

您可以在QTableWidgetItem的子类中定义新用户类型，以确保自定义项被特别处理。

另请参阅

type()

__init__(text[, type=QTableWidgetItem.ItemType.Type])#
参数：

  • text – str

  • type – int

使用给定的text构建一个表格项。

另请参阅

type()

__init__(icon, text[, type=QTableWidgetItem.ItemType.Type])
参数：

  • icon – QIcon

  • text – str

  • type – int

使用给定的icon和text构建表格项。

另请参阅

type()

__init__([type=QTableWidgetItem.ItemType.Type])
参数：

type – int

构建一个指定 type 的表项，该表项不属于任何表格。

另请参阅

type()

__init__(other)
参数：

other – QTableWidgetItem

构建 other 的副本。请注意，type() 和 tableWidget() 不会被复制。

此函数在重新实现 clone() 时很有用。

另请参阅

data() flags()

background()#
返回类型：

QBrush

返回用于渲染项背景的画笔。

checkState()#
返回类型：

CheckState

返回表项的勾选状态。

另请参阅

setCheckState() flags()

clone()#
返回类型：

QTableWidgetItem

创建项的副本。

column()#
返回类型：

int

返回项在表格中的列。如果项不在表中，此函数将返回 -1。

另请参阅

row()

data(role)#
参数：

role – int

返回类型：

object

返回给定 role 的项数据。

另请参阅

setData()

flags()#
返回类型：

结合 ItemFlag

返回用于描述项的标志。这些标志决定了该项是否可以勾选、编辑和选择。

另请参阅

setFlags()

font()#
返回类型：

QFont

返回用于渲染项文本的字体。

另请参阅

setFont()

foreground()#
返回类型：

QBrush

返回用于渲染项前景（例如文本）的画笔。

icon()#
返回类型：

QIcon

返回项的图标。

另请参阅

setIcon() iconSize

isSelected()#
返回类型：

bool

如果项被选中，则返回 true，否则返回 false。

另请参阅

setSelected()

__lt__(other)#
参数：

other – QTableWidgetItem

返回类型：

bool

如果项小于 other 项，则返回 true；否则返回 false。

read(in)#
参数：

in – QDataStream

从输入流 in 中读取项。

另请参阅

write()

row()#
返回类型：

int

返回项在表中的行。如果该项不在表中，此函数将返回 -1。

另请参阅

column()

setBackground(brush)#
参数：

brush – QBrush

将项的背景画笔设置为指定的 brush。设置默认构造的画笔将让视图使用默认的样式颜色。

setCheckState(state)#
参数：

state – CheckState

将表格项的复选状态设置为 state.

另请参阅

checkState()

setData(role, value)#
参数：

  • role – int

  • value – 对象

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

注意

默认实现将 Qt::EditRole 和 Qt::DisplayRole 视为指向相同的数据。

另请参阅

data()

setFlags(flags)#
参数：

flags – ItemFlag 的组合

将项的标志设置为给定的 flags。这些标志决定了项是否可以被选择或修改。

另请参阅

flags()

setFont(font)#
参数：

font – QFont

将用于显示项文本的字体设置为给定的 font。

setForeground(brush)#
参数：

brush – QBrush

将项的前景画刷设置为指定的 brush。设置默认构造的画刷将使视图使用默认颜色。

setIcon(icon)#
参数：

icon – QIcon

将项的图标设置为指定的 icon。

另请参阅

icon() setText() iconSize

setSelected(select)#
参数：

select – 布尔类型

将项的选择状态设置为 select。

另请参阅

isSelected()

setSizeHint(size)#
参数：

size – QSize

将表格项的大小提示设置为 size。如果未设置大小提示或 size 无效，项代理将根据项数据计算大小提示。

另请参阅

sizeHint()

setStatusTip(statusTip)#
参数：

statusTip – 字符串

将表格项的状态提示设置为通过 statusTip 指定的文本。启用 QTableWidget 鼠标跟踪才能使用此功能。

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 指定的字符串。

sizeHint()#
返回类型：

QSize

返回为表格项设置的尺寸提示。

另请参阅

setSizeHint()

statusTip()#
返回类型：

str

返回项目的状态提示。

另请参阅

setStatusTip()

tableWidget()#
返回类型：

QTableWidget

返回包含项的表格小部件。

text()#
返回类型：

str

返回项的文本。

另请参阅

setText()

textAlignment()#
返回类型：

int

返回项文本的对齐方式。

注意

出于历史原因，此函数返回 int。在 Qt 7 中它将被更正为返回 Qt::Alignment。

另请参阅

对齐方式

toolTip()#
返回类型：

str

返回项的工具提示。

另请参阅

setToolTip()

type()#
返回类型：

int

返回传递给QTableWidgetItem构造函数的类型。

whatsThis()#
返回类型：

str

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

另请参阅

setWhatsThis()

write(out)#
参数：

out - QDataStream

将项写入流 out。

另请参阅

read()