PyQt QListView/QListWidget 自定义项和自定义项控件

在本文中，我们将介绍如何在 PyQt 中使用 QListView 和 QListWidget 来实现自定义项和自定义项控件的效果。

阅读更多：PyQt 教程

1. QListView

QListView 是一个用于显示列表视图的 Qt 控件。它以一种线性的方式展示数据，并且可以通过自定义项和自定义项控件来显示不同的数据。

1.1 添加项

我们首先来看一下如何向 QListView 中添加自定义项。

from PyQt5.QtWidgets import QApplication, QWidget, QVBoxLayout, QListView

app = QApplication([])
window = QWidget()

layout = QVBoxLayout()
list_view = QListView()

model = list_view.model()

# 添加项
model.appendRow(QStandardItem("Item 1"))
model.appendRow(QStandardItem("Item 2"))
model.appendRow(QStandardItem("Item 3"))

layout.addWidget(list_view)
window.setLayout(layout)
window.show()

app.exec_()

上述代码中，我们首先创建了一个 QListView 控件，并通过 list_view.model() 获取到了列表视图的模型。然后，我们向模型中添加了三个自定义项，分别是 “Item 1″、”Item 2” 和 “Item 3″。

1.2 显示项

通过上述代码中的方式添加的自定义项，默认是以文本的形式显示在 QListView 中的。如果我们想要显示一些自定义的内容，比如图标、图片或者其他的控件，可以通过自定义项和自定义委托来实现。

1.2.1 自定义项

自定义项是通过继承 QStandardItem 并实现 paint() 方法来创建的。下面是一个自定义项的示例代码：

from PyQt5.QtWidgets import QStandardItem, QApplication, QWidget, QVBoxLayout, QListView

class CustomItem(QStandardItem):
    def __init__(self, text):
        super().__init__(text)

    def paint(self, painter):
        # 自定义绘制代码
        pass

app = QApplication([])
window = QWidget()

layout = QVBoxLayout()
list_view = QListView()

model = list_view.model()

model.appendRow(CustomItem("Custom Item 1"))
model.appendRow(CustomItem("Custom Item 2"))
model.appendRow(CustomItem("Custom Item 3"))

layout.addWidget(list_view)
window.setLayout(layout)
window.show()

app.exec_()

上述代码中，我们创建了一个名为 CustomItem 的自定义项类，并重写了 paint() 方法。在 paint() 方法中，我们可以通过自定义的方式绘制项的内容。

1.2.2 自定义委托

自定义委托是一个用于根据项的内容和属性来绘制项的视觉表示的类。我们可以通过继承 QStyledItemDelegate 并重写 paint() 方法来创建自定义委托。下面是一个自定义委托的示例代码：

from PyQt5.QtWidgets import QStyledItemDelegate, QApplication, QWidget, QVBoxLayout, QListView

class CustomDelegate(QStyledItemDelegate):
    def __init__(self):
        super().__init__()

    def paint(self, painter, option, index):
        # 自定义绘制代码
        pass

app = QApplication([])
window = QWidget()

layout = QVBoxLayout()
list_view = QListView()

delegate = CustomDelegate()
list_view.setItemDelegate(delegate)

model = list_view.model()

model.appendRow(QStandardItem("Custom Delegate Item 1"))
model.appendRow(QStandardItem("Custom Delegate Item 2"))
model.appendRow(QStandardItem("Custom Delegate Item 3"))

layout.addWidget(list_view)
window.setLayout(layout)
window.show()

app.exec_()

上述代码中，我们创建了一个名为 CustomDelegate 的自定义委托类，并重写了 paint() 方法。在 paint() 方法中，我们可以通过自定义的方式绘制项的视觉表示。

2. QListWidget

QListWidget 是 QListView 的子类，它提供了一个列表视图，并且每个项都是可直接编辑的。

2.1 添加项

添加项到 QListWidget 中非常简单，只需使用 addItem() 方法即可。

from PyQt5.QtWidgets import QApplication, QListWidget, QWidget, QVBoxLayout

app = QApplication([])
window = QWidget()

layout = QVBoxLayout()
list_widget = QListWidget()

# 添加项
list_widget.addItem("Item 1")
list_widget.addItem("Item 2")
list_widget.addItem("Item 3")

layout.addWidget(list_widget)
window.setLayout(layout)
window.show()

app.exec_()

上述代码中，我们首先创建了一个 QListWidget 控件，并通过 addItem() 方法添加了三个项，分别是 “Item 1″、”Item 2” 和 “Item 3″。

2.2 显示项

在 QListWidget 中，默认情况下，项以文本的形式显示。如果要显示自定义内容，比如图标、图片或其他控件，可以通过自定义项和自定义委托来实现。

2.2.1 自定义项

自定义项是继承自 QListWidgetItem 并重写 paint() 方法来创建的。下面是一个自定义项的示例代码：

from PyQt5.QtWidgets import QApplication, QListWidget, QWidget, QVBoxLayout, QListWidgetItem

class CustomItem(QListWidgetItem):
    def __init__(self, text):
        super().__init__(text)

    def paint(self, painter):
        # 自定义绘制代码
        pass

app = QApplication([])
window = QWidget()

layout = QVBoxLayout()
list_widget = QListWidget()

list_widget.addItem(CustomItem("Custom Item 1"))
list_widget.addItem(CustomItem("Custom Item 2"))
list_widget.addItem(CustomItem("Custom Item 3"))

layout.addWidget(list_widget)
window.setLayout(layout)
window.show()

app.exec_()

上述代码中，我们创建了一个名为 CustomItem 的自定义项类，并重写了 paint() 方法。在 paint() 方法中，我们可以通过自定义的方式绘制项的内容。

2.2.2 自定义委托

自定义委托是根据项的内容和属性绘制项的视觉表示的类。我们可以继承 QStyledItemDelegate 并重写 paint() 方法来创建自定义委托。下面是一个自定义委托的示例代码：

from PyQt5.QtWidgets import QApplication, QListWidget, QWidget, QVBoxLayout, QStyledItemDelegate

class CustomDelegate(QStyledItemDelegate):
    def __init__(self):
        super().__init__()

    def paint(self, painter, option, index):
        # 自定义绘制代码
        pass

app = QApplication([])
window = QWidget()

layout = QVBoxLayout()
list_widget = QListWidget()

delegate = CustomDelegate()
list_widget.setItemDelegate(delegate)

list_widget.addItem("Custom Delegate Item 1")
list_widget.addItem("Custom Delegate Item 2")
list_widget.addItem("Custom Delegate Item 3")

layout.addWidget(list_widget)
window.setLayout(layout)
window.show()

app.exec_()

总结

本文介绍了如何使用 PyQt 中的 QListView 和 QListWidget 来实现自定义项和自定义项控件的效果。我们学习了如何向列表视图中添加项，并通过自定义项和自定义委托来显示不同的数据。通过自定义项和自定义委托，我们可以实现自定义的绘制方式，以达到更丰富的展示效果。希望本文能帮助您在 PyQt 中使用 QListView 和 QListWidget 实现自定义项和自定义项控件的功能。