常用控件3

发表于2023-07-14|更新于2026-09-01|教程PySide

|总字数:2.3k|阅读时长:8分钟|浏览量:

QRadioButton 是单选按钮，如下图所示

说明

同一个父窗口 里面的多个单选按钮，只能选中一项。

如果你有多组单选按钮，每组都应该有不同的父控件，或者不同的Layout。

通常建议：多组单选按钮，放到不同的按钮组 QButtonGroup 中

具体内容，点击这里，查看视频讲解

信号：选中状态改变

如果用户操作点击了按钮组 QButtonGroup 中的一个按钮， QButtonGroup 就会发出 buttonClicked 信号，可以这样指定处理该信号的函数

1	buttongroup.buttonClicked.connect(handleButtonClicked)

然后，在处理函数中调用QButtonGroup对象的 checkedButton() 函数，返回值就是被选中的按钮对象。

再调用这个返回的按钮对象的 text() 方法得到界面文本，就可以知道是哪个选项被选中了。

点击按钮

1	button.clicked.connect(self.)

勾选按钮和按钮组

QCheckBox 是勾选按钮，如下图所示

说明

通常建议：多组勾选按钮，放到不同的按钮组 QButtonGroup 中，按钮组就是父控件。

可以在 Qt设计师中设置 QButtonGroup 的 exclusive 属性，来控制是否只能单选一个选项。

信号：选中状态改变

如果用户操作点击了按钮组 QButtonGroup 中的一个按钮， QButtonGroup 就会发出 buttonClicked 信号，可以这样指定处理该信号的函数

1	buttongroup.buttonClicked.connect(handleButtonClicked)

QButtonGroup 设置为 单选 情况下：

在处理函数中调用QButtonGroup对象的 checkedButton() 函数，返回值就是被选中的按钮对象。

再调用这个返回的按钮对象的 text() 方法得到界面文本，就可以知道是哪个选项被选中了。

QButtonGroup 设置为 多选 情况下：

要得知哪些按钮被选中，可以对所有该组中的按钮调用 isChecked 方法，来判断。

tab页控件

我们可以通过tab页控件把界面分为好几个页面，如下所示

通过Qt designer 只需要拖拽控件到各个页面即可。

要修改tab页的标题，可以先点击该tab页，然后在下图所示处修改

tab页中布局Layout

如果我们要在tab页上布局，你可能会在对象查看器总直接右键点击该tab，可以你会发现右键菜单里面没有布局项。

这是 Qt designer 非常坑爹的地方，我当时足足花了一个小时才找到方法。

首先需要你在tab页上添加一个控件
然后点击在对象查看器右键点击上层 TabWidget ，这时，你就会发现有布局菜单了

点击这里，看视频讲解tab页中布局Layout

进度条

QProgressBar 是进度条，如下图所示

qt0001

说明

进度条也是一个常用的控件，当程序需要做一件比较耗费时间的任务（比如统计数据，下载文件等）时，可以用来向用户指示操作的进度。

而且有了进度显示，用户就知道应用程序仍在运行，并没有出问题。

QProgressBar进度条把每个进度称之为一个step（步骤）。

我们可以通过它的 setRange 方法设定步骤个数，比如

1	progressBar.setRange(0,5)

就设定了，进度分为5步。

然后，通过 setValue 方法，指定当前完成到了哪一步，比如

1	progressBar.setValue(3)

就表示完成了 3/5，也就是 60%，进度条就会显示60%的进度。

可以使用reset()将进度条倒退到开头。

有时候我们的任务没法知道完成了多少，比如下载一个未知大小的文件。

这时，可以把range 范围都设置为0，这样，进度条会显示忙碌指示符，而不是显示进度百分比。

下面是一个进度条程序的示例代码

from PySide2.QtWidgets import QApplication, QMainWindow, QPushButton,  QProgressBar,QMessageBox
from time import sleep
from threading import  Thread

