PyQt5编程(19):鼠标事件

处理鼠标事件的频率不低于键盘事件。包括按下、松开鼠标按键;移动鼠标到特定区域或离开特定区域;更改鼠标指针的形状,等等。
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( )通常配合使用。

你可能感兴趣的:(PyQt5编程(19):鼠标事件)