快捷導(dǎo)航

Python QListView教程的實(shí)現(xiàn)

更新時(shí)間：2025年04月18日 09:49:21 作者：蠟筆小新星

QListView是PyQt中的一個(gè)強(qiáng)大控件,用于展示列表數(shù)據(jù),本文主要介紹了Python QListView教程的實(shí)現(xiàn),具有一定的參考價(jià)值,感興趣的可以了解一下

QListView是PyQt（包括PyQt5和PyQt6）中的一個(gè)強(qiáng)大控件，用于展示列表數(shù)據(jù)。它基于模型/視圖/委托（Model/View/Delegate）架構(gòu)，提供了靈活的數(shù)據(jù)展示和處理能力。以下是一個(gè)關(guān)于QListView的全面教程：

一、安裝PyQt

首先，確保已經(jīng)安裝了PyQt5或PyQt6。如果沒(méi)有安裝，可以使用pip進(jìn)行安裝：

pip install PyQt5  # 或者 pip install PyQt6

二、導(dǎo)入必要的模塊

在使用QListView之前，需要導(dǎo)入必要的PyQt模塊。例如：

import sys
from PyQt5.QtWidgets import QApplication, QListView, QWidget, QVBoxLayout  # PyQt5用戶(hù)
# 或者
# from PyQt6.QtWidgets import QApplication, QListView, QWidget, QVBoxLayout  # PyQt6用戶(hù)
from PyQt5.QtGui import QStandardItemModel, QStandardItem  # PyQt5用戶(hù)，用于創(chuàng)建和管理模型中的數(shù)據(jù)
# 或者
# from PyQt6.QtCore import QStringListModel  # PyQt6用戶(hù)，另一個(gè)常用的模型類(lèi)

三、創(chuàng)建QListView和模型

QListView本身不存儲(chǔ)數(shù)據(jù)，而是通過(guò)與數(shù)據(jù)模型關(guān)聯(lián)來(lái)展示數(shù)據(jù)。常用的數(shù)據(jù)模型有QStandardItemModel和QStringListModel。

使用QStandardItemModel

class ListViewExample(QWidget):
    def __init__(self):
        super().__init__()
        self.initUI()

    def initUI(self):
        self.listView = QListView(self)
        self.model = QStandardItemModel()
        
        # 添加一些項(xiàng)目到模型中
        items = ["Item 1", "Item 2", "Item 3", "Item 4"]
        for item in items:
            standardItem = QStandardItem(item)
            self.model.appendRow(standardItem)
        
        self.listView.setModel(self.model)
        
        layout = QVBoxLayout()
        layout.addWidget(self.listView)
        self.setLayout(layout)
        self.setWindowTitle('QListView Example')

# 主程序
if __name__ == '__main__':
    app = QApplication(sys.argv)
    ex = ListViewExample()
    ex.show()
    sys.exit(app.exec_())

使用QStringListModel

import sys
from PyQt5.QtWidgets import QApplication, QMainWindow, QListView  # PyQt5用戶(hù)
# 或者
# from PyQt6.QtWidgets import QApplication, QMainWindow, QListView  # PyQt6用戶(hù)
from PyQt5.QtGui import QStringListModel  # PyQt5用戶(hù)
# 或者
# from PyQt6.QtCore import QStringListModel  # PyQt6用戶(hù)

app = QApplication(sys.argv)
main_window = QMainWindow()
main_window.setWindowTitle("QListView 示例")
main_window.setGeometry(100, 100, 400, 300)

list_view = QListView(main_window)
list_view.setGeometry(50, 50, 300, 200)

model = QStringListModel()
data = ["蘋(píng)果", "香蕉", "橙子", "葡萄", "草莓"]
model.setStringList(data)
list_view.setModel(model)

main_window.show()
sys.exit(app.exec_())

四、QListView的常用方法和信號(hào)

常用方法

setModel(Model): 用來(lái)設(shè)置View所關(guān)聯(lián)的Model。
selectedItem(n): 選中Model中的條目n（注意：這個(gè)方法不是QListView的標(biāo)準(zhǔn)方法，可能是某些特定上下文或自定義擴(kuò)展中的方法，標(biāo)準(zhǔn)方法是通過(guò)模型來(lái)獲取選中項(xiàng)）。
isSelected(): 判斷Model中的某條目是否被選中（同樣，這個(gè)方法可能不是QListView的直接方法，而是通過(guò)模型來(lái)判斷）。

常用信號(hào)

clicked: 當(dāng)單擊某項(xiàng)時(shí)發(fā)送。
doubleClicked: 當(dāng)雙擊某項(xiàng)時(shí)發(fā)送。

五、自定義QListView

QListView支持自定義項(xiàng)的顯示方式，這通常通過(guò)實(shí)現(xiàn)自定義的委托（QStyledItemDelegate或QItemDelegate）來(lái)完成。自定義委托可以重寫(xiě)paint()和sizeHint()方法來(lái)控制項(xiàng)的繪制和大小。

六、QListView的常用設(shè)置

設(shè)置項(xiàng)間距：setSpacing(int spacing)
設(shè)置顯示模式：setViewMode(QListView.ViewMode mode)，可以是列表模式（ListMode）或圖標(biāo)模式（IconMode）。
設(shè)置是否允許拖動(dòng)：setDragEnabled(bool enable)
設(shè)置選擇模式：setSelectionMode(QAbstractItemView.SelectionMode mode)，可以是單選、多選等。

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

以下是一個(gè)包含添加、刪除和排序功能的QListView示例：

import sys
from PyQt5.QtWidgets import QApplication, QWidget, QVBoxLayout, QListView, QPushButton, QMessageBox
from PyQt5.QtGui import QStandardItemModel, QStandardItem

class QListviewDemo(QWidget):
    def __init__(self, *args, **kwargs):
        super(QListviewDemo, self).__init__(*args, **kwargs)
        self.setWindowTitle("QListviewDemo")
        self.resize(400, 400)
        self.layout = QVBoxLayout(self)
        
        self.qlistview = QListView()
        self.layout.addWidget(self.qlistview)
        
        self.mode = QStandardItemModel(5, 1)
        for i in range(self.mode.rowCount()):
            item = QStandardItem("item%d" % i)
            self.mode.setItem(i, 0, item)
        self.mode.insertRow(5, QStandardItem("item0"))
        self.qlistview.setModel(self.mode)
        
        hlayout = QVBoxLayout()
        self.add_btn = QPushButton("增", clicked=self.on_add_btn_clicked)
        self.del_btn = QPushButton("刪", clicked=self.on_del_btn_clicked)
        self.sort_btn = QPushButton("排序", clicked=self.on_sort_btn_clicked)
        
        hlayout.addWidget(self.add_btn)
        hlayout.addWidget(self.del_btn)
        hlayout.addWidget(self.sort_btn)
        self.layout.addLayout(hlayout)
        
    def on_add_btn_clicked(self):
        num = self.mode.rowCount()
        self.mode.appendRow(QStandardItem("item%d" % (num + 1)))
        
    def on_del_btn_clicked(self):
        num = self.mode.rowCount()
        if num > 0:
            self.mode.removeRow(num - 1)
        
    def on_sort_btn_clicked(self):
        self.mode.sort(0)

if __name__ == '__main__':
    app = QApplication(sys.argv)
    test = QListviewDemo()
    test.show()
    sys.exit(app.exec_())

在這里插入圖片描述