QListView是PyQt（包括PyQt5和PyQt6）中的一个强大控件，用于展示列表数据。它基于模型/视图/委托（Model/View/Delegate）架构，提供了灵活的数据展示和处理能力。以下是一个关于QListView的全面教程：

一、安装PyQt

首先，确保已经安装了PyQt5或PyQt6。如果没有安装，可以使用pip进行安装：

1. pip install PyQt5  # 或者 pip install PyQt6

复制代码

二、导入必要的模块

在使用QListView之前，需要导入必要的PyQt模块。例如：

1. import sys
   
2. from PyQt5.QtWidgets import QApplication, QListView, QWidget, QVBoxLayout  # PyQt5用户
   
3. # 或者
   
4. # from PyQt6.QtWidgets import QApplication, QListView, QWidget, QVBoxLayout  # PyQt6用户
   
5. from PyQt5.QtGui import QStandardItemModel, QStandardItem  # PyQt5用户，用于创建和管理模型中的数据
   
6. # 或者
   
7. # from PyQt6.QtCore import QStringListModel  # PyQt6用户，另一个常用的模型类

复制代码

三、创建QListView和模型

QListView本身不存储数据，而是通过与数据模型关联来展示数据。常用的数据模型有QStandardItemModel和QStringListModel。

使用QStandardItemModel

1. class ListViewExample(QWidget):
   
2.     def __init__(self):
   
3.         super().__init__()
   
4.         self.initUI()
   
5. 
   
6.     def initUI(self):
   
7.         self.listView = QListView(self)
   
8.         self.model = QStandardItemModel()
   
9.         
   
10.         # 添加一些项目到模型中
    
11.         items = ["Item 1", "Item 2", "Item 3", "Item 4"]
    
12.         for item in items:
    
13.             standardItem = QStandardItem(item)
    
14.             self.model.appendRow(standardItem)
    
15.         
    
16.         self.listView.setModel(self.model)
    
17.         
    
18.         layout = QVBoxLayout()
    
19.         layout.addWidget(self.listView)
    
20.         self.setLayout(layout)
    
21.         self.setWindowTitle('QListView Example')
    
22. 
    
23. # 主程序
    
24. if __name__ == '__main__':
    
25.     app = QApplication(sys.argv)
    
26.     ex = ListViewExample()
    
27.     ex.show()
    
28.     sys.exit(app.exec_())

复制代码

使用QStringListModel

1. import sys
   
2. from PyQt5.QtWidgets import QApplication, QMainWindow, QListView  # PyQt5用户
   
3. # 或者
   
4. # from PyQt6.QtWidgets import QApplication, QMainWindow, QListView  # PyQt6用户
   
5. from PyQt5.QtGui import QStringListModel  # PyQt5用户
   
6. # 或者
   
7. # from PyQt6.QtCore import QStringListModel  # PyQt6用户
   
8. 
   
9. app = QApplication(sys.argv)
   
10. main_window = QMainWindow()
    
11. main_window.setWindowTitle("QListView 示例")
    
12. main_window.setGeometry(100, 100, 400, 300)
    
13. 
    
14. list_view = QListView(main_window)
    
15. list_view.setGeometry(50, 50, 300, 200)
    
16. 
    
17. model = QStringListModel()
    
18. data = ["苹果", "香蕉", "橙子", "葡萄", "草莓"]
    
19. model.setStringList(data)
    
20. list_view.setModel(model)
    
21. 
    
22. main_window.show()
    
23. sys.exit(app.exec_())

复制代码

四、QListView的常用方法和信号


常用方法

• 1. setModel(Model)

  复制代码
  : 用来设置View所关联的Model。
  
• 1. selectedItem(n)

  复制代码
  : 选中Model中的条目n（注意：这个方法不是QListView的标准方法，可能是某些特定上下文或自定义扩展中的方法，标准方法是通过模型来获取选中项）。
  
• 1. isSelected()

  复制代码
  : 判断Model中的某条目是否被选中（同样，这个方法可能不是QListView的直接方法，而是通过模型来判断）。
  

