QTableWidgetItem 类
QTableWidgetItem 类提供与 QTableWidget 类一起使用的项目。 更多信息...
头文件 | #include <QTableWidgetItem> |
CMake | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
qmake | QT += 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() |
QBrush | background() const |
Qt::CheckState | checkState() const |
virtual QTableWidgetItem * | clone() const |
int | column() const |
virtual QVariant | data(int role) const |
Qt::ItemFlags | flags() const |
QFont | font() const |
QBrush | foreground() const |
QIcon | icon() const |
bool | isSelected() const |
virtual void | read(QDataStream &in) |
int | row() const |
void | setBackground(const QBrush &brush) |
void | setCheckState(Qt::CheckState state) |
virtual void | setData(int role, const QVariant &value) |
void | setFlags(Qt::ItemFlags flags) |
void | setFont(const QFont &font) |
void | setForeground(const QBrush &brush) |
void | setIcon(const QIcon &icon) |
void | setSelected(bool select) |
void | setSizeHint(const QSize &size) |
void | setStatusTip(const QString &statusTip) |
void | setText(const QString &text) |
(自 6.4) void | setTextAlignment(Qt::Alignment alignment) |
void | setToolTip(const QString &toolTip) |
void | setWhatsThis(const QString &whatsThis) |
QSize | sizeHint() const |
QString | statusTip() const |
QTableWidget * | tableWidget() const |
QString | text() const |
int | textAlignment() const |
QString | toolTip() const |
int | type() const |
QString | whatsThis() const |
virtual void | write(QDataStream &out) const |
virtual bool | operator<(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、模型/视图编程、QListWidgetItem 和 QTreeWidgetItem。
成员类型说明文档
枚举 QTableWidgetItem::ItemType
此枚举描述用于描述表格小部件项的类型。
常量 | 值 | 描述 |
---|---|---|
QTableWidgetItem::Type | 0 | 表格小部件项的默认类型。 |
QTableWidgetItem::UserType | 1000 | 自定义类型的最低值。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)
构建带有给定 icon 和 text 的表格项。
另请参阅 type().
QTableWidgetItem::QTableWidgetItem(const QTableWidgetItem &other)
构建 other 的副本。注意,type() 和 tableWidget() 不会被复制。
此函数在重新实现 clone() 时很有用。
[虚函数 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
返回项的图标。
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::EditRole 和 Qt::DisplayRole 视为引用相同的数据。
另请参阅 Qt::ItemDataRole 和 data()。
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》鼠标跟踪需要启用才能使用此功能。
另请参阅 statusTip,setToolTip 和 setWhatsThis。
void QTableWidgetItem::setText(const QString &text)
将项的文本设置为指定的 text。
另请参阅 text,setFont 和 setForeground。
[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() 时很有用。
相关非成员
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公司在芬兰和/或其他国家的商标。所有其他商标均为其各自所有者的财产。