QListWidget 列表选择框

最新推荐文章于 2024-05-17 19:33:12 发布
最新推荐文章于 2024-05-17 19:33:12 发布
阅读量988 收藏
点赞数
分类专栏： QT6教学 文章标签： python pyqt
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/z3831583/article/details/129851550
版权

QListWidget 列表选择框

QListWidget 是 PyQt6 里的列表选择框控件，这篇教学会介绍如何在 PyQt6 窗口里加入 QListWidget 列表选择框，并简单介绍与 QListView 的差异，并实作修改样式以及点击选项等基本应用。

快速导览：

  • QListWidget 和 QListView 的差异

  • 加入 QListWidget 列表选择框

  • QListWidget删除选项、添加选项、修改选项

  • QListWidget 样式设定

  • QListWidget 常用方法

  • 显示 QListWidget 选择项目

QListWidget 和 QListView 的差异

QListWidget 是一个更新且更高级的控件，能够更为方便地进行开发，例如 QListWidget 具有 QStantandardItemModel 无法访问的类型，也能更轻松的透过 QListWidgetItem 处理数据，然而如果使用 QListView，许多方法必须要额外定义，属于比较旧的使用方式。

下方列出两个方法所建立简单列表选单的程序，可以看出使用 QListWidget 的程序更容易阅读理解：

 from PyQt6 import QtWidgets, QtCore
 import sys
 app = QtWidgets.QApplication(sys.argv)
 ​
 Form = QtWidgets.QWidget()
 Form.setWindowTitle('千牛编程思维')
 Form.resize(300, 200)
 ​
 # 使用 QListView
 listview = QtWidgets.QListView(Form)
 listview.setGeometry(10,10,120,100)
 model = QtCore.QStringListModel()
 model.setStringList(['A','B','C','D'])  # 使用 QtCore.QStringListModel() 建立选项
 listview.setModel(model)
 ​
 # 使用 QListWidget
 listwidget = QtWidgets.QListWidget(Form)
 listwidget.setGeometry(140,10,120,100)
 listwidget.addItems(['A','B','C','D'])  # 使用 addItems 建立选项
 ​
 Form.show()
 sys.exit(app.exec())

加入 QListWidget 列表选择框

建立 PyQt6 窗口物件后，透过 QtWidgets.QListWidget(widget)方法，就能在指定的控件中建立列表选择框，接著使用 addItems()方法加入列表项目，下方的程序执行后，会在窗口里加入一个有四个项目的列表选择框。

 from PyQt6 import QtWidgets
 import sys
 app = QtWidgets.QApplication(sys.argv)
 ​
 Form = QtWidgets.QWidget()
 Form.setWindowTitle('千牛编程思维')
 Form.resize(300, 200)
 ​
 listwidget = QtWidgets.QListWidget(Form)  # 建立列表選擇框控件
 listwidget.addItems(['A','B','C','D'])    # 建立选项
 listwidget.setGeometry(10,10,120,100)    # 设定位置
 ​
 Form.show()
 sys.exit(app.exec())

class 写法：

 from PyQt6 import QtWidgets
 import sys
 ​
 class MyWidget(QtWidgets.QWidget):
     def __init__(self):
         super().__init__()
         self.setWindowTitle('千牛编程思维')
         self.resize(300, 200)
         self.ui()
 ​
     def ui(self):
         self.listwidget = QtWidgets.QListWidget(self)  # 建立列表選擇框控件
         self.listwidget.addItems(['A','B','C','D'])    # 建立选项
         self.listwidget.setGeometry(10,10,120,100)     # 设定位置
 ​
 if __name__ == '__main__':
     app = QtWidgets.QApplication(sys.argv)
     Form = MyWidget()
     Form.show()
     sys.exit(app.exec())

QListWidget 删除选项

