PYTHON+QT5窗体及窗体上控件的事件响应顺序示例

对PYQT5除了要设计精美的控件布局，还要了解QT5的信号槽和事件响应机制，我的另一文章有对信号槽的示例，本示例尽量列举了窗体及窗体上控件常用的事件响应函数，同时用print在终端显示和事件触发时的先后顺序，以便在事件中编写逻辑代码时知道代码的执行顺序，供初学小白参考学习。

import sys
from PyQt5 import *
from PyQt5.QtWidgets import *
from PyQt5.QtCore import QEvent, qDebug,Qt
from PyQt5 import QtGui
from PyQt5.QtGui import *

class MyWindow(QWidget):
    id=1
    def __init__(self):
        super().__init__()
        self.setWindowTitle('事件机制窗体')
        self.resize(600, 450)
        self.move(300, 300)
        self.label = QLabel()  # 建立一个标签：不重载，使用QT的
        self.label = MyLabel()  # 建立一个标签
        self.btn = MyBtn()      # 建立一个按纽：重载，使用重定义继承的
        self.edt1=MydropEdit('将此文本选中后拖向另一编辑框', self)  # 建立一下编辑框：重载，使用重定义继承支持可拖施功能的
        self.edt1.setDragEnabled(True)  #文本框支持拖放
        self.edt2=MydropEdit('将此文本选中后拖向另一编辑框', self)  # 建立一下编辑框：重载，使用重定义继承支持可拖施功能的
        self.edt2.setDragEnabled(True)  #文本框支持拖放
        self.edt1.setGeometry(300,300,280,40)
        self.edt2.setGeometry(300,400,280,40)
        self.label.setFrameShape(QFrame.Box)
        layout = QHBoxLayout()  #除两编辑框控件外其他控件指定位置水平布局 
        layout.addWidget(self.label)
        self.label.setText('这是在窗体上建立的一重构标签类控件')
        layout.addWidget(self.btn)
        self.setLayout(layout)
        self.label.installEventFilter(self)  # 给label控件安装事件过滤器
        self.btn.installEventFilter(self)  # 给按纽控件安装事件过滤器
        self.btn.clicked.connect(self.frm_btn_click)   #按纽被鼠标按下的槽函数(在自定义按纽类中有同样的代码，)
    ##########################################################################  
    #事件过滤器：鼠标移入、移出、在窗体内单击等均会触发此函数
    #如此函数返回False，发生上述事件时，先调用本函数，再调用其他事件函数
    def eventFilter(self, obj, event):  # 事件过滤器
        if event.Type == QEvent.Type.KeyPress:
            print(f'1主窗体事件过滤函数：键盘压下被调用次数={self.id}')
        print(f'2主窗体事件过滤函数：鼠标移入窗体或窗体上的控件时,或按下在窗体上滑动时的事件过滤器函数被调用次数={self.id}')
        self.id=self.id+1      
        return False  #返回False表示此事件未被处理，其他的事件函数会被继续处理，如鼠标单击，如返回True,则其他事件不会被处理(窗体事件及窗体上的子控件事件)
    
    #窗体所事件重载(过滤器):先调用此事件函数，接着再调用下面各分类事件函数
    #一般控件而言，事件的产生均先被父控件检测到，也就是说，如果有为子控件安装过滤器的话，事件都要经过过滤器再到达子控件的事件响应函数。并且，
    # 可以实现在过滤器中拦截事件：此event函数必须有返回值，返回值是bool类型。当过滤器函数返回True时，表示事件已经被处理掉，则事件不会再传递给子控件，
    # 相当于事件被拦截、被扼杀了；反之，返回False表示事件没有被处理，仍需要往下传递。
    def event(self, event):
        #print('主窗体所有事件：在下面if中分类别进行处理')
        if event.type() == QEvent.Type.MouseButtonPress:
            print('3主窗体event事件：鼠标被压下')        
        elif event.type() == QEvent.Type.MouseButtonRelease:
            print('4主窗体event事件：鼠标被释放')
        elif event.type() == QEvent.Type.KeyPress:
            print('5主窗体event事件：键盘被压下')
        elif event.type() == QEvent.Type.KeyRelease:
            print('6主窗体event事件：键盘被释放')    
        #。。。。。。。。。。。等等，可出将下面的细类全部放入此一个函数体中集合
        return super().event(event)  #如需要，再返回一值到主窗的的父类事件中，如不需要return False
    
    #以下事件相当于上面总事件的细分事件，各响应各的，不汇集到一个event事件中用IF来处理
    #窗体鼠标按下事件重载
    def mousePressEvent(self, event):
        key_name = event.button()
        # 如果是左键点击
        if event.button() == Qt.LeftButton:
            #QMessageBox.information(self, "鼠标在窗体上压下", "鼠标左键点击位置：" + str(event.pos()))
            print(f'7主窗体mousePressEvent事件:鼠标左键点击位置：x={event.pos().x()},y={event.pos().y()}')
        # 如果是右键点击
        elif event.button() == Qt.RightButton:
            print(f'8主窗体mousePressEvent事件:鼠标右键点击位置：x={event.pos().x()},y={event.pos().y()}')
        # 如果是中键点击
        elif event.button() == Qt.MiddleButton:
            print(f'9主窗体mousePressEvent事件:鼠标中键点击位置：x={event.pos().x()},y={event.pos().y()}')
    #窗体鼠标放开事件重载
    def mouseReleaseEvent(self, event):
        # 如果是左键点击
        if event.button() == Qt.LeftButton:
            print(f'10主窗体mouseReleaseEvent事件:鼠标左键放开位置：x={event.pos().x()},y={event.pos().y()}')
        # 如果是右键点击
        elif event.button() == Qt.RightButton:
            print(f'11主窗体mouseReleaseEvent鼠标右键放开位置：x={event.pos().x()},y={event.pos().y()}')
        # 如果是中键点击
        elif event.button() == Qt.MiddleButton:
            print(f'12主窗体mouseReleaseEvent鼠标中键放开位置：x={event.pos().x()},y={event.pos().y()}')

    #窗体鼠标移动事件重载:屏幕坐标=窗体左上角坐标+鼠标在主窗体相对主窗体左上角(0,0)的坐标
    def mouseMoveEvent(self, event):
        print(f'13主窗体mouseMoveEvent鼠标移动事件,逻辑坐标x={event.pos().x()},y={event.pos().y()}     屏幕坐标:x={event.globalPos().x()},y={event.globalPos().y()}')
        #print(event.windowPos(),event.screenPos())    #返回值分别为控件的浮点坐标值 和 屏幕的浮点坐标值
    #窗体鼠标双击事件。
    def mouseDoubleClickEvent(self, event):
        print(f'14主窗体mouseDoubleClickEvent事件：鼠标双击')
    #鼠标滚轮事件
    def wheelEvent(self, event):                       
        print(f'15主窗体wheelEvent事件：鼠标滚轮事件转过的角度={event.angleDelta().y()}')   #滚轮转过的数值，单位为1/8度

    #移入窗体上控件所在矩形区域时发生的事件
    def enterEvent(self, event):                        
        print('16主窗体enterEvent事件：鼠标进入主窗体界面事件')
    #移出窗体上控件边缘发生事件
    def leaveEvent(self,event):                         
        print('17主窗体leaveEvent事件：鼠标移出主窗体界面事件')
    #窗体处理键盘按键按下事件
    def keyPressEvent(self,event):
        key_name = event.key()
        print(f'18主窗体keyPressEvent键盘按键事件：文本={event.text()}, 类型={event.type()},key值={event.key()}')
        if key_name == Qt.Key_Down:
            print('19主窗体keyPressEvent事件：按下键盘方向向下键')
        if key_name == Qt.Key_A:
            print('19主窗体keyPressEvent事件：按下键盘A键')
        if (key_name == Qt.Key_A) and (QApplication.keyboardModifiers() == Qt.ShiftModifier):
            print('19主窗体keyPressEvent事件：按下组合键盘SHIFT+A键')    
        #......
        if ( key_name ==Qt.Key_Escape):
            self.close()   #按下ESC键关闭主窗口      

    #窗体处理键盘松开事件
    def keyReleaseEvent(self, event):
        print('20主窗体keyReleaseEvent事件：松开键盘')
    #窗体重绘事件     
    def paintEvent(self,event):
        print('21主窗体paintEvent事件：重画窗体')

    #窗体获得焦点事件
    def focusInEvent(self,event):
        print('22主窗体focusInEvent事件：窗体获得焦点')

    #focusOutEvent(event)：窗体失去焦点事件
    def focusOutEvent(self,event):
        print('23主窗体focusOutEvent事件：窗体失去焦点')

    #窗体窗口大小调整事件
    def resizeEvent(self,event):
        print('24主窗体resizeEvent事件：窗体窗口大小调整')

    #窗口移动事件
    def moveEvent(self,event):
        print('25主窗体moveEvent事件：窗体移动')


    #窗体定时器事件
    def timerEvent(self,event):
        print('26主窗体timerEvent事件：窗体定时器')
    
    #窗体拖放进入事件
    def dragEnterEvent(self,event):
        print('27主窗体dragEnterEvent事件：从其他地方拖放对象到主窗体上')

    #窗体拖放移动事件
    def dragMoveEvent(self,event):
        print('28主窗体dragMoveEvent事件：从主窗体拖放对象到其他可接纳对象事件')

    #在窗体中定义的按纽被单击时的信号槽函数，同时重载按纽类中也有一被单击时的信号槽函数
    def frm_btn_click(self):
        print('29主窗体中的按纽被单击时的绑定的自定义槽函数frm_btn_click')
      
        
