【python】PyQt5中QPushButton的用法详细解析与应用实战

在这里插入图片描述

✨✨ 欢迎大家来到景天科技苑✨✨

🎈🎈 养成好习惯，先赞后看哦~🎈🎈

🏆 作者简介：景天科技苑
🏆《头衔》：大厂架构师，华为云开发者社区专家博主，阿里云开发者社区专家博主，CSDN全栈领域优质创作者，掘金优秀博主，51CTO博客专家等。
🏆《博客》：Python全栈，前后端开发，小程序开发，云原生K8S，人工智能，js逆向，App逆向，网络系统安全，数据分析，PyQt5和tkinter桌面开发，Django，fastapi，flask等框架，linux，shell脚本等实操经验，网站搭建，数据库等分享。

所属的专栏：PyQt5桌面应用开发，零基础到进阶应用实战
景天的主页：景天科技苑

在这里插入图片描述

文章目录

QPushButton
- 引言
- 1. QPushButton 控件基础
- - 1.1 描述
  - 1.2 继承关系
  - 1.3 初始化函数
- 2. QPushButton 的常用功能
- - 2.1 创建按钮
  - 2.2 启用和禁用
  - 2.3 设置快捷键
  - 2.4 菜单设置
  - 2.4 边框是否扁平
  - 2.5 信号和槽
  - 2.6 默认按钮处理
  - 2.7 右键菜单
  - - 方法一
    - 方法二
- 3. 按钮样式定制
- 4. 按钮的动画效果
- 5. 按钮的分组和禁用
- 6. 按钮的自定义行为
- 7. 实际应用中的按钮设计
- 总结

QPushButton

引言

PyQt5 是一个用于创建图形用户界面的 Python 绑定库，它基于 Qt5 应用程序框架。在 PyQt5 中，QPushButton 是一个常用的控件，用于创建按钮，允许用户通过点击来触发某些操作。
用来给用户点击, 来完成某种动作的控件，一般是矩形的
应用场景
例如：登录按钮，注册按钮，关闭按钮，一些选择按钮等等等

QPushButton继承于QAbstractButton，所以具有AbstractButton的一切特性，而且QPushButton还包含自己特有的一些功能。
本文将详细介绍 QPushButton 的用法，并通过实际案例来展示其强大的功能。

1. QPushButton 控件基础

1.1 描述

QPushButton 控件是一个矩形按钮，通常用于执行如登录、注册、关闭等操作。用户可以通过点击按钮来触发一个事件或操作。

1.2 继承关系

QPushButton 控件继承自 QAbstractButton 类，这意味着它拥有 QAbstractButton 的所有功能，并增加了自己的特性。

1.3 初始化函数

QPushButton 的初始化函数可以接收多个参数，具体取决于你想如何配置按钮。最常见的用法包括：

QPushButton()：创建一个无父控件和文本的按钮。
QPushButton(parent)：创建控件的同时，设置父控件。
QPushButton(text, parent)：创建控件的同时，设置提示文本和父控件。
QPushButton(icon, text, parent)：创建控件的同时，设置图标、提示文本和父控件。

2. QPushButton 的常用功能

2.1 创建按钮

在这里插入图片描述

按钮可以显示文本和图标。使用 setText() 方法设置文本，使用 setIcon() 和 setIconSize() 方法设置图标及其大小。

from PyQt5.QtWidgets import QApplication, QWidget, QPushButton
from PyQt5.QtGui import QIcon

app = QApplication([])
window = QWidget()
window.setWindowTitle('QPushButton 示例')

btn = QPushButton(window)
btn.setText('点击我')
icon = QIcon('icon.png')
btn.setIcon(icon)
btn.setIconSize(QSize(30, 30))  # 假设需要导入QSize

btn.show()
window.show()
app.exec_()

代码展示：


# 0. 导入需要的包和模块
from PyQt5.Qt import *  # 主要包含了我们常用的一些类, 汇总到了一块
import sys


# 1. 创建一个应用程序对象
app = QApplication(sys.argv)


# 2. 控件的操作
# 2.1 创建控件
window = QWidget()


# 2.2 设置控件
#设置窗口标题，默认标题是python，只有顶级控件才可以设置标题栏的标题
window.setWindowTitle("QPushButton创建")
#设置窗口大小，注意，设置的空间尺寸大小，不包含上面的标题栏
window.resize(500, 500)


