PyQt5编程-鼠标事件

处理鼠标事件的频率不低于键盘事件。包括按下、松开鼠标按键；移动鼠标到特定区域或离开特定区域；更改鼠标指针的形状，等等。

    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( )通常配合使用。