PyQt5 QListWidget – 设置垂直滚动条

在PyQt5中，QListWidget是一种常用的列表控件，可以方便地呈现出一个列表，并且可以对其进行一系列的操作。其中一个重要的功能就是设置垂直滚动条，下面我将详细讲解如何使用PyQt5的QListWidget控件来设置垂直滚动条。

使用QListWidget设置垂直滚动条的步骤

1. 导入模块

在使用QListWidget控件前，需要导入PyQt5.QtWidgets模块。

from PyQt5.QtWidgets import QListWidget

1. 创建QListWidget控件

使用QListWidget控件前，需要先创建一个QListWidget类的对象。

list_widget = QListWidget()

1. 设置垂直滚动条

使用setVerticalScrollBarPolicy()方法可以设置QListWidget控件的垂直滚动条样式。PyQt5中提供了三种样式可以选择：Qt.ScrollBarAlwaysOff（关闭滚动条）、Qt.ScrollBarAsNeeded（根据内容自动显示或隐藏）和Qt.ScrollBarAlwaysOn（始终显示滚动条）。

list_widget.setVerticalScrollBarPolicy(Qt.ScrollBarAlwaysOn)

示例一

下面是一个简单的示例，演示如何在PyQt5中创建QListWidget控件并设置垂直滚动条。

import sys
from PyQt5.QtCore import Qt
from PyQt5.QtWidgets import QApplication, QMainWindow, QListWidget

class MainWindow(QMainWindow):

    def __init__(self):
        super().__init__()

        # 创建一个QListWidget控件
        list_widget = QListWidget(self)
        list_widget.setGeometry(50, 50, 200, 200)

        # 设置垂直滚动条
        list_widget.setVerticalScrollBarPolicy(Qt.ScrollBarAlwaysOn)

        # 添加一些列表项
        list_widget.addItem('item 1')
        list_widget.addItem('item 2')
        list_widget.addItem('item 3')
        list_widget.addItem('item 4')

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

在这个示例中，我们创建了一个QMainWindow窗口，并在其中创建了一个QListWidget控件，为其设置垂直滚动条，然后向其中添加了四个列表项。

示例二

下面是一个更加高级的示例，演示如何通过使用QListWidget控件来展示一些图片，并在图片下方展示图片的名称。

import sys
from PyQt5.QtCore import Qt
from PyQt5.QtGui import QPixmap
from PyQt5.QtWidgets import QApplication, QMainWindow, QListWidget, QListWidgetItem, QLabel, QVBoxLayout, QWidget

class MainWindow(QMainWindow):

    def __init__(self):
        super().__init__()

        # 创建一个QListWidget控件
        list_widget = QListWidget(self)
        list_widget.setGeometry(50, 50, 300, 300)

        # 设置垂直滚动条
        list_widget.setVerticalScrollBarPolicy(Qt.ScrollBarAlwaysOn)

        # 向列表中添加一些图片和名称
        file_list = [('image1.jpg', 'Image 1'), ('image2.jpg', 'Image 2'), ('image3.jpg', 'Image 3')]
        for filename, name in file_list:
            # 创建一个新的QListWidgetItem
            item = QListWidgetItem(list_widget)

            # 创建一个垂直布局
            layout = QVBoxLayout()

            # 添加一个QLabel，用于展示图片
            image_label = QLabel()
            pixmap = QPixmap(filename)
            pixmap = pixmap.scaledToWidth(250)
            image_label.setPixmap(pixmap)
            layout.addWidget(image_label)

            # 添加一个QLabel，用于展示图片的名称
            name_label = QLabel(name)
            layout.addWidget(name_label)

            # 将布局添加到QListWidgetItem中
            item.setSizeHint(layout.minimumSize())
            list_widget.addItem(item)
            list_widget.setItemWidget(item, QWidget(self, flags=Qt.Widget))

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

在这个示例中，我们向QListWidget控件中添加了三个图片和名称，其中每一个列表项都包含一个QVBoxLayout布局，该布局中包含一个展示图片的QLabel和一个展示名称的QLabel。同时，我们也为QListWidgetItem实现了最小的大小，以便显示出图片和名称的完整信息。当我们运行这个程序时，就可以在QListWidget控件中展示出三幅图片和对应的名称。