PyQt（Python+Qt）学习随笔：QListWidgetItem的重要方法

• 老猿Python博文目录
• 专栏：使用PyQt开发图形界面Python应用
• 老猿Python博客地址

QListWidgetItem类为QListWidget类提供构成QListWidget列表部件的项，每个列表部件的项都是一个QListWidgetItem对象。每个项可以保存多条信息，如显示文字、图标、toolTip、what’sThis、对齐方式、复选框等，并根据这些信息在列表部件中显示出来。除了《PyQt（Python+Qt）学习随笔：QListWidgetItem的构造方法》介绍的构造方法外，QListWidgetItem还有如下重要方法：

1、checkState和setCheckState方法

这两个方法用于访问或设置项的复选状态，调用语法分别如下：

• QListWidgetItem.setCheckState(Qt.CheckState state)
• Qt.CheckState QListWidgetItem.checkState()
  
  Qt.CheckState取值请参考《PyQt（Python+Qt）学习随笔：复选框状态枚举类Qt.CheckState取值及含义》。

2、icon和setIcon方法

这两个方法用于访问或设置项的图标，调用语法分别如下：

• QListWidgetItem.setIcon(QIcon icon)
• QIcon QListWidgetItem.icon()。

3、isHidden和setHidden方法

这两个方法用于访问或设置项的选中状态，调用语法分别如下：

• QListWidgetItem.setSelected(bool select)
• bool QListWidgetItem.isSelected()

4、text和setText方法

这两个方法用于访问或设置项的显示和编辑文本，调用语法分别如下：

• QListWidgetItem.setText(str)
• str QListWidgetItem.text()

5、flags和setFlags方法

这两个方法用于访问或设置项的标志，调用语法分别如下：

• QListWidgetItem.setFlags(Qt.ItemFlags flags)
• Qt.ItemFlags QListWidgetItem.flags()
  
  项的标志用于控制项的显示和操作，项的标记对应枚举类，具体取值及含义请参考《PyQt（Python+Qt）学习随笔：Model中项的标记flags取值及枚举类型Qt.ItemFlag》。

6、其他方法

其他方法包括用于访问状态提示的setStatusTip、statusTip方法，用于访问工具栏提示的 setToolTip、toolTip方法，用于访问WhatsThis提示的setWhatsThis、whatsThis方法，用于设置项对齐方式的setTextAlignment、textAlignment方法（关于对齐标记取值的含义请参考《PyQt(Python+Qt)学习随笔：formLayout的layoutLabelAlignment 属性》）以及访问项类型的type方法。

老猿Python，跟老猿学Python!

• 老猿Python博文目录
• 专栏：使用PyQt开发图形界面Python应用
• 老猿Python博客地址