#创建按钮
#创建方式一，指定活不指定父控件
btn = QPushButton(window)
btn.setText("按钮1")


#创建方式二，创建按钮的同时，设置提示文本和父控件
btn2 = QPushButton('按钮2',window)
btn2.move(50,50)

#创建方式三，创建控件的同时, 设置图标, 提示文本和父控件
btn3 = QPushButton(QIcon("../../imgs/python-gui.png"),'按钮3',window)
btn3.move(100,100)


# 2.3 展示控件
window.show()



# 3. 应用程序的执行, 进入到消息循环
sys.exit(app.exec_())

运行可见，三种创建方式都可以
在这里插入图片描述

2.2 启用和禁用

可以使用 setEnabled() 方法启用或禁用按钮。禁用的按钮不会响应用户的点击操作。

btn.setEnabled(False)  # 禁用按钮

2.3 设置快捷键

QPushButton 支持设置快捷键，允许用户通过键盘操作来触发按钮的点击事件。使用 setShortcut() 方法设置快捷键。

btn.setShortcut('Ctrl+Q')  # 设置快捷键为 Ctrl+Q

这个与其父类QAbdtractButton用法一样，略
在这里插入图片描述

2.4 菜单设置

当我们鼠标，点击按钮之后，可以展开一系列的下拉菜单供我们选择
当我们创建菜单之后，用户点击按钮，就会展示相关菜单
API介绍
在这里插入图片描述
showMenu()指的是我们程序员可以通过代码来控制按钮来展示菜单

当我们把鼠标放在某菜单上面，会显示出第二列，甚至第三列的菜单称为子菜单
在这里插入图片描述

QMenu相关操作
在这里插入图片描述
代码展示：


# 0. 导入需要的包和模块
from PyQt5.Qt import *  # 主要包含了我们常用的一些类, 汇总到了一块
import sys



# 1. 创建一个应用程序对象
app = QApplication(sys.argv)


# 2. 控件的操作
# 2.1 创建控件
window = QWidget()


# 2.2 设置控件
#设置窗口标题，默认标题是python，只有顶级控件才可以设置标题栏的标题
window.setWindowTitle("菜单创建")
#设置窗口大小，注意，设置的空间尺寸大小，不包含上面的标题栏
window.resize(500, 500)

#创建按钮
btn = QPushButton(window)
btn.setText("按钮1")

#创建菜单
menu = QMenu(window)
#将菜单放到按钮上，此时按钮就会出现一个下拉箭头
btn.setMenu(menu)


# 子菜单 最近打开
# open_recent_menu = QMenu(menu)
#设置子菜单标题
# open_recent_menu.setTitle("最近打开")

#一次性写全，创建子菜单
#QMenu(title: Optional[str], parent: Optional[QWidget] = None)
open_recent_menu = QMenu("最近打开",menu)


# 行为动作 新建  打开  分割线 退出
# new_action = QAction()
# new_action.setText("新建")
# new_action.setIcon(QIcon("../../imgs/python-gui.png"))

#新建，一次性写全创建动作
#QAction(icon: QIcon, text: Optional[str], parent: Optional[QObject] = None)
new_action = QAction(QIcon("../../imgs/python-gui.png"), "新建", menu)
#通过信号来执行相应的槽函数
new_action.triggered.connect(lambda: print("新建文件"))

#打开
open_action = QAction(QIcon("xxx.png"), "打开", menu)
open_action.triggered.connect(lambda: print("打开文件"))

#退出程序
exit_action = QAction("退出", menu)
# exit_action.triggered.connect(lambda: print("退出程序"))
exit_action.triggered.connect(lambda: window.close())

#子菜单动作
file_action = QAction("Python-GUI编程-PyQt5")
file_action.triggered.connect(lambda :print("Python-GUI编程-PyQt5"))

#将动作添加到菜单上，点击菜单执行相应动作
menu.addAction(new_action)
menu.addAction(open_action)
#子菜单添加动作
open_recent_menu.addAction(file_action)

#添加子菜单
menu.addMenu(open_recent_menu)
#添加分割线
menu.addSeparator()
menu.addAction(exit_action)




# 2.3 展示控件
window.show()