class Stats():
    def __init__(self):
        self.window = QMainWindow()
        self.window.resize(500, 400)
        self.window.move(300, 300)

        self.progressBar = QProgressBar(self.window)
        self.progressBar.resize(300, 20)
        self.progressBar.move(80, 30)
        # 进度是 0 - 5，
        self.progressBar.setRange(0,5)

        self.button = QPushButton('统计', self.window)
        self.button.move(80, 80)

        self.button.clicked.connect(self.handleCalc)

        # 统计进行中标记，不能同时做两个统计
        self.ongoing = False

    def handleCalc(self):
        def workerThreadFunc():
            self.ongoing = True
            for i in range(1,6):
                sleep(1)
                # 设置进度值
                self.progressBar.setValue(i)
            self.ongoing = False

        if self.ongoing:
            QMessageBox.warning(
                self.window,
                '警告','任务进行中，请等待完成')
            return

        # 通常任务执行比较耗时，应该在新的线程中进行
        # 否则会阻塞主线程显示界面
        worker = Thread(target=workerThreadFunc)
        worker.start()

app = QApplication([])
stats = Stats()
stats.window.show()
app.exec_()

上面的代码，运行时，会有很多告警，因为我们在新线程中操作界面对象，容易出问题。

更合理的方法是通过信号，在线程之间传递信息，对界面的操作都在主线程中完成。

如下

from PySide2.QtWidgets import QApplication, QMainWindow, QPushButton,  QProgressBar,QMessageBox
from time import sleep
from threading import  Thread
from PySide2.QtCore import Signal,QObject

# 信号库
class SignalStore(QObject):
    # 定义一种信号
    progress_update = Signal(int)
    # 还可以定义其他作用的信号

# 实例化
so = SignalStore()

class Stats():
    def __init__(self): 
        # 连接信号到处理的slot函数
        so.progress_update.connect(self.setProgress)
        
        self.window = QMainWindow()
        self.window.resize(500, 400)
        self.window.move(300, 300)

        self.progressBar = QProgressBar(self.window)
        self.progressBar.resize(300, 20)
        self.progressBar.move(80, 30)
        # 进度是 0 - 5，
        self.progressBar.setRange(0,5)

        self.button = QPushButton('统计', self.window)
        self.button.move(80, 80)

        self.button.clicked.connect(self.handleCalc)

        # 统计进行中标记，不能同时做两个统计
        self.ongoing = False

    def handleCalc(self):
        def workerThreadFunc():
            self.ongoing = True
            for i in range(1,6):
                sleep(1)
                # 发出信息，通知主线程进行进度处理
                so.progress_update.emit(i)
            self.ongoing = False

        if self.ongoing:
            QMessageBox.warning(
                self.window,
                '警告','任务进行中，请等待完成')
            return

        worker = Thread(target=workerThreadFunc)
        worker.start()

    # 处理进度的slot函数
    def setProgress(self,value):
        self.progressBar.setValue(value)

app = QApplication([])
stats = Stats()
stats.window.show()
app.exec_()

数字输入框

QSpinBox 是数字输入框，可以输入或使用上下箭头选择数字，如下图所示

qt0001

获取数字

通过 value 方法获取编辑框内的文本内容，比如

1	number = box.value()

注意：返回的是整数对象，不是字符串

设置数字

通过 setValue 方法可以设置提示文本内容，比如

1	box.setValue(100)

日期控件

QDateEdit 类可以用来选择日期时间，如下图所示

获取日期

当用户点击日期时间控件并且选取了日期和时间，后来程序要获取这个控件里面选定的日期时间，可以使用date方法获取日期对象。

如下所示

# 返回 PySide2.QtCore.QDate 对象
qdate = dateEdit.date()

# 可以转化为 指定格式的字符串
dateStr = qdate.toString('yyyy-MM-dd')

# 也可以获取年月日 对应的数字 ，比如日期是2020年5月2号
year = qdate.year()   # 返回 2020
month = qdate.month() # 返回 5
day = qdate.day()     # 返回 2

QDate 对象的具体说明参考官方文档

设置日期

from PySide2.QtCore import *
a = datetime.datetime.now()
date = QDate(a.year, a.month, a.day)
self.ui.dateEdit.setDate(date)