常用信号

• 1. clicked

  复制代码
  : 当单击某项时发送。
  
• 1. doubleClicked

  复制代码
  : 当双击某项时发送。
  

五、自定义QListView

QListView支持自定义项的显示方式，这通常通过实现自定义的委托（QStyledItemDelegate或QItemDelegate）来完成。自定义委托可以重写

1. paint()

复制代码

和

1. sizeHint()

复制代码

方法来控制项的绘制和大小。

六、QListView的常用设置

• 设置项间距：
  1. setSpacing(int spacing)

  复制代码
• 设置显示模式：
  1. setViewMode(QListView.ViewMode mode)

  复制代码
  ，可以是列表模式（ListMode）或图标模式（IconMode）。
  
• 设置是否允许拖动：
  1. setDragEnabled(bool enable)

  复制代码
• 设置选择模式：
  1. setSelectionMode(QAbstractItemView.SelectionMode mode)

  复制代码
  ，可以是单选、多选等。
  

七、示例：添加、删除和排序功能

以下是一个包含添加、删除和排序功能的QListView示例：

1. import sys
   
2. from PyQt5.QtWidgets import QApplication, QWidget, QVBoxLayout, QListView, QPushButton, QMessageBox
   
3. from PyQt5.QtGui import QStandardItemModel, QStandardItem
   
4. 
   
5. class QListviewDemo(QWidget):
   
6.     def __init__(self, *args, **kwargs):
   
7.         super(QListviewDemo, self).__init__(*args, **kwargs)
   
8.         self.setWindowTitle("QListviewDemo")
   
9.         self.resize(400, 400)
   
10.         self.layout = QVBoxLayout(self)
    
11.         
    
12.         self.qlistview = QListView()
    
13.         self.layout.addWidget(self.qlistview)
    
14.         
    
15.         self.mode = QStandardItemModel(5, 1)
    
16.         for i in range(self.mode.rowCount()):
    
17.             item = QStandardItem("item%d" % i)
    
18.             self.mode.setItem(i, 0, item)
    
19.         self.mode.insertRow(5, QStandardItem("item0"))
    
20.         self.qlistview.setModel(self.mode)
    
21.         
    
22.         hlayout = QVBoxLayout()
    
23.         self.add_btn = QPushButton("增", clicked=self.on_add_btn_clicked)
    
24.         self.del_btn = QPushButton("删", clicked=self.on_del_btn_clicked)
    
25.         self.sort_btn = QPushButton("排序", clicked=self.on_sort_btn_clicked)
    
26.         
    
27.         hlayout.addWidget(self.add_btn)
    
28.         hlayout.addWidget(self.del_btn)
    
29.         hlayout.addWidget(self.sort_btn)
    
30.         self.layout.addLayout(hlayout)
    
31.         
    
32.     def on_add_btn_clicked(self):
    
33.         num = self.mode.rowCount()
    
34.         self.mode.appendRow(QStandardItem("item%d" % (num + 1)))
    
35.         
    
36.     def on_del_btn_clicked(self):
    
37.         num = self.mode.rowCount()
    
38.         if num > 0:
    
39.             self.mode.removeRow(num - 1)
    
40.         
    
41.     def on_sort_btn_clicked(self):
    
42.         self.mode.sort(0)
    
43. 
    
44. if __name__ == '__main__':
    
45.     app = QApplication(sys.argv)
    
46.     test = QListviewDemo()
    
47.     test.show()
    
48.     sys.exit(app.exec_())

复制代码

在这个示例中，我们创建了一个QListView，并为其添加了一个QStandardItemModel作为数据模型。然后，我们添加了三个按钮来实现添加、删除和排序功能。
总的来说，QListView是一个功能强大的控件，用于展示和操作列表数据。通过了解其基本原理和常用方法，可以轻松地将其集成到PyQt应用程序中。
到此这篇关于Python QListView教程的实现的文章就介绍到这了,更多相关Python QListView内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

来源：https://www.jb51.net/python/339869nu2.htm
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！