PyQt QListWidget详解|极客教程

PyQt QListWidget详解

PyQt是一个流行的Python库，用于创建图形用户界面（GUI）应用程序。QListWidget是PyQt中的一个重要部件，用于显示可滚动的列表视图。本文将详细介绍QListWidget的用法、属性和方法，以及一些示例代码展示如何使用QListWidget创建一个简单的GUI界面。

QListWidget简介

在PyQt中，QListWidget是一个用于显示列表视图的控件。它可以包含文本、图像或自定义的小部件。用户可以使用鼠标或键盘从列表中选择项目。QListWidget支持单选、多选和没有选择（不可选中）模式。

QListWidget的创建

要创建一个QListWidget，首先需要导入PyQt库，并创建一个QListWidget对象。然后可以使用addItem()方法向列表中添加项目，也可以使用setSelectionMode()方法设置选择模式。

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

app = QApplication(sys.argv)

list_widget = QListWidget()
list_widget.addItem('Item 1')
list_widget.addItem('Item 2')
list_widget.addItem('Item 3')

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

上面的代码创建了一个包含三个项目的QListWidget，并将其显示在屏幕上。运行代码后，会看到一个包含三个项目的列表。

QListWidget的属性和方法

QListWidget有许多属性和方法，用于设置和获取列表的状态、项目和样式。下面是一些常用的属性和方法：

currentRow: 获取当前选择的行号
currentItem: 获取当前选择的项目
count: 获取列表中项目的数量
addItem(): 向列表中添加项目
insertItem(): 在指定位置插入项目
takeItem(): 移除并返回指定位置的项目
clear(): 清空列表
setSelectionMode(): 设置选择模式

# 获取当前选择的行号
current_row = list_widget.currentRow()

# 获取当前选择的项目
current_item = list_widget.currentItem()

# 获取列表中项目的数量
item_count = list_widget.count()

# 在指定位置插入项目
list_widget.insertItem(1, 'New Item')

# 移除并返回指定位置的项目
removed_item = list_widget.takeItem(2)

# 清空列表
list_widget.clear()

# 设置选择模式为多选
list_widget.setSelectionMode(QListWidget.MultiSelection)

QListWidget的事件处理

QListWidget支持许多事件，可以在事件发生时执行相应的操作。可以使用connect()方法将事件处理程序绑定到特定事件。

def item_clicked(item):
    print(item.text() + ' clicked')

list_widget.itemClicked.connect(item_clicked)

上面的代码创建了一个item_clicked函数，用于处理itemClicked事件。当用户单击某个项目时，会打印出被单击的项目的文本。

QListWidget的样式设置

可以使用setStyleSheet()方法为QListWidget设置样式。

list_widget.setStyleSheet('background-color: lightblue; color: red;')

上面的代码将列表背景颜色设置为浅蓝色，文本颜色设置为红色。

QListWidget的示例

下面是一个简单的示例，展示了如何使用QListWidget创建一个包含多个项目和事件处理的GUI界面。

import sys
from PyQt5.QtWidgets import QApplication, QListWidget

app = QApplication(sys.argv)

list_widget = QListWidget()
list_widget.addItem('Apple')
list_widget.addItem('Banana')
list_widget.addItem('Orange')

def item_clicked(item):
    print(item.text() + ' clicked')

list_widget.itemClicked.connect(item_clicked)

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

运行上面的代码后，会看到一个包含三个水果名称的列表。当用户单击某个水果时，控制台会输出被单击的水果名称。