使用使用takeItem(index)取得指定的项目，index 表示该项目的索引值，第一个项目为 0，取得项目后，就能透过removeItemWidge(item)方法移除该项目，下方的程序执行后，会将项目里的 B 移除。

 from PyQt6 import QtWidgets
 import sys
 app = QtWidgets.QApplication(sys.argv)
 ​
 Form = QtWidgets.QWidget()
 Form.setWindowTitle('千牛编程思维')
 Form.resize(300, 200)
 ​
 listwidget = QtWidgets.QListWidget(Form)
 listwidget.addItems(['A','B','C','D'])
 listwidget.setGeometry(10,10,120,100)
 item = listwidget.takeItem(1)       # 取得第二个项目，也就是 B
 listwidget.removeItemWidget(item)   # 移除第二个项目
 ​
 Form.show()
 sys.exit(app.exec())

class 写法：

 from PyQt6 import QtWidgets
 import sys
 ​
 class MyWidget(QtWidgets.QWidget):
     def __init__(self):
         super().__init__()
         self.setWindowTitle('千牛编程思维')
         self.resize(300, 200)
         self.ui()
 ​
     def ui(self):
         self.listwidget = QtWidgets.QListWidget(self)
         self.listwidget.addItems(['A','B','C','D'])
         self.listwidget.setGeometry(10,10,120,100)
         item = self.listwidget.takeItem(1)       # 取得第二个项目，也就是 B
         self.listwidget.removeItemWidget(item)   # 移除第二个项目
 ​
 if __name__ == '__main__':
     app = QtWidgets.QApplication(sys.argv)
     Form = MyWidget()
     Form.show()
     sys.exit(app.exec())

QListWidget添加选项

有两种方法可以「添加列表项目」，第一种方法使用 addItem(item)方法将项目加在列表最后方，第二种方法使用insertItem(index, item)将项目加入指定的位置，两种方法除了可以单纯加入「文字」项目，也可以使用函数的方法，加入带有 icon 图示的项目。

下面的程序执行后，会先使用第一种方法，在最后方添加一个内容为 X 的项目，并搭配函数在最后加入一个带有 icon 图片的选项，接著会使用第二种方法，将内容为 Y 的项目添加在第一个项目，然后再搭配函数在第一个项目加入带有 icon 图片的选项。

 from PyQt6 import QtWidgets, QtGui
 import sys
 app = QtWidgets.QApplication(sys.argv)
 ​
 Form = QtWidgets.QWidget()
 Form.setWindowTitle('千牛编程思维')
 Form.resize(300, 200)
 ​
 def create_item(text, img):
     item = QtWidgets.QListWidgetItem()      # 建立清单項目
     item.setText(text)                      # 項目文字
     item.setIcon(QtGui.QIcon(img))          # 項目图片
     return item                             # 返回清单項目
 ​
 listwidget = QtWidgets.QListWidget(Form)
 listwidget.addItems(['A','B','C','D'])
 listwidget.setGeometry(10,10,120,120)
 listwidget.addItem('X')                         # 添加純文字項目
 listwidget.addItem(create_item('', 'icon.png')) # 添加使用函数創造的选项
 ​
 listwidget.insertItem(0, 'Y')                          # 添加純文字項目
 listwidget.insertItem(0, create_item('', 'icon2.png'))  # 添加使用函数創造的选项
 ​
 Form.show()
 sys.exit(app.exec())

class 写法：

 from PyQt6 import QtWidgets, QtGui
 import sys
 ​
 class MyWidget(QtWidgets.QWidget):
     def __init__(self):
         super().__init__()
         self.setWindowTitle('千牛编程思维')
         self.resize(300, 200)
         self.ui()
 ​
     def ui(self):
         self.listwidget = QtWidgets.QListWidget(self)
         self.listwidget.addItems(['A','B','C','D'])
         self.listwidget.setGeometry(20,20,320,320)
         self.listwidget.addItem('X')                         # 添加純文字項目
         self.listwidget.addItem(self.create_item('', 'icon.png')) # 添加使用函数創造的选项
 ​
         self.listwidget.insertItem(0, 'Y')                          # 添加純文字項目
         self.listwidget.insertItem(0, self.create_item('', 'icon2.png'))  # 添加使用函数創造的选项
 ​
     def create_item(self, text, img):
         item = QtWidgets.QListWidgetItem()      # 建立清单項目
         item.setText(text)                      # 項目文字
         item.setIcon(QtGui.QIcon(img))          # 項目图片
         return item                             # 返回清单項目
 ​
 if __name__ == '__main__':
     app = QtWidgets.QApplication(sys.argv)
     Form = MyWidget()
     Form.show()
     sys.exit(app.exec())

