pyqt5事件与鼠标事件

---

pyqt5事件与鼠标事件

---

---

一、每个事件都被封装成相应的类：

---

pyqt中，每个事件类型都被封装成相应的事件类，如鼠标事件为QMouseEvent，键盘事件为QKeyEvent等。而它们的基类是QEvent。

---

二、基类QEvent的几个重要方法：

---

accept() 表示事件已处理，不需要向父窗口传播

ignore()表示事件未处理，继续向父窗口传播f

type()返回事件类型，如QtCore.QEvent.MouseButtonPress，一般由基事件调用。因为其它事件已经知道自己的事件类型了。

还有一个自定义事件的注册方法。

---

三、QMouseEvent鼠标事件：

---

buttons()返回哪个鼠标按键被按住了。如Qt.LeftButton

globalPos()返回鼠标相对屏幕的位置QPoint

pos()返回鼠标相对处理事件的窗口的位置

---

四、处理鼠标事件的响应函数（在QWidget及其继承类中）：

---

mousePressEvent(QMouseEvent)

mouseReleaseEvent(event)

mouseMoveEvent(event)

---

五、鼠标事件的具体内容

---

1.按下、松开鼠标按键

按下并释放鼠标按钮时，将调用以下方法：

mousePressEvent (self, event) - 鼠标键按下时调用;
mouseReleaseEvent (self, event) - 鼠标键公开时调用;
mouseDoubieCiickEvent (self, event) - 双击鼠标时调用。必须注意，在双击之前的其他事件。双击时的事件顺序如下:

MouseButtonPress
MouseButtonRelease
MouseButtonDblClick
MouseButtonPress
MouseButtonRelease

QApplicaption类的setDoubleClickInterval( )方法可设置双击的时间间隔；doubleClickInterval( )方法返回双击的时间间隔。
event参数是QMouseEvent对象，存储事件的其他信息。有以下方法：

    x() 和 y() -返回相对于控件空间的鼠标坐标值;
    pos() - 返回相对于控件空间的QPoint对象;
    localPos()- 返回相对于控件空间的QPointF对象;
    globalX() 和 globalY() -  返回相对于屏幕的x,y 坐标值；
    globalPos() - 返回相对于屏幕的QPoint对象;
    windowPos() -  返回相对于窗口的QPointF对象; 
    screenPos() - 返回相对于屏幕的QPointF对象; 
    button() - 返回以下枚举值(只列了部分，详细内容参见http://doc.qt.io/qt-5/qt.html#MouseButton-enum)，用以判断是哪个鼠标健触发了事件。

QtCore.Qt.NoButton - 0 - 没有按下鼠标键。例如移动鼠标时的button()返回值；
QtCore.Qt.LeftButton -1 -按下鼠标左键；
QtCore.Qt.RightButton -2 -按下鼠标右键；
QtCore.Qt.Mion 或 QtCore.Qt.MiddleButton -4 -按下鼠标中键；

   buttons() - 返回前面所列枚举值的组合，用于判断同时按下了哪些键。
   modifiers() - 判断按下了哪些修饰键（Shift,Ctrl , Alt,等等）,详见键盘事件(18)中的modifiers()。
   timestamp() - 返回事件发生的时间；

如果要让父控件继续收到鼠标事件，要调用事件的ignore()方法；否则，调用accept()。

如果一个控件的QtCore.Qt.WA_NoMousePropagation的属性设为True,则不会将事件传递给父控件。调用setAttribute( )方法可修改此参数：
button.setAttribute (QtCore.Qt.WA_NoMousePropagation, True)

缺省情况下，鼠标事件只拦截控件区域上的鼠标操作。如果可拦截控件区域以下的鼠标事件，必须调用grabMouse( )方法；释放时，调用releaseMouse( )。

---

2.鼠标指针

---

要处理鼠标指针的移动，需要重载mouseMoveEvent(self，event)方法。缺省情况下，只有按下鼠标键移动时，才会调用mouseMoveEvent( )。如果要处理包括普通的移动，需要以参数为True调用setMouseTracking() 方法。如果要处理窗口中鼠标移动的事件，需要调用grabMouse( )方法。

event对象的pos( )返回值为相对控件的坐标，要转换成相对父控件或屏幕的坐标，需要调用QWidget类的以下方法：

 mapToGlobal (QPoint) - 将窗口坐标转换成屏幕坐标;
 mapFromGlobal(QPoint) - 将屏幕坐标转换成窗口坐标; 
 mapToParent(QPoint) - 将窗口坐标转换成父窗口坐标。如果没有父窗口，则相当于mapToGlobal (QPoint);
 mapFromParent(QPoint) - 将父窗口坐标转换成窗口坐标。如果没有父窗口，则相当于mapFromGlobal(QPoint);
 mapTo (QWidget, QPoint) - 将窗口坐标转换成 QWidget父窗口坐标;
 mapFrom (QWidget, QPoint) - 将 QWidget父窗口坐标转换成窗口坐标;

3. 鼠标移进和移出控件 鼠标移进和移出控件时，下列方法将被调用：

enterEvent (self, event) -鼠标进入控件;
leaveEvent (self, event) - 鼠标离开控件;
event是一个QEvent对象，并不包括附加信息。

4.滚动鼠标

wheelEvent (self, event)方法可用来处理鼠标滚动事件。event是一个QWheelEvent对象，包含滚轮操作的相关信息。有以下方法可调用：

angleDelta( ) - 返回QPoint对象，为滚轮转过的数值，单位为1/8度。例如：
angle=event.angleDelta( ) /8
angleX=angle.x()
angleY=angle.y()
pixelDeita () - 返回QPoint对象，为滚轮转过的像素值。
x() 和 y() - 返回相对于控件的当前鼠标的x,y位置;
pos() - 返回相对于控件的当前鼠标位置的QPoint对象;
posF() - 返回相对于控件的当前鼠标位置的QPoinFt对象;
globalX() 和globalY() - 返回相对于屏幕的当前鼠标的x,y位置;
globalPos() - 返回相对于屏幕的当前鼠标QPoint位置;
globalPosF() - 返回相对于屏幕的当前鼠标QPointF位置;
buttons(),modifiers()和timestamp()的用法参见本文“1.按下、松开鼠标按键”中的相关内容。

如果要让父控件继续收到滚轮事件，要调用事件的ignore()方法；否则，调用accept()。

5.更改鼠标指针形状

要修改鼠标进入控件后的形状，可调用QWidget的下列方法：
setCursor(QCursor qcr) - 参数qcr为QCursor对象或 Qtcore.Qt 类的枚举值,如：ArrowCursor(标准箭头)、upArrowCursor(向上箭头)、 CrossCursor(十字光标)、Waitcursor (沙漏)，等等。

   setCursor(QtCore.Qt.WaitCursor)
   unsetCursor() -  取消设置的鼠标形状。
   cursor() - 返回当前鼠标形状的QCursor对象，。

使用QApplication类中的以下静态方法来控制整个应用程序的鼠标形状：

   setOverrideCursor(QCursor qcr) - 参数qcr为QCursor对象或 Qtcore.Qt 类的枚举值。
   restoreOverrideCursor() - 取消全局鼠标形状设置；
   changeOverrideCursor(QCursor qcr) - 将鼠标形状设置为qcr。只有先调用setOverrideCursor( )了，该函数才起作用。
   overrideCursor( ) - 返回当前鼠标形状的QCursor 对象；
   setOverrideCursor()和restoreOverrideCursor( )通常配合使用。