#重载标签控件，以方便重载标签的事件(前提是，object父类事件函数返回False,窗件的事件函数返回False)
#如果在标签控件上点击，事件的传输方式：先调用标签控件重载的事件函数，再调用窗体事件函数，最后调用eventFilter函数
#如果在标签外点击窗体，事件传输方式：先调用窗体事件函数，再调用eventFilter函数
#使鼠标移入移出窗体，不点击操作，只会调用eventFilter函数
#如果将eventFilter函数返回值为True ,点击标签，即不会调用标签重载类事件也不会调用窗体事件，点击窗体，会调用窗体事件，不会调用eventFilter单击函数
class MyLabel(QLabel):
    def __init__(self, text='重载标签控件'):
        super(MyLabel, self).__init__(text)
    #窗体控件事件:鼠标移进移出标签控件，按下鼠标在签标上移动，点击标签等均会触发此事件函数
    def event(self,evt):
        print('30窗体控件(标签)事件：所有类型事件')
        if evt.type() == QEvent.Type.MouseButtonPress:
            print('31窗体控件(标签)事件：鼠标被压下')        
        #。。。。。。。。。。。等等，可出将下面的细类全部放入此一个函数体中集合
        return super().event(evt)      #如需要，再返回一值到主窗口父类事件中，如不需要return False  
    #窗体控件事件：重载标签控件鼠标按下事件
    def mousePressEvent(self, evt):
        print("32窗体控件(标签)事件：重载标签控件鼠标按下事件")
        #......        
        return super().mousePressEvent(evt)
     #窗体控件事件：重载标签控件鼠标释放事件
    def mouseReleaseEvent(self, evt):
        print("33窗体控件(标签)事件：重载标签控件鼠标释放事件")
        #......
        return super().mouseReleaseEvent(evt)                     