QListWidget 修改选项

如果要修改项目内容，可以先透过item(index)方法可以取得该项目，接著就能使用setText()方法修改文字，使用setIcon()方法设定图示。

 from PyQt6 import QtWidgets, QtGui
 import sys
 app = QtWidgets.QApplication(sys.argv)
 ​
 Form = QtWidgets.QWidget()
 Form.setWindowTitle('千牛编程思维')
 Form.resize(300, 200)
 ​
 listwidget = QtWidgets.QListWidget(Form)
 listwidget.addItems(['A','B','C','D'])
 listwidget.setGeometry(10,10,120,100)
 item = listwidget.item(1)                # 取得第二个项目 ( 第一個为 0 )
 item.setText('ok')                       # 设定文字为 ok
 item.setIcon(QtGui.QIcon('icon.png'))    # 设定 icon
 ​
 Form.show()
 sys.exit(app.exec())

class 写法：

from PyQt6 import QtWidgets, QtGui
import sys

class MyWidget(QtWidgets.QWidget):
    def __init__(self):
        super().__init__()
        self.setWindowTitle('千牛编程思维')
        self.resize(300, 200)
        self.ui()

    def ui(self):
        self.listwidget = QtWidgets.QListWidget(self)
        self.listwidget.addItems(['A','B','C','D'])
        self.listwidget.setGeometry(10,10,120,100)
        item = self.listwidget.item(1)           # 取得第二个项目 ( 第一個为 0 )
        item.setText('ok')                       # 设定文字为 ok
        item.setIcon(QtGui.QIcon('icon.png'))    # 设定 icon

if __name__ == '__main__':
    app = QtWidgets.QApplication(sys.argv)
    Form = MyWidget()
    Form.show()
    sys.exit(app.exec())

QListWidget 样式设定

透过setStyleSheet()，可以使用类似网页的 CSS 语法设定 QPushButton 样式，搭配 setFlow()方法，也可以设定列表为水平显示或垂直显示 ( QtWidgets.QListView.Flow.LeftToRight为 PyQt6 的用法 )，下方的程序执行后，会将原本垂直显示列表换成水平显示，并在选择项目时，将项目变成黑底红字。

from PyQt6 import QtWidgets, QtGui
import sys
app = QtWidgets.QApplication(sys.argv)

Form = QtWidgets.QWidget()
Form.setWindowTitle('千牛编程思维')
Form.resize(300, 200)

def show():
    print(listwidget.currentItem().text(), listwidget.currentIndex().row())

def create_item(text):
    item = QtWidgets.QListWidgetItem(listwidget)
    item.setText(text)
    item.setIcon(QtGui.QIcon('icon.png'))
    return item

listwidget = QtWidgets.QListWidget(Form)
listwidget.addItems(['A','B','C','D'])
listwidget.setGeometry(10,10,200,50)
listwidget.addItem(create_item(''))
listwidget.setFlow(QtWidgets.QListView.Flow.LeftToRight)  # 改成水平显示
listwidget.setStyleSheet('''
    QListWidget{
        color:#00f;
    }
    QListWidget::item{
        width:30px;
    }
    QListWidget::item:selected{
        color:#f00;
        background:#000;
    }
''')

Form.show()
sys.exit(app.exec())

class 写法：

from PyQt6 import QtWidgets, QtGui
import sys

