QListWidget详解

news2025/10/29 4:15:45

QListWidget详解

QListWidget 是 PyQt5 中一个方便的部件，用于创建和管理列表。它继承自 QListView，并提供了一些高级功能，使得添加和管理列表项更加简单。以下是 QListWidget 的详解，包括基本用法、主要方法和属性以及如何与其他组件进行交互的代码示例。

基本用法

导入模块 要使用 QListWidget，首先需要导入相关模块：

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

创建 QListWidget 实例 创建 QListWidget 的实例并添加列表项：
```
app = QApplication(sys.argv)
list_widget = QListWidget()
```

添加列表项 使用 addItem 方法添加单个列表项，或使用 addItems 方法添加多个列表项：

list_widget.addItem("Item 1")
list_widget.addItem("Item 2")
list_widget.addItems(["Item 3", "Item 4", "Item 5"])

显示窗口 设置窗口大小并显示：

list_widget.setWindowTitle("QListWidget Example")
list_widget.resize(300, 200)
list_widget.show()
sys.exit(app.exec_())

主要方法和属性

添加和删除项
- addItem(item): 添加单个列表项。
- addItems(items): 添加多个列表项。
- takeItem(row): 删除并返回指定行的列表项。
- clear(): 清空所有项。
项操作
- count(): 返回列表项的数量。
- item(row): 返回指定行的列表项。
- row(item): 返回指定列表项的行号。
- currentItem(): 返回当前选中的列表项。
- currentRow(): 返回当前选中项的行号。
- setCurrentItem(item): 设置当前选中的列表项。
- setCurrentRow(row): 设置当前选中的行。
信号和槽
- itemClicked(item): 单击列表项时发射信号。
- itemDoubleClicked(item): 双击列表项时发射信号。
- itemChanged(item): 列表项改变时发射信号。
- currentItemChanged(current, previous): 当前选中项改变时发射信号。

代码示例

以下是一个完整的示例，展示了如何使用 QListWidget 以及如何响应用户的交互：

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

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

    def initUI(self):
        self.setWindowTitle('QListWidget Demo')
        self.setGeometry(100, 100, 400, 300)

        self.list_widget = QListWidget(self)
        self.list_widget.addItems(["Item 1", "Item 2", "Item 3", "Item 4", "Item 5"])

        self.label = QLabel("Selected Item Info", self)

        layout = QVBoxLayout(self)
        layout.addWidget(self.list_widget)
        layout.addWidget(self.label)

        self.list_widget.itemClicked.connect(self.onItemClicked)

        self.setLayout(layout)

    def onItemClicked(self, item):
        self.label.setText(f"Selected: {item.text()}")

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