QListView简介

QListView列表视图可以用来以列表的形式来展示数据。在Qt中使用Model-View结构来处理数据与视图之间的关系，Model负责数据的存取，View负责数据的展示, 二者之间数据的交互则是通过委托(delegate)来实现。

QT提供了一些现成的models用于处理数据项：

• QStringListModel 用于存储简单的QString列表；
• StandardItemModel 管理复杂的树型结构数据项，每项都可以包含任意数据；
• QDirModel 提供本地文件系统中的文件与目录信息；
• QSqlQueryModel, QSqlTableModel,QSqlRelationTableModel用来访问数据库；

QListView是Model-View框架中的一个类，是Qt Model-View框架的组成部分，QListView实现了QAbstractItemView类定义的接口，以使其能够显示从QAbstractItemModel类派生的模型提供的数据。

QListView常用方法:

• setModel()： 用来设置View所关联的Model，可以使用Python原生的list作为数据源Model；
• selectedItem()： 选中Model的条目；
• isSelected()： 判断Model中的某条目是否被选中；
• setViewMode()： 设置视图模式。（ListMode： 条目从上到下布局，小尺寸显示， IconMode： 条目从左到右布局，大尺寸显示）

QListView常用信号：

• clicked： 单击某项时，发射此信号；
• doubleClicked： 双击击某项时，发射此信号；
• activated： 当用户激活index指定的项目时，发射此信号；
• entered： 当鼠标光标进入index指定的项目时，发射此信号；
• iconSizeChanged： 在视图可见时设置此图标大小时，发射此信号；
• indexesMoved： 在视图中移动索引时，发射此信号；
• pressed： 按下鼠标按钮时，发射此信号；
• viewportEntered： 当鼠标光标进入视图时，发射此信号。

QListView类继承关系:

测试QListView

使用QStandardItemModel作为QListView 所使用的模型，在QStandardItemModel中每个QStandardItem条目添加一个图标和文本。完整代码如下:

importsys,os
fromPyQt5importQtCore,QtGui,QtWidgets
fromPyQt5.QtCoreimportQt
fromPyQt5.QtGuiimportQIcon,QStandardItem,QStandardItemModel
fromPyQt5.QtWidgetsimport(QApplication,QWidget,QListView,
QLabel,QVBoxLayout)

classDemoListView(QWidget):
def__init__(self,parent=None):
super(DemoListView,self).__init__(parent)

#设置窗口标题
self.setWindowTitle('实战PyQt5:QListViewDemo!')
#设置窗口大小
self.resize(480,360)

self.initUi()

definitUi(self):
vLayout=QVBoxLayout(self)

lv=QListView(self)
slm=QStandardItemModel()
self.sports=[
{'img':'/images/basketball.png','title':'篮球'},
{'img':'/images/football.png','title':'足球'},
{'img':'/images/rugby-ball.png','title':'橄榄球'},
{'img':'/images/valley-ball.png','title':'排球'}
]

forsportinself.sports:
item=QStandardItem(QIcon(os.path.dirname(__file__)+sport['img']),sport['title'])
slm.appendRow(item)

lv.setModel(slm)
lv.clicked.connect(self.onListViewClicked)
self.label=QLabel(self)

vLayout.addWidget(lv)
vLayout.addWidget(self.label)

self.setLayout(vLayout)

#设置选中第一行
lv.setCurrentIndex(slm.index(0,0))
self.label.setText('当前选择为:'+self.sports[0]['title'])

defonListViewClicked(self,index):
#显示选中的x信息
self.label.setText('当前选择为:'+self.sports[index.row()]['title'])

if__name__=='__main__':
app=QApplication(sys.argv)
window=DemoListView()
window.show()
sys.exit(app.exec())

运行结果如下图：

测试QListView

本文知识点

• 使用QStandardItemModel作为视图的模型;
• 使用QStandItem为QStandardItemModel添加条目;
• 为QStandItem条目添加一个图标和文字信息。