#展示菜单,相当于用户点击了按钮的菜单按钮
#展示菜单的代码一定要在主窗口展示之后，否则展示不到
# btn.showMenu()


#获取菜单
print(btn.menu())


# 3. 应用程序的执行, 进入到消息循环
sys.exit(app.exec_())

点击下拉菜单
在这里插入图片描述

点击新建，会触发信号
在这里插入图片描述

2.4 边框是否扁平

QPushButton 支持设置边框是否扁平。扁平化的按钮在某些样式下可能不绘制背景，只显示文本或图标。使用 setFlat() 方法设置此属性。
设置了按钮扁平化之后，给按钮设置的背景颜色等样式，都不在生效
在这里插入图片描述

代码展示：


# 0. 导入需要的包和模块
from PyQt5.Qt import *  # 主要包含了我们常用的一些类, 汇总到了一块
import sys


# 1. 创建一个应用程序对象
app = QApplication(sys.argv)


# 2. 控件的操作
# 2.1 创建控件
window = QWidget()


# 2.2 设置控件
#设置窗口标题，默认标题是python，只有顶级控件才可以设置标题栏的标题
window.setWindowTitle("按钮扁平化")
#设置窗口大小，注意，设置的空间尺寸大小，不包含上面的标题栏
window.resize(500, 500)



#创建按钮，默认按钮是凸出来的
btn = QPushButton(window)
btn.setText("按钮")

#查看默认情况下，按钮是否扁平化
# print(btn.isFlat()) #False


#给按钮设置背景颜色
btn.setStyleSheet("background-color: red;")


#设置按钮扁平化
btn.setFlat(True)

#再次查看按钮是否扁平化
print(btn.isFlat()) #True

# 2.3 展示控件
window.show()



# 3. 应用程序的执行, 进入到消息循环
sys.exit(app.exec_())

设置扁平化之前，按钮有凸起
在这里插入图片描述
设置扁平化
btn.setFlat(True)
按钮不再有凸起，而是与周边样式一样

当点下按钮，才能看到按钮样式
在这里插入图片描述

而且设置扁平化之后，给按钮设置的背景颜色等样式也不再生效
未设置扁平化之前，按钮背景颜色设为了红色，且显示红色
在这里插入图片描述

设置扁平化之后，按钮背景颜色不再显示
在这里插入图片描述

只有点下时，才显示
在这里插入图片描述

2.5 信号和槽

QPushButton 的主要事件是 clicked，即按钮被点击时触发。可以通过 clicked.connect() 方法将 clicked 信号连接到自定义的槽函数。

def on_click():
    print('按钮被点击了')

btn.clicked.connect(on_click)

2.6 默认按钮处理

主要应用场景在弹出对话框时，默认光标所在的按钮
例如如下所示，当我们点击打开文件按钮，会弹出一个对话框，此时鼠标光标会默认落在打开这个按钮上
在这里插入图片描述

默认按钮处理有自动默认处理和设置默认
自动默认按钮，指的是当用户点击该按钮，该按钮就自动的会被选中为默认的
setDefault()是直接设置该按钮为默认按钮

在这里插入图片描述
默认情况下，我们点击按钮，松开后会恢复原样

代码展示：

# 0. 导入需要的包和模块
from PyQt5.Qt import *  # 主要包含了我们常用的一些类, 汇总到了一块
import sys


# 1. 创建一个应用程序对象
app = QApplication(sys.argv)


# 2. 控件的操作
# 2.1 创建控件
window = QWidget()


# 2.2 设置控件
#设置窗口标题，默认标题是python，只有顶级控件才可以设置标题栏的标题
window.setWindowTitle("默认按钮")
#设置窗口大小，注意，设置的空间尺寸大小，不包含上面的标题栏
window.resize(500, 500)


btn = QPushButton(window)
btn.setText("按钮1")

btn2 = QPushButton(window)
btn2.setText("btn2")
btn2.move(100, 100)



# 2.3 展示控件
window.show()



# 3. 应用程序的执行, 进入到消息循环
sys.exit(app.exec_())

在这里插入图片描述

当我们设置为自动默认按钮后，用户再点击该按钮，即便释放后，该按钮也会处于被选中状态

btn2.setAutoDefault(True)