class MyWidget(QtWidgets.QWidget):
    def __init__(self):
        super().__init__()
        self.setWindowTitle('千牛编程思维')
        self.resize(300, 200)
        self.ui()

    def ui(self):
        self.listwidget = QtWidgets.QListWidget(self)
        self.listwidget.addItems(['A','B','C','D'])
        self.listwidget.setGeometry(10,10,200,50)
        self.listwidget.addItem(self.create_item(''))
        self.listwidget.setFlow(QtWidgets.QListView.Flow.LeftToRight)  # 改成水平显示
        self.listwidget.setStyleSheet('''
            QListWidget{
                color:#00f;
            }
            QListWidget::item{
                width:30px;
            }
            QListWidget::item:selected{
                color:#f00;
                background:#000;
            }
        ''')

    def create_item(self, text):
        item = QtWidgets.QListWidgetItem(self.listwidget)
        item.setText(text)
        item.setIcon(QtGui.QIcon('icon.png'))
        return item

if __name__ == '__main__':
    app = QtWidgets.QApplication(sys.argv)
    Form = MyWidget()
    Form.show()
    sys.exit(app.exec())

QListWidget 常用方法

下方列出 QListWidget 的常用方法：

方法参数说明
item()index取得指定的项目。
addItem()str增加单一个项目。
addItems()list以串列方式增加多个项目。
takeItem()index取得並移除指定項目
removeItemWidget()item移除指定項目。
clear()清空所有项目。
setFlow()type设定排列方式，预设QtWidgets.QListView.Flow.TopToBottom从上而下，QtWidgets.QListView.Flow.LeftToRight从左到右 ( 和 PyQt5 不同 )。
setDisabled()bool设定是否禁用，预设 False。
clicked.connect()fn点击项目时时要执行的函数。
text()取得输入框内容。
currentItem().text()点击项目的文字。
currentIndex().row()点击项目的列数 ( 垂直 )。
currentIndex().column()点击项目的栏数 ( 水平 )。

下方列出 QListWidget 里 item 的常用方法：

方法参数说明
setText()str设定项目的文字内容。
setIcon()QtGui.QIcon(path)设定项目的图片。
setSelected()bool设定是否选取，预设 False。
text()项目的文字内容。

显示 QListWidget 选择项目

运用clicked.connect(fn)方法，就能在点击项目时，执行特定的函数，下方的程序执行后，会透过 QLabel 显示点击的项目内容。

from PyQt6 import QtWidgets, QtCore, QtGui
import sys
app = QtWidgets.QApplication(sys.argv)

Form = QtWidgets.QWidget()
Form.setWindowTitle('千牛编程思维')
Form.resize(300, 200)

label = QtWidgets.QLabel(Form)
label.setGeometry(10,10,120,30)

def show():
    text = listwidget.currentItem().text()  # 取得項目文字
    num = listwidget.currentIndex().row()   # 取得項目编号
    label.setText(f'{num}:{text}')          # 显示文字

listwidget = QtWidgets.QListWidget(Form)
listwidget.addItems(['A','B','C','D'])
listwidget.setGeometry(10,50,120,50)
listwidget.setFlow(QtWidgets.QListView.Flow.LeftToRight)
listwidget.setStyleSheet('''
    QListWidget::item{
        font-size:20px;
    }
    QListWidget::item:selected{
        color:#f00;
        background:#000;
    }
''')
listwidget.clicked.connect(show)         # 点击项目时执行函数

Form.show()
sys.exit(app.exec())

class 写法 ( 注意不能使用 show 作为方法名称，会覆写基类的 show 方法造成无法显示 )：

from PyQt6 import QtWidgets, QtGui
import sys

class MyWidget(QtWidgets.QWidget):
    def __init__(self):
        super().__init__()
        self.setWindowTitle('千牛编程思维')
        self.resize(300, 200)
        self.ui()

    def ui(self):
        self.label = QtWidgets.QLabel(self)
        self.label.setGeometry(10,10,120,30)
        self.listwidget = QtWidgets.QListWidget(self)
        self.listwidget.addItems(['A','B','C','D'])
        self.listwidget.setGeometry(10,50,120,50)
        self.listwidget.setFlow(QtWidgets.QListView.Flow.LeftToRight)
        self.listwidget.setStyleSheet('''
            QListWidget::item{
                font-size:20px;
            }
            QListWidget::item:selected{
                color:#f00;
                background:#000;
            }
        ''')
        self.listwidget.clicked.connect(self.showText)  # 点击项目时执行函数

    def showText(self):
        text = self.listwidget.currentItem().text()  # 取得項目文字
        num = self.listwidget.currentIndex().row()   # 取得項目编号
        self.label.setText(f'{num}:{text}')          # 显示文字

