Qt:QListWidgetItem
0、说明
一个QListWidgetItem是QListWidget中的一项(一行)。
每个Item都可以持有多部分的信息,并将它们在适当时候展示出来。
在构造一个Item时指明它所在的List Widget,这个Item就会自动被插入到List中:
new QListWidgetItem(tr("Hazel"), listWidget);
也可以不指明List Widget,之后调用QListWidget::insertItem()手动插入List。
通常使用text()和icon()查看在List中展示一个Item的文本和图标,这两项是通过setText()和setIcon()进行设置的。文本属性是通过setFont()、setForeground()、setBackground()进行设置的。List中的Items通过setTextAlignment()进行对齐。工具提示(Tooltips)和状态提示(Status tips)通过setToolTip()、setStatusTip()进行设置。
默认情况下,Item是启用的、可选的、可检查的,并且可以进行拖放。
每个Item的标志可以通过调用setFlags()时传入合适的参数(参考Qt::ItemFlags)。
isHidden()函数可以判断Item是否被隐藏,为了隐藏一个Item,可以调用setHidden()。
1、模块和加载项
Header: | #include <QListWidgetItem> |
qmake: | QT += widgets |
2、构造
QListWidgetItem(QListWidgetItem other) | 另一个Item的副本 |
QListWidgetItem(QIcon icon, QString text, QListWidget *parent = nullptr, int type = Type) | 构造一个空Item,指定它显示的icon和text |
QListWidgetItem(QString text, QListWidget *parent = nullptr, int type = Type) | 构造一个空Item,指定它显示的text |
QListWidgetItem(QListWidget *parent = nullptr, int type = Type) | 构造一个空Item |
3、静态字段
Constant | Value | Description |
---|---|---|
QListWidgetItem::Type |
0 |
The default type for list widget items. |
QListWidgetItem::UserType |
1000 |
The minimum value for custom types. Values below UserType are reserved by Qt. |
6、实例方法
返回值类型 |
方法 |
说明 |
QBrush | background() | Item的背景色 |
Qt::CheckState | checkState() | Check State |
virtual QVariant | data(int role) | 返回给定Role下的Item的数据 |
Qt::ItemFlags | flags() | Item的flag,Qt::ItemFlags |
QFont | font() | 显示的字体 |
QBrush | foreground() | 字体颜色 |
QIcon | icon() | Icon |
bool | isHidden() | 该Item是否隐藏 |
bool | isSelected() | 是否可选 |
QListWidget * | listWidget() | Item所在的QListWidget |
void | setBackground(const QBrush &brush) | 设置背景色 |
setCheckState(Qt::CheckState state) | 设置Check State | |
setData(int role, const QVariant &value) | 设置Item中的数据,为给定的Role设置给定的Value | |
setFlags(Qt::ItemFlags flags) | 设置Item flags | |
setFont(const QFont &font) | 设置字体 | |
setForeground(const QBrush &brush) | 设置字体颜色 | |
setHidden(bool hide) | 是否隐藏该Item | |
setIcon(const QIcon &icon) | 设置Icon | |
setSelected(bool select) | 设置是否可选 | |
setSizeHint(const QSize &size) | 设置Item的size hint(没有用到过) | |
setStatusTip(const QString &statusTip) | 设置状态提示 | |
setText(const QString &text) | 设置显示文本 | |
setTextAlignment(int alignment) | 对齐 | |
setToolTip(const QString &toolTip) | 设置工具提示 | |
setWhatsThis(const QString &whatsThis) | 设置帮助 | |
QSize | sizeHint() | 返回Size Hint |
QString | statusTip() | 返回状态提示 |
QString | text() | 返回显示文本 |
int | textAlignment() | 返回文本对齐 |
QString | toolTip() | 返回工具提示 |
int | type() | 返回Item的Type |
QString | whatsThis() | 返回该Item的帮助 |
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】凌霞软件回馈社区,博客园 & 1Panel & Halo 联合会员上线
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】博客园社区专享云产品让利特惠,阿里云新客6.5折上折
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· 浏览器原生「磁吸」效果!Anchor Positioning 锚点定位神器解析
· 没有源码,如何修改代码逻辑?
· 一个奇形怪状的面试题:Bean中的CHM要不要加volatile?
· [.NET]调用本地 Deepseek 模型
· 一个费力不讨好的项目,让我损失了近一半的绩效!
· PowerShell开发游戏 · 打蜜蜂
· 在鹅厂做java开发是什么体验
· 百万级群聊的设计实践
· WPF到Web的无缝过渡:英雄联盟客户端的OpenSilver迁移实战
· 永远不要相信用户的输入:从 SQL 注入攻防看输入验证的重要性