#查看按钮是否设置了自动默认按钮
print(btn.autoDefault())
print(btn2.autoDefault())

当我们点击btn2，btn2就会处于被选中状态
由下列的打印也可得知，btn2设置了自动默认按钮
在这里插入图片描述

setAutoDefault() 是用户点击了，才设置为自动默认
如果想要一开始就是默认按钮，则使用setDefault()

#设置默认按钮
btn2.setDefault(True)

#查看是够设置了默认按钮
print(btn.isDefault())
print(btn2.isDefault())

此时，运行程序，btn2就设置了默认按钮，处于被选中状态
在这里插入图片描述

2.7 右键菜单

用户用鼠标右键点击窗口后，弹出来的菜单
右键菜单实际上是通过发射信号来实现的
QPushbutton的信号都是继承自父类的
右键菜单实现的方式有两种
在这里插入图片描述

方法一

也是默认的，window.setContextMenuPolicy(Qt.DefaultContextMenu)
当我们在PyQT5组件上右键点击窗体时会触发一个事件：contextMenuEvent，
默认情况下，window.setContextMenuPolicy()里面的是参数是Qt.DefaultContextMenu，鼠标右键执行的是contextMenuEvent
我们要想自己设计右键点击后弹出的事件，我们就必须要重载contextMenuEvent这个方法。

代码展示：

# 0. 导入需要的包和模块
from PyQt5.Qt import *  # 主要包含了我们常用的一些类, 汇总到了一块
import sys


#重写个窗口类，继承QWidget，重写contextMenuEvent方法
class Window(QWidget):
    # 重写contextMenuEvent方法,然后在该窗口下只要鼠标右键，就会触发该方法，执行该方法中的逻辑
    def contextMenuEvent(self, evt):
        print("在窗口中右键点击鼠标")




# 1. 创建一个应用程序对象
app = QApplication(sys.argv)


# 2. 控件的操作
# 2.1 创建控件
window = Window()


# 2.2 设置控件
#设置窗口标题，默认标题是python，只有顶级控件才可以设置标题栏的标题
window.setWindowTitle("右键菜单")
#设置窗口大小，注意，设置的空间尺寸大小，不包含上面的标题栏
window.resize(500, 500)







# 2.3 展示控件
window.show()



# 3. 应用程序的执行, 进入到消息循环
sys.exit(app.exec_())

鼠标右键

在这里插入图片描述

右击展示菜单代码


# 0. 导入需要的包和模块
from PyQt5.Qt import *  # 主要包含了我们常用的一些类, 汇总到了一块
import sys


#重写个窗口类，继承QWidget，重写contextMenuEvent方法
class Window(QWidget):
    # 重写contextMenuEvent方法,然后在该窗口下只要鼠标右键，就会触发该方法，执行该方法中的逻辑
    # QContextMenuEvent
    def contextMenuEvent(self, evt):
        # print("在窗口中右键点击鼠标")

        # 创建菜单
        menu = QMenu(window)

        # 子菜单 最近打开
        # open_recent_menu = QMenu(menu)
        # 设置子菜单标题
        # open_recent_menu.setTitle("最近打开")

        # 一次性写全，创建子菜单
        # QMenu(title: Optional[str], parent: Optional[QWidget] = None)
        open_recent_menu = QMenu("最近打开", menu)

        # 行为动作 新建  打开  分割线 退出
        # new_action = QAction()
        # new_action.setText("新建")
        # new_action.setIcon(QIcon("../../imgs/python-gui.png"))

        # 新建，一次性写全创建动作
        # QAction(icon: QIcon, text: Optional[str], parent: Optional[QObject] = None)
        new_action = QAction(QIcon("../../imgs/python-gui.png"), "新建", menu)
        # 通过信号来执行相应的槽函数
        new_action.triggered.connect(lambda: print("新建文件"))

        # 打开
        open_action = QAction(QIcon("xxx.png"), "打开", menu)
        open_action.triggered.connect(lambda: print("打开文件"))

        # 退出程序
        exit_action = QAction("退出", menu)
        # exit_action.triggered.connect(lambda: print("退出程序"))
        exit_action.triggered.connect(lambda: window.close())

        # 子菜单动作
        file_action = QAction("Python-GUI编程-PyQt5")
        file_action.triggered.connect(lambda: print("Python-GUI编程-PyQt5"))

        # 将动作添加到菜单上，点击菜单执行相应动作
        menu.addAction(new_action)
        menu.addAction(open_action)
        # 子菜单添加动作
        open_recent_menu.addAction(file_action)

        # 添加子菜单
        menu.addMenu(open_recent_menu)
        # 添加分割线
        menu.addSeparator()
        menu.addAction(exit_action)

        #展示菜单用exec_()方法,执行的时候传递QPoint对象，是哪个点的位置
        #默认菜单会在(0,0)位置展示
        # 我们设置在鼠标点击的位置显示菜单，evt.globalPos()获取鼠标右击点的位置
        #必须是相对于全局的坐标，不能是相对于窗口的坐标
        menu.exec_(evt.globalPos())




