在GUI设计中，按钮都是最重要的和常用的触发动作请求的方式，用来与用户进行交互操作。在PyQt中根据不同的使用场景将按钮划分为不同的表现形式。

按钮的基类是QAbstractButton，提供了按钮的通用性功能。但是它不能实例化，必须由其他的按钮类继承QAbstractButton类，来实现不同的功能、不同的表现形式。

常见的按钮类包括：QPushButton、QRadioButton和QCheckBox等。这些按钮类均继承自QAbstractButton类，根据各自的使用场景通过图形展现出来。

QAbstractButton提供的状态如下表所示：

![](https://developer.qcloudimg.com/http-save/yehe-8201782/40d7673ddba05f47b626993f850d2c7e.png)

QAbstractButton提供的信号如下表所示：

![](https://developer.qcloudimg.com/http-save/yehe-8201782/7dceef1e660e7bbd5d8c5a910dff1766.png)

## 1、QPushButton按钮类

QPushButton类继承自QAbstractButton类，其形状是长方形，文本标题或图标可以显示在长方形上。

QPushButton类是一种命令按钮，可以单击该按钮执行一些命令，或者响应一些事件，常见的有：“确认"、"申请"、"取消"、"关闭"、"是"、"否"等按钮。

QPushButton类中的常用方法如下表所示：

![](https://developer.qcloudimg.com/http-save/yehe-8201782/b8246cfaed8dd7b87ab3619bac5ac3fc.png)

来看看QPushButton按钮类的示例，效果如下所示：

![](https://developer.qcloudimg.com/http-save/yehe-8201782/fe5e6c035e390276759d1ae70336d846.png)

在这个例子中，创建了btn1、btn2、btn3和btn4四个按钮，这四个QPushButton对象被定义为类的实例变量。每个按钮都将clicked信号发送给指定的槽函数，以响应按钮点击事件。

- 第1个按钮btn1，通过toggle()函数来切换按钮状态。当点击这个按钮时，将clicked信号发送给槽函数btnstate()，通过btn.isChecked来获得按钮是否被点击或释放的状态。还可以通过lambda的方式来传递额外的参数btn1，将clicked信号发送给槽函数whichbtn()。
- 第2个按钮btn2，上面显示一个图标。使用setlcon()方法接收一个QPixmap对象的图像文件作为输入参数。
- 第3个按钮btn3，使用setEnabled()方法来禁用bnt3按钮。
- 第4个按钮btn4，使用setDefault()方法来设置按钮的默认状态。快捷键是“&+文本”(&Download)，通过“Alt+D”快捷键来调用槽函数。

实现代码如下所示：

```python
import sys
from PyQt5.QtCore import *
from PyQt5.QtGui import *
from PyQt5.QtWidgets import *
 
class Form(QDialog):
	def __init__(self, parent=None):
		super(Form, self).__init__(parent)
		layout = QVBoxLayout()
 
		self.btn1 = QPushButton("Button1")
		self.btn1.setCheckable(True)
		self.btn1.toggle()
		self.btn1.clicked.connect(lambda:self.whichbtn(self.btn1) )
		self.btn1.clicked.connect(self.btnstate)
		layout.addWidget(self.btn1)
            
		self.btn2 = QPushButton('image')
		self.btn2.setIcon(QIcon(QPixmap("./python.png")))
		self.btn2.clicked.connect(lambda:self.whichbtn(self.btn2) )
		layout.addWidget(self.btn2)
		self.setLayout(layout) 
 
		self.btn3 = QPushButton("Disabled")
		self.btn3.setEnabled(False)
		layout.addWidget(self.btn3)
        
		self.btn4= QPushButton("&Download")
		self.btn4.setDefault(True)
		self.btn4.clicked.connect(lambda:self.whichbtn(self.btn4))
		layout.addWidget(self.btn4)
		self.setWindowTitle("Button demo")
 
	def btnstate(self):
		if self.btn1.isChecked():
			print("button pressed" ) 
		else:
			print("button released" ) 
 
	def whichbtn(self,btn):
		print("clicked button is " + btn.text() ) 
 
if __name__ == '__main__':
	app = QApplication(sys.argv)
	btnDemo = Form()
	btnDemo.show()
	sys.exit(app.exec_())
```

## 2、QRadioButton按钮类

QRadioButton类提供了一组可供选择的按钮和文本标签，用户可以选择其中一个选项，标签用于显示对应的文本信息。单选钮是一种开关按钮，可以切换为on或者off，即checked或者unchecked，主要是为用户提供"多选一"的选择。

QRadioButton是单选钮控件默认是独占的（Exclusive)。对于继承自同一个父类Widget的多个单选钮，它们属于同一个按钮组合，在单选钮组里，一次只能选择一个单选钮。如果需要多个独占的按钮组合，则需要将它们放在QGroupBox或QButtonGroup中。

QRadioButton类中的常用方法如下表所示：

![](https://developer.qcloudimg.com/http-save/yehe-8201782/a653e69b28444eefca326d4e6b1c43fd.png)

在QRadioButton中，toggled信号是在切换单选钮状态（开、关）时发射的，而clicked信号则在每次点击单选钮时都会发射。在实际中，一般只有状态改变时才有必要去响应，因此toggled信号更适合用于状态监控。

来看看QRadioButton按钮类的示例，效果如下所示：

![](https://developer.qcloudimg.com/http-save/yehe-8201782/2d6777d6440f72e9808e0e0ff1ff81de.png)

在这个例子中，两个互斥的单选钮被放置在窗口中。

第1个单选钮btn1，被设置成默认选中状态。

```python
self.btn1.setChecked(True)
```

当选择两个按钮相互切换时，按钮的状态发生改变，将触发toggle信号，并与槽函数btnstate()连接。使用lambda的方式允许将源信号传递给槽函数，将按钮作为参数。

```python
self.btn1.toggled.connect(lambda:self.btnstate(self.btn1))
self.btn2.toggled.connect(lambda:self.btnstate(self.btn2))
```

当发射toggled信号后，使用btnstate()函数来检查按钮的状态。

实现代码如下所示：

```python
import sys
from PyQt5.QtCore import *
from PyQt5.QtGui import *
from PyQt5.QtWidgets import *
 
class Radiodemo(QWidget):
	def __init__(self, parent=None):
		super(Radiodemo, self).__init__(parent)
		layout = QHBoxLayout()
		self.btn1 = QRadioButton("Button1")
		self.btn1.setChecked(True)
		self.btn1.toggled.connect(lambda:self.btnstate(self.btn1))
		layout.addWidget(self.btn1)
        
		self.btn2 = QRadioButton("Button2")
		self.btn2.toggled.connect(lambda:self.btnstate(self.btn2))
		layout.addWidget(self.btn2)
		self.setLayout(layout)
		self.setWindowTitle("RadioButton demo")
	
	def btnstate(self,btn):
		if btn.text()=="Button1":
			if btn.isChecked() == True:
				print( btn.text() + " is selected" )
			else:
				print( btn.text() + " is deselected" )
		
		if btn.text()=="Button2":
			if btn.isChecked()== True :
				print( btn.text() + " is selected" )
			else:
				print( btn.text() + " is deselected" )
 
if __name__ == '__main__':
	app = QApplication(sys.argv)
	radioDemo = Radiodemo()
	radioDemo.show()
	sys.exit(app.exec_())
```

## 3、QCheckBox按钮类

QCheckBox类提供了一组带文本标签的复选框，用户可以选择多个选项。和QPushButton一样，复选框可以显示文本或者图标，其中文本可以通过构造函数或者setText()来设置；图标可以通过setlcon()来设置。在视觉上，QButtonGroup可以把许多复选框组织在一起。

QCheckBox（复选框）和QRadioButton（单选钮）都是选项按钮，因为它们都可以在开（选中）或者关（未选中）之间切换。它们的区别是对用户选择的限制：单选钮提供了“多选一"的选择；而复选框提供的是“多选多"的选择。

QCheckBox通常被应用在需要用户选择一个或多个可用的选项的场景中。

只要复选框被选中或者取消选中，都会发射一个stateChanged 信号。如果想在复选框状态改变时触发相应的行为，请连接这个信号，可以使用isChecked()来查询复选框是否被选中。

除了常用的选中和未选中两种状态，QCheckBox还提供了第三种状态（半选中）来表明“没有变化"。当需要为用户提供一个选中或者未选中复选框的选择时，这种状态是很有用的。如果需要第三种状态，则可以通过setTristate()来使它生效，并使用checkState()来查询当前的切换状态。

QCheckBox类中的常用方法如下表所示：

![](https://developer.qcloudimg.com/http-save/yehe-8201782/8b27fa83adef8dd1dcde0634ff02ec1e.png)

三态复选框有三种状态，如下表所示：

![](https://developer.qcloudimg.com/http-save/yehe-8201782/8d7de7a9e20ee0e952dd44905f7fab49.png)

来看看QCheckBox按钮类的示例，效果如下所示：

![](https://developer.qcloudimg.com/http-save/yehe-8201782/1cbfd3de3d6de286d7b085c3c097a0a8.png)

在这个例子中，将三个复选框添加到一个水平布局管理器中，并添加到一个QGroupBox组中。

将三个复选框的stateChanged信号都连接到槽函数stateChanged()。使用lambda的方式传递对象给槽函数。当QCheckBox状态改变时发射stateChanged信号，当信号发生改变时触发自定义的槽函数btnstate()。

对上面三个复选框的控件说明，如下表所示：

![](https://developer.qcloudimg.com/http-save/yehe-8201782/75ae04efd0e6f2a328a2da0ff8982af3.png)

实例化checkBox1和checkBox2两个对象，并将checkBox1的状态设置为选中，为checkBox1设置快捷键，使用“&"符号，如“&Checkbox 1"，则通过“Alt+C"快捷键可以选中checkBox1复选框。

实例化一个QCheckBox类对象checkBox3，然后使用setTristate()开启三态模式。

实现代码如下所示：

```python
import sys
from PyQt5.QtCore import *
from PyQt5.QtGui import *
from PyQt5.QtWidgets import *
from PyQt5.QtCore import Qt
 
class CheckBoxDemo(QWidget):
 
	def __init__(self, parent=None):
		super(CheckBoxDemo , self).__init__(parent)
		
		groupBox = QGroupBox("Checkboxes")
		groupBox.setFlat( False )
		
		layout = QHBoxLayout()
		self.checkBox1= QCheckBox("&Checkbox1")
		self.checkBox1.setChecked(True)
		self.checkBox1.stateChanged.connect( lambda:self.btnstate(self.checkBox1) )
		layout.addWidget(self.checkBox1)
        
		self.checkBox2 = QCheckBox("Checkbox2")
		self.checkBox2.toggled.connect( lambda:self.btnstate(self.checkBox2) )
		layout.addWidget(self.checkBox2)
 
		self.checkBox3 = QCheckBox("tristateBox")
		self.checkBox3.setTristate(True)
		self.checkBox3.setCheckState(Qt.PartiallyChecked )		
		self.checkBox3.stateChanged.connect( lambda:self.btnstate(self.checkBox3) )
		layout.addWidget(self.checkBox3)
        
		groupBox.setLayout(layout)
		mainLayout = QVBoxLayout()
		mainLayout.addWidget(groupBox)
		
		self.setLayout(mainLayout)
		self.setWindowTitle("checkbox demo")
	
	def btnstate(self,btn ):
		chk1Status = self.checkBox1.text()+", isChecked="+  str( self.checkBox1.isChecked() ) + ', chekState=' + str(self.checkBox1.checkState())   +"\n"		 
		chk2Status = self.checkBox2.text()+", isChecked="+  str( self.checkBox2.isChecked() ) + ', checkState=' + str(self.checkBox2.checkState())   +"\n"	
		chk3Status = self.checkBox3.text()+", isChecked="+  str( self.checkBox3.isChecked() ) + ', checkState=' + str(self.checkBox3.checkState())   +"\n"			
		print(chk1Status + chk2Status + chk3Status )
 
if __name__ == '__main__':
	app = QApplication(sys.argv)
	checkboxDemo = CheckBoxDemo()
	checkboxDemo.show()
	sys.exit(app.exec_())
```

在GUI设计中，按钮都是最重要的和常用的触发动作请求的方式，用来与用户进行交互操作。在PyQt中根据不同的使用场景将按钮划分为不同的表现形式。

Python Qt GUI设计：QPushButton、QRadioButton和QCheckBox按钮类（基础篇—12）

介绍 PyQt5 中 QPushButton、QRadioButton 和 QCheckBox 的常用方法、信号和状态，结合完整 Python 示例说明命令按钮、单选按钮及三态复选框的交互实现。

嵌入式工程师

编程语言

PyQt按钮控件详解：涵盖QPushButton命令按钮、QRadioButton单选钮和QCheckBox复选框的用法，包含状态切换、信号连接、图标设置及三态模式等核心功能，附完整代码示例。

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Python Qt GUI设计：QPushButton、QRadioButton和QCheckBox按钮类（基础篇—12）-腾讯云开发者社区-腾讯云

Python Qt GUI设计：QPushButton、QRadioButton和QCheckBox按钮类（基础篇—12）

Python Qt GUI设计：QPushButton、QRadioButton和QCheckBox按钮类（基础篇—12）

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