选择文件框

QFileDialog 类可以用来选择文件或者目录，如下图所示

选择目录

通过 getExistingDirectory 静态方法 选择目录。

该方法，第一个参数是父窗口对象，第二个参数是选择框显示的标题。

比如

1
2
3

from PySide2.QtWidgets import QFileDialog

filePath = QFileDialog.getExistingDirectory(self.ui, "选择存储路径")

返回值即为选择的路径字符串。

如果用户点击了选择框的取消选择按钮，返回空字符串。

选择单个文件

如果你想弹出文件选择框，选择一个 已经存在 的文件，可以使用 QFileDialog 静态方法 getOpenFileName ，比如

from PySide2.QtWidgets import QFileDialog

filePath, _  = QFileDialog.getOpenFileName(
            self.ui,             # 父窗口对象
            "选择你要上传的图片", # 标题
            r"d:\\data",        # 起始目录
            "图片类型 (*.png *.jpg *.bmp)" # 选择类型过滤项，过滤内容在括号中
        )

该方法返回值是一个元组，第一个元素是选择的文件路径，第二个元素是文件类型，如果你只想获取文件路径即可，可以采用上面的代码写法。

如果用户点击了选择框的取消选择按钮，返回空字符串。

如果你想弹出文件选择框，选择路径和文件名，来 保存一个文件 ，可以使用 QFileDialog 静态方法 getSaveFileName ，比如

from PySide2.QtWidgets import QFileDialog

filePath, _  = QFileDialog.getSaveFileName(
            self.ui,             # 父窗口对象
            "保存文件", # 标题
            r"d:\\data",        # 起始目录
            "json类型 (*.json)" # 选择类型过滤项，过滤内容在括号中
        )

选择多个文件

如果要选择多个文件，使用 getOpenFileNames 静态方法

from PySide2.QtWidgets import QFileDialog

filePaths, _  = QFileDialog.getOpenFileNames(
            self.ui,             # 父窗口对象
            "选择你要上传的图片", # 标题
            r"d:\\data",        # 起始目录
            "图片类型 (*.png *.jpg *.bmp)" # 选择类型过滤项，过滤内容在括号中
        )

上例中 filePaths 对应的返回值是一个列表，里面包含了选择的文件。

如果用户点击了选择框的取消选择按钮，返回空列表。

文章作者: YuKiFuHaNe

文章链接: https://blog.yukifuhane.cn.eu.org/2023/07/14/%E5%B8%B8%E7%94%A8%E6%8E%A7%E4%BB%B63/

版权声明: 本博客所有文章除特别声明外，均采用 CC BY-NC-SA 4.0 许可协议。转载请注明来源 YuKiFuHaNeの博客！

PySide2 QRadioButton QCheckBox QButtonGroup QTabWidget QProgressBar

相关推荐

自定义控件

Qt提供了比较丰富的内置控件，一些常规的开发通常够用。但是有时，还是需要我们自己开发特殊用途的自定义控件。比如，在我们的项目实战3中，要求开发一个模拟充电桩、洗车机等设备的测试工具。模拟这些设备的控件，就需要我们自己定制开发。 QPainter我们前面学过的内置控件，比如按钮、输入框、选择框，它们的视觉界面是怎么呈现出来的呢？其实都是 Qt 画出来的。 Qt是通过 QPainter 类实现画出各种控件的。 QPainter 类对象可以在任何继承自 QPaintDevice （比如QWidget, QImage, QPixmap ）的实例上绘制图形、文字控件的视觉界面，其实就是通过画出各种线条、矩形、圆形，等这些形状组合出来的。画线比如，下面的代码调用 QPainter 对象的 drawLine 方法画一条线， 123456789101112131415161718192021222324from PySide2 import QtGui, QtWidgets # 自定义一个QWidget的子类class MyWidget(QtWidgets.QWidge...

