PyQt5中QListWidgetItem控件交互、布局及遍历需求实现

需求1：按钮与Item点击事件处理 #

• 为每个按钮绑定点击槽函数，通过sender()获取触发点击的按钮，再通过父Widget找到同Item内的QLabel并打印其文本
• 给QListWidget绑定itemClicked信号，触发时获取当前选中Item对应的Widget，找到内部QLabel并打印文本

需求2：Item内布局调整 #

• 调整QHBoxLayout的添加顺序：先添加QLabel，再添加拉伸因子（addStretch()），最后添加QPushButton，实现标签居左、按钮居右的效果
• 设置布局间距（setSpacing(15)），让标签和按钮之间保留合适间隔
• 启用item.setSizeHint(widget.sizeHint())，确保Item尺寸适配内部Widget的布局

需求3：启动时遍历打印所有标签 #

• 在所有Item初始化完成后，循环遍历QListWidget的每一个Item，通过itemWidget()方法获取Item对应的Widget，找到内部QLabel并打印其文本

修改后的完整代码 #

import sys
from PyQt5.QtCore import *
from PyQt5.QtWidgets import *

class Widget(QWidget):
    def __init__(self, parent=None):
        super(Widget, self).__init__(parent)
        self.resize(400 , 600)

        self.menu_widget = QListWidget()
        self.menu_widget.setStyleSheet('''
            QListWidget {
                color: #FFFFFF;
                background-color: #33373B;
            }
            QListWidget::item {
                height: 50px;
            }
            QListWidget::item:selected {
                background-color: #2ABf9E;
            }
        ''')

        # 初始化10个Item
        for i in range(1,11):
            item = QListWidgetItem()
            widget = QWidget()
            widgetText = QLabel(f"label {i}")
            widgetButton = QPushButton(f"button {i}")
            widgetButton.setMinimumHeight(30)  # 调整按钮高度更美观

            # 绑定按钮点击事件
            widgetButton.clicked.connect(self.on_button_clicked)

            # 调整布局：标签居左，按钮居右，设置间隔
            widgetLayout = QHBoxLayout()
            widgetLayout.addWidget(widgetText)
            widgetLayout.addStretch()  # 拉伸因子，将按钮挤到右侧
            widgetLayout.addWidget(widgetButton)
            widgetLayout.setSpacing(15)  # 设置标签和按钮的间隔
            widgetLayout.setContentsMargins(10, 0, 10, 0)  # 调整内边距，避免内容贴边
            widget.setLayout(widgetLayout)

            item.setSizeHint(widget.sizeHint())  # 设置Item尺寸适配布局
            self.menu_widget.addItem(item)
            self.menu_widget.setItemWidget(item, widget)

        # 绑定Item点击事件
        self.menu_widget.itemClicked.connect(self.on_item_clicked)

        # 启动时遍历打印所有标签
        self.print_all_labels()

        layout = QVBoxLayout()
        layout.addWidget(self.menu_widget)
        self.setLayout(layout)

    def on_button_clicked(self):
        # 获取点击的按钮，找到父Widget内的QLabel
        button = self.sender()
        if button:
            widget = button.parent()
            label = widget.findChild(QLabel)
            if label:
                print(f"按钮点击：{label.text()}")

    def on_item_clicked(self, item):
        # 获取点击的Item对应的Widget，找到内部QLabel
        widget = self.menu_widget.itemWidget(item)
        label = widget.findChild(QLabel)
        if label:
            print(f"Item点击：{label.text()}")

    def print_all_labels(self):
        # 遍历所有Item，打印标签文本
        print("启动时所有标签：")
        for i in range(self.menu_widget.count()):
            item = self.menu_widget.item(i)
            widget = self.menu_widget.itemWidget(item)
            label = widget.findChild(QLabel)
            if label:
                print(label.text())

if __name__ == "__main__":
    app = QApplication(sys.argv)    
    w = Widget()
    w.show()    
    sys.exit(app.exec())

内容的提问来源于stack exchange，提问作者Mehdi