【python】PyQt5事件传递，鼠标动作捕获，键盘按键捕获原理与应用实战

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

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

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

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

1.事件传递

控件消息的处理是从内到外的，即当前控件对传递来的消息无法处理时会交给它的父控件进行处理，如果父控件也无法处理就交给它的父控件的父控件处理，…，直到顶层控件也无法处理则结束。

当一个控件被触发了一个特定的行为时, 就会调用特定的方法, 来将事件传递给开发人员, 方便处理
重写这些事件方法, 就可以监听相关的信息
在父子控件之间，可以设置事件是否传递

如果一个控件没有处理该事件, 则会自动传递给父控件进行处理
事件对象具备两个特殊方法
accept() 自己处理了这个事件, 并告诉系统不要再向上层传递
ignore() 自己忽略了这个事件, 告诉系统, 继续往后传递去

（1）事件传递实战

# 0. 导入需要的包和模块
from PyQt5.Qt import *
import sys


class Window(QWidget):
    def mousePressEvent(self, QMouseEvent):
        print("顶层窗口鼠标按下")


#中间的窗口
class MidWindow(QWidget):
    def mousePressEvent(self, evt):
        print("中间控件被按下")
        #判断
        print('中间窗口事件是否被处理',evt.isAccepted())
        #ignore()表示标识事件未处理，继续向父窗口传播
        evt.ignore()


class Label(QLabel):
    def mousePressEvent(self, evt):
        print("标签控件鼠标按下")
        #accept() 表示事件已处理，不需要向父窗口传播，此时，事件就不再向父控件传播
        # evt.accept()
        #查看事件是否被处理状态，默认情况下，当事件被传过来之后，就是被处理状态
        print('标签事件是否被处理',evt.isAccepted())
        # ignore()表示标识事件未处理，继续向父窗口传播
        evt.ignore()
        #此处在查看，事件是未处理状态，会继续向父窗口传播
        # print(evt.isAccepted())

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

# 2. 控件的操作
# 2.1 创建控件
window = Window()
# 2.2 设置控件
window.setWindowTitle("事件传递")
window.resize(500, 500)
window.setStyleSheet("background-color:green;")

mid_window = MidWindow(window)
mid_window.resize(300, 300)
#默认设置的背景色不生效，需要设置下Qt.WA_StyledBackground
mid_window.setAttribute(Qt.WA_StyledBackground, True)
mid_window.setStyleSheet("background-color: yellow;")

label = Label(mid_window)
# label = QLabel(mid_window)
label.setText("这是一个标签")
label.setStyleSheet("background-color: red;")
label.move(100, 100)

btn = QPushButton(mid_window)
btn.setText("我是按钮")
btn.move(50, 50)




# 2.3 展示控件
window.show()
# 3. 应用程序的执行, 进入到消息循环
sys.exit(app.exec_())

点击最中间的标签，当设置了ignore，层层向上传递

其他常用事件API介绍

2.鼠标事件捕获案例

创建一个窗口包含一个标签
鼠标进入标签时, 展示"欢迎光临"
鼠标离开标签时, 展示"谢谢惠顾"

from PyQt5.Qt import *

#标签类
class Label(QLabel):
    #鼠标进入控件时触发
    def enterEvent(self, QEvent):
        self.setText("欢迎光临")
        self.adjustSize()


    #鼠标离开控件时触发
    def leaveEvent(self, QEvent):
        self.setText("谢谢惠顾")
        self.adjustSize()




if __name__ == '__main__':
    import sys
    app = QApplication(sys.argv)

    window = QWidget()
    window.resize(500,500)

    lable = Label(window)
    lable.move(100,100)

    lable.setStyleSheet("background-color: cyan;")

    window.show()


    sys.exit(app.exec_())

鼠标移入标签，显示欢迎光临

鼠标移出，显示谢谢惠顾

3.键盘事件捕获案例

PyQt5键盘事件被频繁处理。例如，按下F1，显示帮助信息；在文本编辑框中，按下回车键，输入焦点自动跳到另一控件。下面详细介绍键盘事件。

（1）键盘按键API使用方法

• 修饰键
  Qt.NoModifier 没有修饰键
  Qt.ShiftModifier Shift键被按下
  Qt.ControlModifier Ctrl键被按下
  Qt.AltModifier Alt键被按下
  多个修饰键之间使用按位或运算

• 普通键
  key后面字母大写
  Qt.Key_X

按下并释放键时，以下方法将被调用：
keyPressEvent(self,event) - 按下某一键时，该方法被调用直到键被释放为止；
keyReleaseEvent(self,event) - 释放之前按下的键时被调用。event参数为QKeyEvent对象，包括

事件的相关信息，有以下方法可调用。
key():返回按下键的值；
text():返回按下键的Unicode字符编码信息，当按键为Shift, Control, Alt等时，则该函数返回的字符为空值；
modifiers():判断按下了哪些修饰键（Shift,Ctrl , Alt,等等）。返回值为QtCore.Qt 类以下枚举变量的组合：
NoModifier - 没有修饰键；
ShiftModifier - 修饰键；
ControlModifier - 修饰键；
AltModifier - 修饰键；
MetaModifier - 修饰键；
KeypadModifier - 附加键盘上的任何按键；
GroupSwitchModifier - 按下键(仅限X11系统)。
isAutoRepeat(): 如果一直按着某键，返回True；否则，返回False；

键盘事件函数里面的传参对象有很多方法

其中modifiers方法用来获取修饰键
key用来获取普通键

（2）键盘按键捕获案例实战

监听用户输入Tab键
监听用户输入Ctrl+S组合键
监听用户输入Ctrl+Shift+S

from PyQt5.Qt import *

#标签类
class Label(QLabel):
    #键盘事件
    # QKeyEvent
    def keyPressEvent(self, QKeyEvent):
        print("用户按键盘了")
        print("当前按下的普通键是",QKeyEvent.key())
        print("当前按下的修饰键是",QKeyEvent.modifiers())

        #QKeyEvent.modifiers()捕捉修饰键。QKeyEvent.key()捕获普通键
        if QKeyEvent.modifiers() == Qt.ControlModifier | Qt.ShiftModifier and QKeyEvent.key() == Qt.Key_S:
            print("用户按下了 Ctrl+Shit+S")


        if QKeyEvent.key() == Qt.Key_Tab:
            print("用户按下了tab键")


if __name__ == '__main__':
    import sys
    app = QApplication(sys.argv)

    window = QWidget()
    window.resize(500,500)

    label = Label(window)
    label.move(100,100)
    label.resize(200,200)

    label.setStyleSheet("background-color: cyan;")
    #需要设置键盘监听，确定是哪个控件监听键盘事件，不然触发不了键盘事件函数
    #捕获键盘，捕获鼠标，捕获手势等都有
    label.grabKeyboard()


    window.show()


    sys.exit(app.exec_())

运行，随便按个空格键

按下ctrl shift s

按下tab键

4.总结

能捕获到键盘和鼠标等设备的动作，就可以定制化实现各种我们需要的功能，比如点击后做什么，按下什么键执行什么操作，都可以开发出来，感兴趣的小伙伴赶紧尝试下吧。