Qt:QListWidgetItem

0、说明

一个QListWidgetItemQListWidget中的一项(一行)。

每个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、静态字段

enum ItemType { Type, UserType } Item的类型

 

ConstantValueDescription
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的帮助
posted @   ShineLe  阅读(4170)  评论(0编辑  收藏  举报
编辑推荐:
· 浏览器原生「磁吸」效果!Anchor Positioning 锚点定位神器解析
· 没有源码,如何修改代码逻辑?
· 一个奇形怪状的面试题:Bean中的CHM要不要加volatile?
· [.NET]调用本地 Deepseek 模型
· 一个费力不讨好的项目,让我损失了近一半的绩效!
阅读排行:
· PowerShell开发游戏 · 打蜜蜂
· 在鹅厂做java开发是什么体验
· 百万级群聊的设计实践
· WPF到Web的无缝过渡:英雄联盟客户端的OpenSilver迁移实战
· 永远不要相信用户的输入:从 SQL 注入攻防看输入验证的重要性
点击右上角即可分享
微信分享提示