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方法。