QListWidget

要自定义QListWidget的item，您可以继承QListWidgetItem类并实现自己的item。以下是一个简单的示例：

from PyQt5.QtWidgets import QListWidgetItem

class CustomListItem(QListWidgetItem):
    def __init__(self, text):
        super().__init__()
        self.setText(text)
        # 添加其他自定义内容

# 在QListWidget中添加自定义item
my_list_widget = QListWidget()
my_item = CustomListItem("自定义item")
my_list_widget.addItem(my_item)

在CustomListItem类中，我们重写了父类QListWidgetItem的构造函数，以设置我们的自定义文本和其他属性。在使用QListWidget时，我们可以像添加常规item一样添加CustomListItem。

相关问题

qlistwidget

QListWidget 是一个 Qt 框架中的控件，它提供了一个可滚动的列表视图，可以用来显示一组项目。你可以使用 QListWidget 来显示文本、图像、甚至是自定义的小部件。如果你想要在 QListWidget 中添加项目，可以使用 addItem() 方法。如果你想要在 QListWidget 中删除项目，可以使用 takeItem() 方法。如果你想要获取 QListWidget 中当前选中的项目，可以使用 currentItem() 方法。

pyhton QListWidget

### 关于 Python 中 QListWidget 的使用

#### 导入必要的模块
为了能够使用 `QListWidget` 及其关联组件，需先导入相应的库。这包括用于创建应用程序实例、窗口布局以及特定的小部件。

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

#### 创建基本的应用程序框架并初始化界面
构建一个简单的 GUI 应用来展示 `QListWidget` 的功能。这里定义了一个主窗口类 `_MainWindow` 继承自 `QWidget` 并设置了垂直布局来容纳列表控件和其他可能的子控件。

class _MainWindow(QWidget):
    def __init__(self):
        super().__init__()
        
        layout = QVBoxLayout()
        self.setLayout(layout)

        label = QLabel("This is a demo of QListWidget.")
        layout.addWidget(label)

        self.list_widget = QListWidget()
        layout.addWidget(self.list_widget)

if __name__ == '__main__':
    app = QApplication(sys.argv)
    
    window = _MainWindow()
    window.show()

    sys.exit(app.exec_())

#### 添加项至 QListWidget 和处理选择事件
向 `QListWidget` 插入条目可以通过调用 `addItem()` 方法实现；对于更复杂的场景，则可考虑使用 `setItemWidget()` 设置自定义 widget 显示样式[^1]。当用户点击某个项目时会触发内置信号如 `itemClicked`, 这允许开发者编写响应逻辑。

def add_items_to_listwidget(list_widget: QListWidget):
    items = ["Item 1", "Item 2", "Item 3"]
    for i in range(len(items)):
        item = QListWidgetItem(items[i])
        list_widget.addItem(item)


def handle_item_click(item: QListWidgetItem):
    print(f'You clicked on {item.text()}')

window.list_widget.itemClicked.connect(handle_item_click)
add_items_to_listwidget(window.list_widget)

#### 自定义行高以适应不同类型的 Widget
有时默认的高度不足以良好呈现内容，在这种情况下可通过给定的数据角色 (`SizeHintRole`) 对每行列进行个性化调整[^3]：

for index in range(window.list_widget.count()):
    item = window.list_widget.item(index)
    item.setSizeHint(QSize(100, 60))

#### 实现多选模式下的交互操作
通过设置属性 `setSelectionMode()` 改变选择行为（单选/多选），配合复选框或其他输入元件完成复杂的选择机制[^4]。下面的例子展示了如何监听复选框的状态变化，并收集所有已勾选项的信息。

list_widget.setSelectionMode(QAbstractItemView.MultiSelection)

checkboxes = []
for text in ("Option A", "Option B"):
    checkbox = QCheckBox(text)
    checkboxes.append(checkbox)
    listItem = QListWidgetItem()
    window.list_widget.setItemWidget(listItem, checkbox)

def collect_checked_options():
    checked_opts = [cb.text() for cb in checkboxes if cb.isChecked()]
    print('Checked options:', ', '.join(checked_opts))

# Connect the stateChanged signal to our handler function.
for chkbox in checkboxes:
    chkbox.stateChanged.connect(collect_checked_options)