#重载控纽控件类，在继承类中重载事件
class MyBtn(QPushButton):
    def __init__(self, text='重载按纽控件'):
        super().__init__(text)
        self.setText('重载按纽控件')
        self.setStyleSheet('background-color:green')
        self.clicked.connect(self.btn_click)   #按纽被鼠标按下的槽函数(在窗体类中有同样的代码)objject
        
    #窗体控件事件:鼠标移进移出按纽控件，按下鼠标在按纽上移动，点击按纽等均会触发此事件函数
    def event(self,evt):
        print('34重载(按纽)控件事件：所有类型事件')
        if evt.type() == QEvent.Type.MouseButtonPress:
            print('35窗体控件(标签)全部event事件：鼠标被压下')        
        #。。。。。。。。。。。等等，可出将下面的细类全部放入此一个函数体中集合
        return super().event(evt)      #如需要，再返回一值到主窗口父类事件中，如不需要return False  
          
    #窗体控件事件:鼠标按下事件 
    def mousePressEvent(self, evt):              
        print("36重载(按纽)控件事件：:鼠标按下事件")
        return super().mousePressEvent(evt)   #好象对其父窗体没有调用事件???
    #自定义按纽类中重载按纽被单击的槽函数(先执行控件中的此函数，再执行窗体中的对应点击信号槽函数)
    def btn_click(self):
        print('37重载按纽控件类中的按纽被单击时的槽函数')

#自定义重载一编辑框类,以支持可接受拖放文本功能
class MydropEdit(QLineEdit):
    def __init__(self, title, parent):
        super().__init__(title, parent)
        self.setAcceptDrops(True)  #设置可接受拖放来的文本
    def dragEnterEvent(self, evt):
        print('38编辑框控件dragEnterEvent事件：从其他控件上拖放对象到本编辑框控件上')
        if evt.mimeData().hasFormat('text/plain'):
            evt.accept()
        else:
            evt.ignore()
        super().dragEnterEvent(evt)  #如需要：回调父类同样事件
    #重载drop事件，以使按纽接受拖来的文本
    def dropEvent(self, evt):
        print('39编辑框控件dragEnterEvent事件：从本控件拖放对象到其他可接受拖放的控件上(控件类型不限，只要打开了接受属性)')
        self.setText(evt.mimeData().text())
        super().dropEvent(evt)   #如需要：回调父类同样事件

if __name__ == '__main__':
    app = QApplication(sys.argv)
    window = MyWindow() 
    window.show()
    sys.exit(app.exec())