Python中的列表部件QListWidget详解

最新推荐文章于 2025-04-17 10:11:15 发布
最新推荐文章于 2025-04-17 10:11:15 发布
阅读量505 收藏 1
点赞数 1
CC 4.0 BY-SA版权
文章标签： python 数据库 开发语言 Python
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/CyberLancer/article/details/132750695
Python 专栏收录该内容
176 篇文章 ¥59.90 ¥99.00
订阅专栏
本文详细介绍了在Python PyQt中使用QListWidget部件的方法，包括创建部件、添加列表项、处理选中项以及设置图标和工具提示。通过示例代码展示了如何操作QListWidget，以实现列表数据的展示。

Python中的列表部件QListWidget详解

QListWidget是Qt框架中的一个常用部件，用于显示列表数据。在Python中，我们可以使用PyQt库来创建和操作QListWidget部件。本文将详细介绍QListWidget的使用方法，并提供相应的源代码示例。

  1. 创建QListWidget部件
    要创建一个QListWidget部件，我们首先需要导入PyQt库，并创建一个QListWidget对象。可以使用以下代码来实现：
from PyQt5.QtWidgets import QApplication, QListWidget, QListWidgetItem
import sys

app = QApplication(sys.argv)
listWidget <
了解本专栏 订阅专栏 解锁全文
PyQt入门学习：QListView应用及属性介绍
持续更新
05-31 335
在上面的代码中，我们创建了一个包含三个元素的字符串列表作为数据模型，并将其设置到 QListView 实例中。接着，我们将 QListView 实例添加到窗口布局中，并显示该窗口。在 PyQt 中，QListView 是一种常见的小部件，它用于显示列表数据。使用这些属性可以使 QListView 更加灵活多样，满足不同的需求。在上面的代码中，我们将选择模式设置为多选模式，禁用编辑触发器，启用拖拽和拖放指示器，并且禁用文本自动换行。首先，我们需要创建一个 QListView 实例，并且设置列表中的数据模型。
PyQt5 QListWidget 深度解析：列表框的完整指南
最新发布
啊渊的专栏
10-16 61
PyQt5 QListWidget 深度解析摘要 QListWidget 是 PyQt5 中强大的列表框控件，提供项目列表的高效管理。它具有以下核心特性： 项目中心设计：将每个列表项作为独立的 QListWidgetItem 对象管理，支持文本、图标和自定义数据 灵活操作：提供 addItem()、insertItem()、takeItem() 等方法进行动态项目增删 多种选择模式：支持单选(SingleSelection)、多选(MultiSelection)和扩展选择(ExtendedSelection
PyQt5——QListWidget（列表控件）
新手小白学习记录贴
01-30 4859
QListWidget列表控件，类似于QListView列表视图。支持鼠标拖放、复制、双击等操作。可以在列表中添加/删除条目，列表中的每个条目都是一个QListWidgetItem 对象。
pyqt5-列表（QListView和QListWidget）
m0_62653695的博客
07-09 3177
PyQt5提供了两种列表，分别是基于模型的ListView和基于项目的ListWidget,ListView是ListWidget的父类。使用ListView时需要先创建模型，然后再保存数据；而ListWidget内置一个数据存储模型QListWidgetItem,使用时不必自己建立模型，直接使用addItem或者addItems方法即可添加列表项。
PyQt5高级界面控件之QListWidget Python
AlianBlank的博客
09-06 647
在上述代码中，我们首先导入了所需的模块和类。最后，我们将列表控件添加到QWidget的布局中，并使用itemClicked信号连接到onItemClicked方法，以便在点击列表项时触发特定操作。在PyQt5中，QListWidget是一个强大的高级界面控件，用于显示一个可滚动的列表。在本文中，我们将探索如何使用PyQt5中的QListWidget控件，并提供相应的Python源代码示例。通过使用QListWidget控件，我们可以方便地创建和管理一个可滚动的列表，并对用户的选择做出响应。
PyQt学习笔记：使用QListWidgetItem构造方法的Python实现
.
07-15 806
在PyQt中，QListWidgetItem是一个常用的控件类，用于在QListWidget中显示一个项。上述示例中，我们创建了一个QListWidget控件，并通过创建QListWidgetItem对象来添加两个项。​ 创建一个与参数QListWidgetItem相同的项，并将其插入到parent列表控件中。​ 创建一个带有图标icon和文本text的项，并将其插入到parent列表控件中。​ 创建一个文本为text的项，并将其插入到parent列表控件中。方法将其添加到列表中。
QListWidget详解
Persus & Xie
05-28 955
QListWidget是 PyQt5 中一个方便的部件，用于创建和管理列表。它继承自QListView，并提供了一些高级功能，使得添加和管理列表项更加简单。以下是的详解，包括基本用法、主要方法和属性以及如何与其他组件进行交互的代码示例。
第二十一章、 Model/View便利类列表部件QListWidget详解
老猿Python
02-08 2084
列表部件（List Widget）对应类QListWidget，用于显示一些数据的列表，不支持多层级数据的显示。QListWidget显示的数据项都通过QListWidgetItem构建。 列表项可以在构造时直接添加到列表小部件： QListWidget类提供了一个基于项的列表小部件。 QListWidget是一个便利类，它提供了一个类似于QListView提供的列表视图，但是具有一个用于添加和删...
QListWidget类详细介绍（列表）
wanglaqqqq的博客
04-17 895
python。
QListWidget 类使用教程
m0_56208280的博客
10-24 1388
QListWidget是一个用于显示列表的Qt部件，它提供了一种方便的方式来管理和展示项目列表，并支持与这些项目相关的操作，如选择、拖放和排序。
PyQt5高级界面控件之QListWidget(三)
热门推荐
jia666666的博客
08-13 4万+
QListWidget 前言 QListWidget类是一个基于条目的接口，用于从列表中添加或删除条目，列表中的每个条目都是一个QListWidgetItem对象，QListWidget可以设置为多重选择 QListWidget类中常用的方法 方法 描述 addItem() 在列表中添加QListWidgetItem对象或字符串 addItems()...
PyQt5 QListWidget选择多项并返回的实例
09-19
今天小编就为大家分享一篇PyQt5 QListWidget选择多项并返回的实例，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
PyQt入门学习：掌握QListWidget的常用方法和应用场景
CodeHeroicX的博客
08-09 712
同时，由于QListWidget提供了方便的方法进行增删改查等操作，它也适合作为一种简单的交互方式，比如用户可以通过选中列表项，然后通过右键菜单来进行操作。QListWidget是Qt中一个非常方便的UI控件，可以用于展示列表数据，并提供一些方便的方法来进行操作。第一种方式传递一个整型参数row，表示需要删除的项在QListWidget中的行号。第一种方式直接传递一个QString类型的数据即可，该方法返回一个QListWidgetItem的指针，可以通过该指针获取添加项的一些属性。
python -- pyQt5 QListWidget-多重选择 QCheckBox-复选框
weixin_45939263的博客
01-12 2018
【代码】python -- pyQt5 QListWidget 多重选择。
Python-pyqt5之ListWidget：列表
m0_64335844的博客
10-20 1294
这是一种列表，当里面的列表项内容行数大于列表框的高度后，自动出现滚动条。用列表展示课程，双击选中后可以弹出提示框选择显示选择的内容。
Python编程实例-PyQt5 GUI编程-Widgets-QListWidget
视觉与物联智能
05-15 1505
QListWidget 类是一个基于项目的接口，用于从列表中添加或删除项目。 列表中的每个项目都是一个 QListWidgetItem 对象。 QListWidget 可以设置为多选。
用Python进行QListWidget列表排序
学习使你进步。
06-04 620
在PyQt应用程序中，我们经常需要使用QListWidget和QListWidgetItem进行列表操作。当列表内容较多时，如果能够将列表进行排序，可以更方便地查看和管理。现在，我们需要对这个列表进行排序。在PyQt中，QListWidget提供了一个sortingEnabled属性，该属性默认是关闭的。总之，sortingEnabled属性可以帮助我们轻松地实现PyQt应用程序中的列表排序功能，使我们更加高效地管理和查看列表内容。运行程序，可以看到列表已经按照字母顺序排序了。
第15.26节 PyQt(Python+Qt)入门学习：Model/View架构中的便利类QListWidget详解
老猿Python
02-12 2860
老猿Python博文目录 专栏：使用PyQt开发图形界面Python应用 老猿Python博客地址 一、概述 列表部件（List Widget）对应类QListWidget，是从QListView派生的类，用于显示一些数据的列表，不支持多层级数据的显示。QListWidget显示的数据项都通过QListWidgetItem构建。 QListWidget是一个便利类，它提供了一个类似于QList...
Python pyqt listwidget 单元格单击信号、双击信号以及其他功能整理
weixin_41657202的博客
08-30 1606
近期工作过程中的经验总结。
Qlistwidget
08-11
<think>我们正在处理关于QListWidget的使用问题。根据引用内容，用户提供了代码示例（引用[1]）和基本概念（引用[2]），以及生成UI文件的方法（引用[3]）。用户希望了解QListWidget的使用方法或相关问题。 根据引用[1]中的代码，我们看到如何创建一个QListWidgetItem，并在其中嵌入一个自定义的QWidget（包含一个图片和一个文本标签）。同时，还设置了项目的大小提示和布局。 根据引用[2]，QListWidget是一个用于显示列表的部件，可以显示文本、图像或自定义部件项，并支持选择、拖放和排序等操作。 引用[3]提到了如何将.ui文件和资源文件转换为.py文件，以及QListWidget的一些函数、虚函数、槽和信号。 因此，我们可以将回答分为以下几个部分： 1. QListWidget的基本介绍 2. 如何向QListWidget中添加项目（文本项、图标项、自定义控件项） 3. 常用操作（选择、拖放、排序等） 4. 信号与槽 5. 自定义列表项（重点，参考引用[1]的代码） 同时，根据系统指令，我们需要生成相关问题。 注意：在回答中，对于代码部分，我们将使用代码块，并确保独立公式使用$$...$$，行内公式使用$...$（但本问题可能较少涉及数学公式，所以主要注意代码格式）。 另外，在回答中引用的段落末尾添加引用标识，例如[^1]。 由于用户要求使用中文回答，并且结构清晰，我们将按照以下结构组织： ### QListWidget 使用方法 #### 1. QListWidget简介 QListWidget是Qt中用于显示项目列表的控件，每个项目可以是文本、图标或自定义的小部件[^2]。 #### 2. 添加项目 - **添加文本项**：使用`addItem()`方法添加文本项。 - **添加图标项**：使用`addItem()`添加一个带有图标的项，需要先创建一个QListWidgetItem并设置图标。 - **添加自定义控件项**：如引用[1]所示，创建一个QListWidgetItem和一个自定义的QWidget，然后使用`setItemWidget()`将控件设置到项目上。 示例代码（添加自定义控件项）： ```cpp // 创建列表项 QListWidgetItem *item = new QListWidgetItem; // 创建自定义控件 QWidget *widget = new QWidget; QVBoxLayout *widgetLayout = new QVBoxLayout; QLabel *imageLabel = new QLabel; QLabel *txtLabel = new QLabel(tr("%1").arg(image_name_list.at(i))); widget->setLayout(widgetLayout); widgetLayout->setMargin(0); widgetLayout->setSpacing(0); widgetLayout->addWidget(imageLabel); widgetLayout->addWidget(txtLabel); // 设置图片，并缩放 QPixmap pixmap("image.png"); if(pixmap.width()>150 || pixmap.height()>150) { pixmap = pixmap.scaled(150, 150, Qt::KeepAspectRatio); } imageLabel->setPixmap(pixmap); txtLabel->setFixedHeight(30); txtLabel->setWordWrap(true); // 设置列表项的大小提示 item->setSizeHint(QSize(150, 180)); // 根据自定义控件的大小设置 // 将列表项添加到列表控件 ui->listWidget->addItem(item); ui->listWidget->setItemWidget(item, widget); ``` 注意：在设置自定义控件时，必须为列表项设置合适的大小提示（`setSizeHint`），否则可能显示不全。 #### 3. 常用操作 - **选择模式**：通过`setSelectionMode()`设置选择模式（单选、多选等）。 - **拖放**：通过`setDragDropMode()`设置拖放模式。 - **排序**：通过`setSortingEnabled(true)`启用排序（默认升序）。 - **删除项目**：使用`takeItem(int row)`删除指定行项目。 #### 4. 信号与槽 QListWidget常用的信号： - `itemClicked(QListWidgetItem *item)`：当点击项目时触发。 - `itemDoubleClicked(QListWidgetItem *item)`：当双击项目时触发。 - `currentItemChanged(QListWidgetItem *current, QListWidgetItem *previous)`：当前项目改变时触发。 示例：连接itemClicked信号 ```cpp connect(ui->listWidget, &QListWidget::itemClicked, [](QListWidgetItem *item){ qDebug() << "Clicked item: " << item->text(); }); ``` #### 5. 自定义列表项 自定义列表项是QListWidget的高级用法，允许在列表项中嵌入任何控件（如按钮、进度条等）。关键步骤： 1. 创建QListWidgetItem。 2. 创建自定义的QWidget，并设置布局和子控件。 3. 为QListWidgetItem设置大小提示（必须）。 4. 使用`setItemWidget`将自定义控件设置到列表项上。 注意：自定义控件的内存管理由QListWidget负责，当项目被删除时，自定义控件也会被删除。 ### 相关问题 §§相关问题§§ 1. 如何在QListWidget中实现拖放重新排序？ 2. QListWidget和QListView有什么区别？ 3. 如何从QListWidget中删除选中的项目？ 4. 如何修改QListWidget中已有项目的自定义控件内容？</think>### QListWidget 使用方法详解 QListWidget 是 Qt 框架中用于显示和管理项目列表的核心控件，支持文本、图标和自定义控件嵌入。以下是关键功能实现方法： #### 1. **基本列表操作** ```cpp // 添加文本项 ui->listWidget->addItem("文本项1"); ui->listWidget->addItem("文本项2"); // 添加带图标项 QListWidgetItem* item = new QListWidgetItem(QIcon("icon.png"), "带图标项"); ui->listWidget->addItem(item); // 删除选中项 delete ui->listWidget->takeItem(ui->listWidget->currentRow()); ``` #### 2. **嵌入自定义控件** [^1] ```cpp QListWidgetItem* item = new QListWidgetItem; QWidget* widget = new QWidget; QVBoxLayout* layout = new QVBoxLayout(widget); QLabel* imageLabel = new QLabel; QLabel* textLabel = new QLabel("自定义项"); // 图片缩放（保持比例） QPixmap pixmap("image.png"); if(pixmap.width() > 150 || pixmap.height() > 150) { pixmap = pixmap.scaled(150, 150, Qt::KeepAspectRatio); } imageLabel->setPixmap(pixmap); // 布局设置 layout->setMargin(0); layout->setSpacing(0); layout->addWidget(imageLabel); layout->addWidget(textLabel); // 关键步骤 item->setSizeHint(QSize(150, 180)); // 必须设置项尺寸 ui->listWidget->addItem(item); ui->listWidget->setItemWidget(item, widget); // 关联控件 ``` #### 3. **常用功能配置** ```cpp // 启用多选 ui->listWidget->setSelectionMode(QAbstractItemView::MultiSelection); // 启用拖拽排序 ui->listWidget->setDragDropMode(QAbstractItemView::InternalMove); // 设置视图模式（图标/列表） ui->listWidget->setViewMode(QListView::IconMode); ``` #### 4. **信号处理** ```cpp // 项点击事件 connect(ui->listWidget, &QListWidget::itemClicked, [](QListWidgetItem* item){ qDebug() << "选中项:" << item->text(); }); // 双击事件 connect(ui->listWidget, &QListWidget::itemDoubleClicked, [](QListWidgetItem* item){ QMessageBox::information(this, "提示", "双击了: " + item->text()); }); ``` #### 5. **性能优化建议** 1. 对于大型数据集（>1000项），改用 `QListView` + 自定义模型 2. 使用 `setUniformItemSizes(true)` 提升渲染效率 3. 批量操作时用 `setUpdatesEnabled(false)` 暂停刷新 > 提示：在 Qt Designer 中可直接拖放 `QListWidget` 到界面，通过属性编辑器设置基础功能[^2]。使用 PySide 时，可通过 `pyside2-uic` 命令将 .ui 文件转换为 Python 代码[^3]。 --- ###
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符  | 博主筛选后可见
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值