QSS 概念点击这里，边看视频讲解，边学习以下内容前面，我们开发的程序界面有点简陋。大家点击这里，下载一个白月黑羽实战班学员开发的程序界面代码，解压后，拖动里面的main.ui界面文件到Qt设计师里面。像这样要让产品更好看一些，通常就是指定界面元素的显示样式。比如指定颜色、字体、间距。像这样 Qt有种定义界面显示样式的方法，称之为 Qt Style Sheet ，简称 QSS 如果你学习过Web网页开发，就会发现这个名词和 CSS 特别的相似。没错，它的语法和用途和 CSS 特别的相似。我们来看上图对应的示例如果在设计师界面上最上层的 MainWindow 对象 styleSheet 属性指定如下的内容 1234QPushButton { color: red ; font-size:15px;} 就会发现，所有的按钮上的文字都变成了红色的，并且字体变大了。注意这个指定界面元素显示样式的语法，由 selector 和 declaration 组成。花括号前面的部分，比如示例中的 QPushButton 称...

后台线程和信号

界面阻塞问题前面我们的练习里开发了一个类似 Postman 的HTTP接口测试工具。其中，具体发送请求消息的代码如下 1234567891011121314151617181920212223242526272829def sendRequest(self): method = self.ui.boxMethod.currentText() url = self.ui.editUrl.text() payload = self.ui.editBody.toPlainText() # 获取消息头 headers = {} # 此处省略一些对消息头的处理 req = requests.Request(method, url, headers=headers, data=payload ) prepared...

树控件QTreeWidget 树控件树控件，是和 QTreeWidgetItem 树节点控件结合使用的。如下图所示 1本节讲解仅内部学员可见提示框QMessageBox 类可以用来弹出各种提示框官网介绍该类可以通过一系列静态方法，显示如下弹出框错误报告使用 critical 方法 123456from PySide2.QtWidgets import QMessageBoxQMessageBox.critical( self.ui, '错误', '请选择爬取数据存储路径！') 警告使用 warning 方法 1234QMessageBox.warning( self.ui, '阅读太快', '阅读客户协议必须超过1分钟') 信息提示使用 information 方法 1234QMessageBox.information( self.ui, '操作成功', '请继...

按钮QPushButton 就是常见的按钮官网介绍信号：被点击当按钮被点击就会发出 clicked 信号，可以这样指定处理该信号的函数 1button.clicked.connect(handleCalc) 改变文本代码中可以使用 setText 方法来改变按钮文本，比如 1button.setText(text) 禁用、启用所有控件（继承自QWidget类）都支持禁用和启用方法。禁用后，该控件不再处理用户操作禁用 1button.setEnabled(False) 启用 1button.setEnabled(True) 设置图标可以通过如下方法给按钮设置图标 12345678from PySide2.QtCore import Qt,QSizefrom PySide2.QtGui import QIcon# 设置图标button.setIcon(QIcon('logo.png'))# 设置图标大小button.setIconSize(QSize(30, 30)) 单行文本框QLineEdit 是只能单行编辑的文本框。官网介绍...

页面设计和布局

Qt Designer 简介点击这里，边看视频讲解，边学习以下内容 QT程序界面的一个个窗口、控件，就是像上面那样用相应的代码创建出来的。但是，把你的脑海里的界面，用代码直接写出来，是有些困难的。很多时候，运行时呈现的样子，不是我们要的。我们经常还要修改代码调整界面上控件的位置，再运行预览。反复多次这样操作。可是这样，真的…太麻烦了。其实，我们可以用QT界面生成器 Qt Designer ，拖拖拽拽就可以直观的创建出程序大体的界面。怎么运行这个工具呢？ Windows下，运行 Python安装目录下 Scripts\pyside2-designer.exe 这个可执行文件如果你安装的是pyqt5，运行 Python安装目录下 Scripts\pyqt5designer.exe 这个可执行文件根据上面链接的视频讲解，大家初步了解一下 Qt Designer 的使用方法。通过 Qt Designer 设计的界面，最终是保存在一个ui文件中的。大家可以打开这个ui文件看看，就是一个XML格式的界面定义。动态加载UI文件点击这里，边看视频讲解，边学习以下内容有了...