PyQt QListWidget 和多重选择

在本文中，我们将介绍如何使用PyQt界面库的QListWidget控件来创建列表并实现多重选择的功能。

阅读更多：PyQt 教程

QListWidget简介

QListWidget是PyQt中一个非常有用的控件，它可以用于创建列表界面。它提供了一种简单的方法来显示和编辑列表数据。QListWidget可以显示文本、图像和自定义数据。

创建QListWidget

要创建一个QListWidget，我们首先需要创建一个Qt窗口，并在窗口上放置一个QListWidget控件。下面是一个简单的示例：

import sys
from PyQt5.QtWidgets import QApplication, QMainWindow, QListWidget, QListWidgetItem

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()

        self.list_widget = QListWidget(self)
        self.setCentralWidget(self.list_widget)

        self.init_ui()

    def init_ui(self):
        self.setWindowTitle("QListWidget and Multiple Selection")

        list_item = QListWidgetItem("Item 1")
        self.list_widget.addItem(list_item)

        list_item = QListWidgetItem("Item 2")
        self.list_widget.addItem(list_item)

        list_item = QListWidgetItem("Item 3")
        self.list_widget.addItem(list_item)


if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = MainWindow()
    window.show()
    sys.exit(app.exec_())

在这个示例中，我们首先创建了一个Qt窗口，并在窗口上放置了一个QListWidget控件。然后，我们使用addItem方法添加了三个列表项。

单选和多选

QListWidget提供了单选和多选的功能。默认情况下，QListWidget是单选模式，这意味着一次只能选择一个列表项。要启用多选模式，我们需要调用setSelectionMode方法，并将其参数设置为QListWidget.ExtendedSelection。下面是一个示例：

# ...

def init_ui(self):
    # ...

    self.list_widget.setSelectionMode(QListWidget.ExtendedSelection)

    list_item = QListWidgetItem("Item 1")
    self.list_widget.addItem(list_item)

    list_item = QListWidgetItem("Item 2")
    self.list_widget.addItem(list_item)

    list_item = QListWidgetItem("Item 3")
    self.list_widget.addItem(list_item)

在这个示例中，我们调用了setSelectionMode方法来启用多选模式。然后，我们可以使用鼠标单击并按住Ctrl键来选择多个列表项。

多重选择的操作

一旦启用了多重选择，我们可以以各种方式操作选择的列表项。下面是一些常用的操作：

获取选择的列表项

要获取选择的列表项，我们可以使用selectedItems方法。该方法返回一个列表，其中包含当前选择的所有列表项。每个列表项都是一个QListWidgetItem对象。下面是一个示例：

selected_items = self.list_widget.selectedItems()
for item in selected_items:
    print(item.text())

这个示例将打印出当前选择的所有列表项的文本。

获取选择的列表项索引

要获取选择的列表项的索引，我们可以使用selectedIndexes方法。该方法返回一个列表，其中包含当前选择的所有列表项的索引。每个索引都是一个QModelIndex对象。下面是一个示例：

selected_indexes = self.list_widget.selectedIndexes()
for index in selected_indexes:
    print(index.row())

这个示例将打印出当前选择的所有列表项的索引。

清除选择

要清除所有选择的列表项，我们可以使用clearSelection方法。下面是一个示例：

self.list_widget.clearSelection()

这个示例将清除所有选择的列表项。

删除选择的列表项

要删除选择的列表项，我们可以使用takeItem方法。该方法接受一个QListWidgetItem对象作为参数，然后从列表中将该项删除。下面是一个示例：

selected_items = self.list_widget.selectedItems()
for item in selected_items:
    self.list_widget.takeItem(self.list_widget.row(item))

这个示例将删除当前选择的所有列表项。

自定义列表项

除了显示文本，QListWidget还可以显示图像和自定义数据。要显示图像，我们可以使用setPixmap方法，并将其参数设置为QPixmap对象。要显示自定义数据，我们可以使用setData方法，并将其参数设置为我们想要存储的数据。下面是一个示例：

list_item = QListWidgetItem()
list_item.setText("Item 1")
list_item.setPixmap(QPixmap("image.png"))
list_item.setData(Qt.UserRole, "custom_data")
self.list_widget.addItem(list_item)

在这个示例中，我们首先创建了一个QListWidgetItem对象，并设置了文本。然后，使用setPixmap方法将图像指定为QPixmap对象。最后，使用setData方法将自定义数据存储在UserRole角色中。注意，我们需要先导入QPixmap和Qt模块。

要获取列表项的图像和自定义数据，我们可以使用text方法来获取文本，使用pixmap方法来获取图像，使用data方法来获取自定义数据。下面是一个示例：

selected_items = self.list_widget.selectedItems()
for item in selected_items:
    print(item.text())
    print(item.pixmap().toImage())  # 转换为QImage对象
    print(item.data(Qt.UserRole))

这个示例将打印出当前选择的列表项的文本、图像和自定义数据。

信号和槽

QListWidget提供了一些信号，可以在选择发生更改时触发。我们可以连接这些信号到槽函数，以执行相应的操作。下面是一些常用的信号：

itemSelectionChanged: 当选择发生更改时触发。
currentRowChanged: 当当前选择的行索引发生更改时触发。

下面是一个示例：

def init_ui(self):
    # ...

    self.list_widget.itemSelectionChanged.connect(self.handle_selection_change)
    self.list_widget.currentRowChanged.connect(self.handle_row_change)

def handle_selection_change(self):
    selected_items = self.list_widget.selectedItems()
    for item in selected_items:
        print(item.text())

def handle_row_change(self, current_row):
    print(current_row)

在这个示例中，我们首先将itemSelectionChanged信号连接到handle_selection_change函数，将currentRowChanged信号连接到handle_row_change函数。当选择发生更改时，将调用相应的槽函数。