# 1. 创建一个应用程序对象
app = QApplication(sys.argv)


# 2. 控件的操作
# 2.1 创建控件
window = Window()


# 2.2 设置控件
#设置窗口标题，默认标题是python，只有顶级控件才可以设置标题栏的标题
window.setWindowTitle("右键菜单")
#设置窗口大小，注意，设置的空间尺寸大小，不包含上面的标题栏
window.resize(500, 500)







# 2.3 展示控件
window.show()



# 3. 应用程序的执行, 进入到消息循环
sys.exit(app.exec_())

在这里插入图片描述

方法二

window.setContextMenuPolicy(Qt.CustomContextMenu)
需要自定义个槽函数，根据信号触发

代码展示


# 0. 导入需要的包和模块
from PyQt5.Qt import *  # 主要包含了我们常用的一些类, 汇总到了一块
import sys


# 1. 创建一个应用程序对象
app = QApplication(sys.argv)


# 2. 控件的操作
# 2.1 创建控件
window = QWidget()


# 2.2 设置控件
#设置窗口标题，默认标题是python，只有顶级控件才可以设置标题栏的标题
window.setWindowTitle("右键菜单方式二")
#设置窗口大小，注意，设置的空间尺寸大小，不包含上面的标题栏
window.resize(500, 500)


#自定义个方法，来创建菜单，形参接收一个相对于窗口的位置坐标QPoint对象
def show_menu(point):
    print(point)
    # 创建菜单
    menu = QMenu(window)

    # 子菜单 最近打开
    # open_recent_menu = QMenu(menu)
    # 设置子菜单标题
    # open_recent_menu.setTitle("最近打开")

    # 一次性写全，创建子菜单
    # QMenu(title: Optional[str], parent: Optional[QWidget] = None)
    open_recent_menu = QMenu("最近打开", menu)

    # 行为动作 新建  打开  分割线 退出
    # new_action = QAction()
    # new_action.setText("新建")
    # new_action.setIcon(QIcon("../../imgs/python-gui.png"))

    # 新建，一次性写全创建动作
    # QAction(icon: QIcon, text: Optional[str], parent: Optional[QObject] = None)
    new_action = QAction(QIcon("../../imgs/python-gui.png"), "新建", menu)
    # 通过信号来执行相应的槽函数
    new_action.triggered.connect(lambda: print("新建文件"))

    # 打开
    open_action = QAction(QIcon("xxx.png"), "打开", menu)
    open_action.triggered.connect(lambda: print("打开文件"))

    # 退出程序
    exit_action = QAction("退出", menu)
    # exit_action.triggered.connect(lambda: print("退出程序"))
    exit_action.triggered.connect(lambda: window.close())

    # 子菜单动作
    file_action = QAction("Python-GUI编程-PyQt5")
    file_action.triggered.connect(lambda: print("Python-GUI编程-PyQt5"))

    # 将动作添加到菜单上，点击菜单执行相应动作
    menu.addAction(new_action)
    menu.addAction(open_action)
    # 子菜单添加动作
    open_recent_menu.addAction(file_action)

    # 添加子菜单
    menu.addMenu(open_recent_menu)
    # 添加分割线
    menu.addSeparator()
    menu.addAction(exit_action)

    # 展示菜单用exec_()方法
    # 默认菜单会在(0,0)位置展示
    #方法中的参数point可以获取鼠标右键点击相对于窗口的局部坐标
    #window.mapToGlobal将point局部坐标转换为全局坐标点
    # 将point局部坐标点，映射为相对于桌面的全局坐标点坐标
    dest_point = window.mapToGlobal(point)
    menu.exec_(dest_point)


