QTableWidgetItem 类

QTableWidgetItem 类提供与 QTableWidget 类一起使用的项目。 更多信息...

头文件 #include <QTableWidgetItem>
CMakefind_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmakeQT += widgets

公共类型

枚举ItemType { Type, UserType }

公共函数

QTableWidgetItem(int type = Type)
QTableWidgetItem(const QString &text, int type = Type)
QTableWidgetItem(const QIcon &icon, const QString &text, int type = Type)
QTableWidgetItem(const QTableWidgetItem &other)
virtual~QTableWidgetItem()
QBrushbackground() const
Qt::CheckStatecheckState() const
virtual QTableWidgetItem *clone() const
intcolumn() const
virtual QVariantdata(int role) const
Qt::ItemFlagsflags() const
QFontfont() const
QBrushforeground() const
QIconicon() const
boolisSelected() const
virtual voidread(QDataStream &in)
introw() const
voidsetBackground(const QBrush &brush)
voidsetCheckState(Qt::CheckState state)
virtual voidsetData(int role, const QVariant &value)
voidsetFlags(Qt::ItemFlags flags)
voidsetFont(const QFont &font)
voidsetForeground(const QBrush &brush)
voidsetIcon(const QIcon &icon)
voidsetSelected(bool select)
voidsetSizeHint(const QSize &size)
voidsetStatusTip(const QString &statusTip)
voidsetText(const QString &text)
(自 6.4) voidsetTextAlignment(Qt::Alignment alignment)
voidsetToolTip(const QString &toolTip)
voidsetWhatsThis(const QString &whatsThis)
QSizesizeHint() const
QStringstatusTip() const
QTableWidget *tableWidget() const
QStringtext() const
inttextAlignment() const
QStringtoolTip() const
inttype() const
QStringwhatsThis() const
virtual voidwrite(QDataStream &out) const
virtual booloperator<(const QTableWidgetItem &other) const
QTableWidgetItem &operator=(const QTableWidgetItem &other)
QDataStream &operator<<(QDataStream &out, const QTableWidgetItem &item)
QDataStream &operator>>(QDataStream &in, QTableWidgetItem &item)

详细描述

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

QTableWidgetItem 类是一个方便类,用于替换 Qt 3 中的 QTableItem 类。它为与 QTableWidget 类一起使用提供了项目。

顶级项目在没有父项目的情况下构建,然后根据行和列数字对指定的位置插入

    QTableWidgetItem *newItem = new QTableWidgetItem(tr("%1").arg(
        pow(row, column+1)));
    tableWidget->setItem(row, column, newItem);

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

默认情况下,项目是启用的、可编辑的、可选择的、可复选的,可以同时用作拖放操作的数据源和目标。可以通过调用 setFlags() 并使用适当的值(见 Qt::ItemFlags)来更改每个项目的标志。可复选项目可以通过 setCheckState() 函数进行检查和取消检查。相应的 checkState() 函数指示项目当前是否被选中。

子类化

当子类化之手表项目提供自定义项时,可以定义它们的新类型,以便它们可以与标准项目区分开来。需要此功能的子类的构造函数需要使用等于或大于 UserType 的新类型值调用基类构造函数。

另请参阅QTableWidget模型/视图编程QListWidgetItemQTreeWidgetItem

成员类型说明文档

枚举 QTableWidgetItem::ItemType

此枚举描述用于描述表格小部件项的类型。

常量描述
QTableWidgetItem::Type0表格小部件项的默认类型。
QTableWidgetItem::UserType1000自定义类型的最低值。UserType 以下的值由 Qt 保留。

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

另请参阅 type().

成员函数文档

[显式] QTableWidgetItem::QTableWidgetItem(int type = Type)

构建指定 type 的表格项,这些项不属于任何表格。

另请参阅 type().

[显式] QTableWidgetItem::QTableWidgetItem(const QString &text, int type = Type)

构建带有给定 text 的表格项。

另请参阅 type().

[显式] QTableWidgetItem::QTableWidgetItem(const QIcon &icon, const QString &text, int type = Type)

构建带有给定 icontext 的表格项。

另请参阅 type().

QTableWidgetItem::QTableWidgetItem(const QTableWidgetItem &other)

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

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

另请参阅 data() 和 flags().

[虚函数 noexcept] QTableWidgetItem::~QTableWidgetItem()

销毁表格项。

QBrush QTableWidgetItem::background() const

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

另请参阅 setBackground() 和 foreground().

Qt::CheckState QTableWidgetItem::checkState() const

返回表格项的选中状态。

另请参阅 setCheckState() 和 flags().

[虚函数] QTableWidgetItem *QTableWidgetItem::clone() const

创建项的副本。

int QTableWidgetItem::column() const

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

另请参阅 row().

[虚拟] QVariant QTableWidgetItem::data(int role) const

根据给定的role返回项的数据。

另请参阅setData()。