if __name__ == '__main__':
    app = QtWidgets.QApplication(sys.argv)
    Form = MyWidget()
    Form.show()
    sys.exit(app.exec())

千牛不是牛
关注
  • 0
    点赞
  • 踩
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
Python Qt6快速入门-显示表格数据（Numpy&Panda）
视觉与物联智能
01-14 2000
在前面中，我们介绍了模型视图架构。 然而，我们只触及了模型视图之一——QListView。 Qt6 中还有另外两个可用的模型视图——QTableView 和 QTreeView，它们使用相同的 QStandardItemModel 提供表格（类 Excel）和树（类文件目录浏览器）视图。 在本文中，将介绍如何使用 PySide6 中的 QTableView，包括如何建模数据、格式化值以显示以及添加条件格式。另外，通过QTableView显示 Numpy和Panda数据。
QT的Listwidget控件
热门推荐
houxian1103的博客
03-06 3万+
Qt 中用于项（Item）处理的组件有两类，一类是 Item Views，包括 QListView、QTreeView、 QTableView、QColumnView 等；另一类是 Item Widgets，包括 QListWidget、QTreeWidget 和 QTable Widget。QListWidget其实是QListView的遍历类，QListView 是基于模型/视图（Model/View)结构，视图（View)与模型数据（Model Data)关联实现数据的显示和编辑；
QListWidget添加勾选框
weixin_38977726的博客
03-01 1090
【代码】QListWidget添加勾选框。
【qt】QListWidget 组件
最新发布
qq_74047911的博客
05-17 1371
/可以自定义菜单将上下文菜单策略设置为自定义菜单策略。在这种策略下，当用户在该部件上右击时，不会自动弹出默认的上下文菜单，而是需要手动编写代码来定义自己的上下文菜单。对于的组件，我们最重要的一点是往里面添加的是列表项，这又是一种类型。因此我们要注意那些接口是用在列表项的，那些是用在列表的。冰冻三尺，非一日之寒。
qt QListView下拉多选框
雨中山草
05-14 2031
XComboBox.h #pragma once #include <QComboBox> #include <QStandardItemModel> #include <QListView> #include <QKeyEvent> #include "commonplugin_global.h" #include <QCompleter> class QLineEdit; class QListView; struct ItemInf.
QTreeWidget实现复选框的全选/部分选择/半选择状态
weixin_42286052的博客
03-14 2521
QTreeWidget实现复选框的全选/部分选择/半选择状态
QListWidget（列表框）
10-14
`QListWidget` 是 Qt 中用于显示一个可选择的列表的控件，可以包含文本、图标等元素。以下是如何使用 `QListWidget` 的说明和一个简单的示例： **使用说明：** 1. **创建 QListWidget 对象：** ```cpp #include...
qt实现QListWidget列表框
03-30
本篇将深入探讨如何使用Qt来实现一个QListWidget列表框，以及相关的开发技巧。 首先，我们需要了解QListWidget的基本用法。在Qt Creator中创建一个新的Qt Widgets Application项目，然后在ui设计界面添加...
PyQt QListWidget修改列表项item的行高方法
01-20
这样，用户就可以同时选择多个列表项。 总的来说，PyQt的QListWidget通过QSS提供了丰富的自定义能力，允许开发者根据自己的需求调整界面样式，包括列表项的行高和其他视觉属性。在实际项目中，灵活运用QSS可以让你...
通过重写QListWidget实现拖拽列表排序。
10-28
在Qt框架中，QListWidget是一个非常常用的控件，它用于显示一系列的项，并且支持多种操作，如选择、拖放等。在这个场景中，我们要实现的是通过重写QListWidget来实现拖拽列表排序的功能。这个功能允许用户通过拖动...
QListWidget控件应用示例
12-16
使用QListWidget，演示如何创建和添师项，为项设置图标和复选框，如何遍历列表进行 选择。 QListWidget的主要信号currentItemChanged()的功能，编写响应槽函数。 为QListWidget组件利用己设计的Actions创建自定义...
QListWidget从数据库循环加项目，同时默认选中某一行代码示例
ydyuse的专栏
06-08 3408
列表控件QListWidge主要是通过包含一系列的QListWidgeItem项来进行显示，换句话说，列表控件QListWidge是QListWidgeItem项的集合。其中，列表控件QListWidge包含QListWidgeItem项主要用到函数void QListWidget:: insertItem(int row, QListWidgetItem *item);代码演示从数据库循环加Item和添加自定义Item。同时设置最后一行默认选中。
qt设置tablewidget颜色、添加选择框、添加按钮和进度条
m0_60352504的博客
03-16 8943
cellClicked事件响应，当点击表格项，对复选框进行选中和取消选择。在代码中设置tablewidget的样式表。设置表格，添加选择框。
Qt之实现支持多选的QCombobox
草上爬的博客
10-25 3987
Qt之实现支持多选的QCombobox，完美解决下拉列表存在滚动条时，列表项不显示的问题
Qt 利用QComboBox , QCheckBox , QListWidget组合实现下拉复选框
QQ546760074
06-10 1080
Qt 利用QComboBox , QCheckBox , QListWidget组合实现下拉复选框 本文通过利用QCoomboBox,QCheckBox,QListwidget实现下拉复选框。 widget.h文件内容 #ifndef WIDGET_H #define WIDGET_H #include <QWidget> #include <QListWidget> #include <QListWidgetItem> #include <QCheckBox&g
知识小结-15表格下拉框筛选
weixin_42282999的博客
02-23 206
1、表格下拉框筛选filters报错问题 由于filters不能是变量只能是定值，出现值变化时，更改filters的值 2、表格筛选功能 { title: 'Age', key: 'age', filters: [ { label: 'Greater than 25', value: 1 }, { label: 'Less than 25', va...
[QT_019]Qt学习技巧之QListWidget取消item前面的复选框
kongcheng253的博客
01-12 1577
QListWidget取消item前面的复选框
【QT开发笔记-基础篇】| 第二章 常用控件 | 2.11 列表框 QListWidget
B站-大轮明王讲Qt
08-19 4132
(1) 列表控件的属性：显示模式、交替背景色、添加和删除条目 (2) 列表框-案例 (3) 图标对不齐的问题
qt TreeWidget复选框实现
qq_42106894的博客
07-27 2639
但实际用的时候发现，当文件的层级增多，父节点的文件选中状态会出错，原因是选中文件的时候如果有字节点未反向考虑父节点的选中状态，另外在父节点的选中状态更新中，只考虑了子节点的选中状态，未考虑子节点的未完全选中状态导致了该错误。
qcombobox qlistwidget下拉列表提示
08-31
QComboBox是Qt中一种常用的下拉列表框控件，用于提供选择选项的功能。而QListWidget是Qt中的另一种列表控件，用于显示一组条目的列表。 在QComboBox和QListWidget中，可以通过添加项目来提供列表选项的提示。可以通过addItem()方法向QComboBox或QListWidget中添加项目，这样当用户点击下拉按钮时，会显示所有的项目。 例如，我们可以使用以下代码向QComboBox中添加项目： ```cpp QComboBox *comboBox = new QComboBox(this); comboBox->addItem("选项1"); comboBox->addItem("选项2"); comboBox->addItem("选项3"); ``` 而对于QListWidget，可以使用以下代码来添加项目： ```cpp QListWidget *listWidget = new QListWidget(this); listWidget->addItem("选项1"); listWidget->addItem("选项2"); listWidget->addItem("选项3"); ``` 当用户点击QComboBox的下拉按钮时，会出现一个下拉框，其中包含这些项目。用户可以在下拉框中选择项目。而对于QListWidget，会在控件中直接显示所有的项目，用户可以通过滚动来查看和选择列表项。 总之，无论是QComboBox还是QListWidget，都可以通过addItem()方法来添加项目，从而提供下拉列表或列表项的提示。用户可以根据自己的需求选择适合的控件来实现相应的功能。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值