#自定义右键菜单，通过发射信号方式来触发，先将菜单上下文策略设为自定义模式
window.setContextMenuPolicy(Qt.CustomContextMenu)
#根据定义的槽函数发射信号
window.customContextMenuRequested.connect(show_menu)


# 2.3 展示控件
window.show()



# 3. 应用程序的执行, 进入到消息循环
sys.exit(app.exec_())

鼠标在窗口上右键，弹出菜单

在这里插入图片描述

当然，我们可以继续深入讨论 PyQt5 中 QPushButton 的高级用法以及如何在更复杂的应用场景中使用它。以下是一些扩展话题和示例：

3. 按钮样式定制

PyQt5 允许你通过样式表（QSS，类似于 CSS）来自定义按钮的外观。这包括改变按钮的背景色、边框、字体等。

from PyQt5.QtWidgets import QApplication, QWidget, QPushButton

app = QApplication([])
window = QWidget()

btn = QPushButton('定制样式', window)
btn.setStyleSheet("""
    QPushButton {
        background-color: #4CAF50;
        color: white;
        border: 2px solid #3e8e41;
        border-radius: 10px;
        padding: 10px;
        font-size: 16px;
        min-width: 100px;
    }

    QPushButton:hover {
        background-color: #45a049;
    }

    QPushButton:pressed {
        background-color: #388e3c;
    }
""")

btn.show()
window.show()
app.exec_()

在这个例子中，我们为按钮设置了基本的样式，包括背景色、文字颜色、边框、边框圆角、内边距、字体大小和最小宽度。同时，我们还定义了鼠标悬停和按钮按下时的样式变化。

4. 按钮的动画效果

虽然 PyQt5 本身不直接支持复杂的动画效果，但你可以使用 QPropertyAnimation 来为按钮添加简单的动画，如淡入淡出、大小变化等。

from PyQt5.QtWidgets import QApplication, QWidget, QPushButton
from PyQt5.QtCore import QPropertyAnimation, QRect, QPoint

app = QApplication([])
window = QWidget()

btn = QPushButton('动画效果', window)
btn.setGeometry(50, 50, 100, 40)

# 创建一个动画对象，用于改变按钮的几何形状
animation = QPropertyAnimation(btn, b"geometry")
animation.setDuration(1000)  # 持续时间1000毫秒
animation.setStartValue(QRect(50, 50, 100, 40))
animation.setEndValue(QRect(150, 50, 100, 40))  # 移动到新的位置
animation.start()  # 开始动画

btn.show()
window.show()
app.exec_()

在这个例子中，我们创建了一个动画，使按钮在屏幕上水平移动。注意，这里使用了 QPropertyAnimation 的 b"geometry" 属性来指定要改变的属性。

5. 按钮的分组和禁用

在某些情况下，你可能需要将多个按钮组合在一起，并允许用户一次只能激活其中一个。虽然 PyQt5 没有直接提供按钮组的控件，但你可以通过编程方式实现这一功能。

此外，如果你需要禁用一组按钮中的某些按钮，可以遍历这些按钮并调用它们的 setEnabled(False) 方法。

6. 按钮的自定义行为

除了基本的点击事件外，你还可以为按钮添加其他类型的事件处理逻辑，如双击事件、长按事件等。虽然 PyQt5 的 QPushButton 不直接支持双击和长按事件，但你可以通过重写按钮的某些方法或使用定时器来模拟这些行为。

7. 实际应用中的按钮设计

在开发实际应用程序时，按钮的设计应该符合应用程序的整体风格和用户体验。这包括按钮的大小、颜色、位置、文本内容以及图标的选择。同时，按钮的响应速度和反馈也是非常重要的，用户应该能够清楚地知道他们的操作是否被系统识别和处理。

总结

QPushButton 是 PyQt5 中一个非常强大且灵活的控件，它允许你创建各种类型的按钮来满足不同的需求。通过本文的介绍，你应该已经掌握了 QPushButton 的基本用法和高级功能，并能够在实际应用中灵活运用它。随着你对 PyQt5 的进一步学习，你会发现更多关于按钮和其他控件的有趣用法和技巧。