PyQt5 QListWidget – 获取选择行为

PyQt5 是 Python 语言的一个 GUI 库，其中 QListWidget 是一个非常常用的控件。在这里，我将详细讲解 PyQt5 QListWidget 如何获取选择行为，并提供两个示例。

获取选择行为

获取 QListWidget 中选中行的索引以及值，可以通过 QListWidget 的 currentIndex() 函数获得。 currentIndex() 函数返回了当前所选行的索引（QModelIndex 类型）。然后，通过调用 model() 和 data() 函数，我们可以获得当前所选行的值。最后，将所选行的值与索引一起作为元组返回。

下面是示例代码：

from PyQt5.QtWidgets import QApplication, QListWidget

app = QApplication([])
list_widget = QListWidget()
list_widget.addItems(['Item 1', 'Item 2', 'Item 3'])
list_widget.show()

def get_selected_item():
    """获取选中行的索引及值"""
    selected_item = list_widget.currentIndex()
    selected_index = selected_item.row()
    selected_value = list_widget.model().data(selected_item)
    print(f"Selected index is {selected_index} and value is {selected_value}")

list_widget.itemSelectionChanged.connect(get_selected_item)

app.exec_()

在这个示例中，我们创建了一个 QListWidget，其中包含了三个条目。我们还定义了一个名为 get_selected_item() 的函数，该函数通过 QListWidget 的 itemSelectionChanged 信号连接到 QListWidget 中。该函数获取用户选择的所选行的值和索引，并使用 print() 函数打印到控制台。

示例 1：禁用空白选择

在 PyQt5 QListWidget 中默认情况下，用户可以通过单击 QListWidget 空白的位置取消所选行。但有时候，可能需要禁用此功能。禁用空白行选择，可以通过以下代码实现：

from PyQt5.QtWidgets import QApplication, QListWidget

app = QApplication([])
list_widget = QListWidget()
list_widget.addItems(['Item 1', 'Item 2', 'Item 3'])
list_widget.setSelectionMode(QListWidget.SingleSelection)
list_widget.show()

def get_selected_item():
    """获取选中行的索引及值"""
    selected_item = list_widget.currentIndex()
    selected_index = selected_item.row()
    selected_value = list_widget.model().data(selected_item)
    print(f"Selected index is {selected_index} and value is {selected_value}")

list_widget.itemSelectionChanged.connect(get_selected_item)
list_widget.setSelectionBehavior(QListWidget.SelectRows)
app.exec_()

在这个示例中，我们添加了一行代码，即 list_widget.setSelectionBehavior(QListWidget.SelectRows)。此行代码将选择的行为限制为整行而不是单元格。这将禁用空白位置的选择。

示例 2：自定义 QListWidgetItem

有时候，需要在 QListWidget 中添加自定义的 QListWidgetItem，以便 将数据记录到 QListWidget 中。这些自定义 QListWidgetItem 可以在其中添加自定义 UI 控件。接下来是一个示例代码：

from PyQt5.QtWidgets import QApplication, QListWidget, QListWidgetItem, QCheckBox

app = QApplication([])
list_widget = QListWidget()

# 添加自定义 QListWidgetItem
item1 = QListWidgetItem()
item1_widget = QCheckBox('Item 1')
item1.setSizeHint(item1_widget.sizeHint())
list_widget.addItem(item1)
list_widget.setItemWidget(item1, item1_widget)

item2 = QListWidgetItem()
item2_widget = QCheckBox('Item 2')
item2.setSizeHint(item2_widget.sizeHint())
list_widget.addItem(item2)
list_widget.setItemWidget(item2, item2_widget)

item3 = QListWidgetItem()
item3_widget = QCheckBox('Item 3')
item3.setSizeHint(item3_widget.sizeHint())
list_widget.addItem(item3)
list_widget.setItemWidget(item3, item3_widget)

list_widget.show()

# 获取选中行的索引及值
def get_selected_item():
    selected_item = list_widget.currentIndex()
    selected_index = selected_item.row()

    item_widget = list_widget.itemWidget(list_widget.currentItem())
    selected_value = item_widget.text()

    print(f"Selected index is {selected_index} and value is {selected_value}")

list_widget.itemSelectionChanged.connect(get_selected_item)

app.exec_()

在此代码示例中，我们通过将 QCheckBox 控件添加到 QListWidgetItem widget 中实现了自定义 QListWidgetItem。然后，我们将 QWidget 设为 QListWidgetItem 的大小建议（即 setSizeHint(item_size)）。最后，我们将 QListWidgetItem 添加到 QListWidget 中，并使用 setItemWidget() 将自定义 QListWidgetItem 与实际的 QWidget 关联起来。注意，我们在获取所选行的索引和值时，需要使用 QListWidget 的 itemWidget() 函数来获取所选行的 widget。