PySide6.QtWidgets.QTableWidgetItem¶

class QTableWidgetItem¶

QTableWidgetItem 类提供了一个用于 QTableWidget 类的项目。更多…

概要¶

方法¶

def __init__()
def background()
def checkState()
def column()
def flags()
def font()
def foreground()
def icon()
def isSelected()
def row()
def setBackground()
def setCheckState()
def setFlags()
def setFont()
def setForeground()
def setIcon()
def setSelected()
def setSizeHint()
def setStatusTip()
def setText()
def setTextAlignment()
def setToolTip()
def setWhatsThis()
def sizeHint()
def statusTip()
def tableWidget()
def text()
def textAlignment()
def toolTip()
def type()
def whatsThis()

虚拟方法¶

def clone()
def data()
def __lt__()
def read()
def setData()
def write()

注意

本文档可能包含从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的新类型值调用基类构造函数。

另请参阅

QTableWidget 模型/视图编程 QListWidgetItem QTreeWidgetItem

class ItemType¶

(继承 enum.IntEnum) 此枚举描述了用于描述表格小部件项的类型。

常量

描述

QTableWidgetItem.Type

表格小部件项的默认类型。

QTableWidgetItem.UserType

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

常量	描述
QTableWidgetItem.Type	表格小部件项的默认类型。
QTableWidgetItem.UserType	自定义类型的最小值。低于UserType的值由Qt保留。

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

另请参阅

type()

__init__(other)¶

Parameters:: 其他 – QTableWidgetItem

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

这个函数在重新实现clone()时非常有用。

另请参阅

data() flags()

__init__([type=QTableWidgetItem.ItemType.Type])

Parameters:: 类型 – int

构造一个不属于任何表的指定type的表项。

另请参阅

type()

__init__(text[, type=QTableWidgetItem.ItemType.Type])

Parameters:

文本 – str
type – int

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

另请参阅

type()

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

Parameters:

图标 – QIcon
文本 – str
type – int

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

另请参阅

type()

background()¶

Return type:: QBrush

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

另请参阅

setBackground() foreground()

checkState()¶

Return type:: CheckState

返回表格项的选中状态。

另请参阅

setCheckState() flags()

clone()¶

Return type:: QTableWidgetItem

创建项目的副本。

column()¶

Return type:: 整数

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

另请参阅

row()

data(role)¶

Parameters:: 角色 – int
Return type:: 对象

返回给定role的项目数据。

另请参阅

setData()

flags()¶

Return type:: ItemFlag的组合

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

另请参阅

setFlags()

font()¶

Return type:: QFont

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

另请参阅

setFont()

foreground()¶

Return type:: QBrush

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

另请参阅

setForeground() background()

icon()¶

Return type:: QIcon

返回项目的图标。

另请参阅

setIcon() iconSize

isSelected()¶

Return type:: 布尔

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

另请参阅

setSelected()

__lt__(other)¶

Parameters:: 其他 – QTableWidgetItem
Return type:: 布尔

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

read(in)¶

Parameters:: in – QDataStream

从流 in 中读取项目。

另请参阅

write()

row()¶

Return type:: 整数

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

另请参阅

column()

setBackground(brush)¶

Parameters:: 画笔 – QBrush

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

另请参阅

background() setForeground()

setCheckState(state)¶

Parameters:: 状态 – CheckState

将表格项的检查状态设置为 state。

另请参阅

checkState()

setData(role, value)¶

Parameters:

role – int
value – 对象

将项目的role数据设置为指定的value。

注意

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

另请参阅

data()

setFlags(flags)¶

Parameters:: flags – ItemFlag 的组合

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

另请参阅

flags()

setFont(font)¶

Parameters:: 字体 – QFont

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

另请参阅

font() setText() setForeground()

setForeground(brush)¶

Parameters:: 画笔 – QBrush

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

另请参阅

foreground() setBackground()

setIcon(icon)¶

Parameters:: 图标 – QIcon

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

另请参阅

icon() setText() iconSize

setSelected(select)¶

Parameters:: select – 布尔值

将项目的选定状态设置为select。

另请参阅

isSelected()

setSizeHint(size)¶

Parameters:: 大小 – QSize

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

另请参阅

sizeHint()

setStatusTip(statusTip)¶

Parameters:: statusTip – str

将表格项的状态提示设置为由statusTip指定的文本。QTableWidget需要启用鼠标跟踪才能使此功能正常工作。

另请参阅

statusTip() setToolTip() setWhatsThis()

setText(text)¶

Parameters:: 文本 – str

将项目的文本设置为指定的text。

另请参阅

text() setFont() setForeground()

setTextAlignment(alignment)¶

Parameters:: alignment – AlignmentFlag 的组合

将项目的文本对齐方式设置为指定的alignment。

另请参阅

textAlignment()

setTextAlignment(alignment)

Parameters:: 对齐方式 – AlignmentFlag

setTextAlignment(alignment)

Parameters:: alignment – int

注意

此函数已弃用。

使用带有Qt::Alignment参数的函数重载。

将项目的文本对齐方式设置为指定的alignment。

另请参阅

Alignment

setToolTip(toolTip)¶

Parameters:: toolTip – str

将项目的工具提示设置为由toolTip指定的字符串。

另请参阅

toolTip() setStatusTip() setWhatsThis()

setWhatsThis(whatsThis)¶

Parameters:: whatsThis – str

将项目的“这是什么？”帮助设置为由whatsThis指定的字符串。

另请参阅

whatsThis() setStatusTip() setToolTip()

sizeHint()¶

Return type:: QSize

返回为表格项设置的大小提示。

另请参阅

setSizeHint()

statusTip()¶

Return type:: 字符串

返回项目的状态提示。

另请参阅

setStatusTip()

tableWidget()¶

Return type:: QTableWidget

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

text()¶

Return type:: 字符串

返回项目的文本。

另请参阅

setText()

textAlignment()¶

Return type:: 整数

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

注意

由于历史原因，此函数返回一个 int。它将在 Qt 7 中修正为返回 Qt::Alignment。

另请参阅

setTextAlignment() Alignment

toolTip()¶

Return type:: 字符串

返回项目的工具提示。

另请参阅

setToolTip()

type()¶

Return type:: 整数

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

whatsThis()¶

Return type:: 字符串

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

另请参阅

setWhatsThis()

write(out)¶

Parameters:: 输出 – QDataStream

将项目写入流 out。

另请参阅

read()