Qt::ItemFlags QTableWidgetItem::flags() const

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

另请参阅setFlags()。

QFont QTableWidgetItem::font() const

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

另请参阅setFont()。

QBrush QTableWidgetItem::foreground() const

返回用于渲染项前景(例如文本)的刷子。

另请参阅setForeground() 和background()。

QIcon QTableWidgetItem::icon() const

返回项的图标。

另请参阅setIcon() 和 iconSize

bool QTableWidgetItem::isSelected() const

如果项被选择,则返回true,否则返回false

另请参阅setSelected()。

[虚拟] void QTableWidgetItem::read(QDataStream &in)

从流in中读取项。

另请参阅write()。

int QTableWidgetItem::row() const

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

另请参阅column()。

void QTableWidgetItem::setBackground(const QBrush &brush)

将项的背景刷设置为指定的brush。如果设置了默认构造的刷子,则允许视图使用样式中的默认颜色。

另请参阅background() 和 setForeground()。

void QTableWidgetItem::setCheckState(Qt::CheckState state)

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

另请参阅checkState()。

[虚拟] void QTableWidgetItem::setData(int role, const QVariant &value)

将给定role的项数据设置指定的value

注意: 默认实现将 Qt::EditRoleQt::DisplayRole 视为引用相同的数据。

另请参阅 Qt::ItemDataRoledata()。

void QTableWidgetItem::setFlags(Qt::ItemFlags flags)

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

另请参阅 flags()。

void QTableWidgetItem::setFont(const QFont &font)

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

另请参阅 font(),setText() 和 setForeground()。

void QTableWidgetItem::setForeground(const QBrush &brush)

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

另请参阅 foreground() 和 setBackground()。

void QTableWidgetItem::setIcon(const QIcon &icon)

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

另请参阅 icon(),setText() 和 iconSize

void QTableWidgetItem::setSelected(bool select)

将项的选择状态设置为 select

另请参阅 isSelected()。

void QTableWidgetItem::setSizeHint(const QSize &size)

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

另请参阅 sizeHint()。

void QTableWidgetItem::setStatusTip(const QString &statusTip)

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

另请参阅 statusTipsetToolTipsetWhatsThis

void QTableWidgetItem::setText(const QString &text)

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

另请参阅 textsetFontsetForeground

[since 6.4] void QTableWidgetItem::setTextAlignment(Qt::Alignment alignment)

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

此函数自 Qt 6.4 开始引入。

void QTableWidgetItem::setToolTip(const QString &toolTip)

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

另请参阅 toolTip(),setStatusTip() 和 setWhatsThis()。

void QTableWidgetItem::setWhatsThis(const QString &whatsThis)

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

另请参阅 whatsThis(),setStatusTip() 和 setToolTip()。

QSize QTableWidgetItem::sizeHint() const

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

另请参阅 setSizeHint()。

QString QTableWidgetItem::statusTip() const

返回项的状态提示。

另请参阅 setStatusTip()。

QTableWidget *QTableWidgetItem::tableWidget() const

返回包含项的表格控件。

QString QTableWidgetItem::text() const

返回项的文本。

另请参阅 setText()。

int QTableWidgetItem::textAlignment() const

返回项文本的对齐方式。

注意:此函数返回一个整数是为了历史原因。在 Qt 7 中它将改为返回 Qt::Alignment

另请参阅 Qt::Alignment

QString QTableWidgetItem::toolTip() const

返回项的工具提示。

另请参阅 setToolTip()。

int QTableWidgetItem::type() const

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

QString QTableWidgetItem::whatsThis() const

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

另请参阅 setWhatsThis()。

[虚拟] void QTableWidgetItem::write(QDataStream &out) const

将项写入到流 out 中。

另请参阅 read().

[虚拟] bool QTableWidgetItem::operator<(const QTableWidgetItem &other) const

如果项小于其他项,则返回 true;否则返回 false。

QTableWidgetItem &QTableWidgetItem::operator=(const QTableWidgetItem &other)

将 other 的数据和标志分配给此项。请注意,type() 和 tableWidget() 不会被复制。

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

另请参阅 data() 和 flags().

相关非成员

QDataStream &operator<<(QDataStream &out, const QTableWidgetItem &item)

将表格项 item 写入输出流 out

此操作员使用 QTableWidgetItem::write

另请参阅 序列化 Qt 数据类型.

QDataStream &operator>>(QDataStream &in, QTableWidgetItem &item)

从输入流 in 读取表格项到 item

此操作员使用 QTableWidgetItem::read

另请参阅 序列化 Qt 数据类型.

© 2024 Qt 公司。在此处包含的文档贡献的版权归其各自的所有者。此处提供的文档是根据Free Software Foundation出版的《GNU自由文档许可证》第1.3版许可的。Qt及其相关标志是Qt公司在芬兰和/或其他国家的商标。所有其他商标均为其各自所有者的财产。