QSinglePointEvent 类

包含单点指针事件 (譬如:鼠标事件) 的基类。 更多...

头: #include <QSinglePointEvent>
CMake: find_package(Qt6 COMPONENTS Gui REQUIRED)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
Since: Qt 6.0
继承: QPointerEvent
继承者: QEnterEvent , QHoverEvent , QMouseEvent , QNativeGestureEvent , QTabletEvent ,和 QWheelEvent

特性

公共函数

Qt::MouseButton button () const
Qt::MouseButtons buttons () const
QObject * exclusivePointGrabber () const
QPointF globalPosition () const
QPointF position () const
QPointF scenePosition () const
void setExclusivePointGrabber (QObject * exclusiveGrabber )

重实现公共函数

virtual bool isBeginEvent () const override
virtual bool isEndEvent () const override
virtual bool isUpdateEvent () const override

详细描述

特性文档编制

exclusivePointGrabber : QObject *

此特性保持将接收未来更新的对象

独占抓取器是已选取以接收所有未来更新事件并包含此事件携带的相同点释放事件的对象。

设置 exclusivePointGrabber 特性很方便,相当于:

setExclusiveGrabber(points().first(), exclusiveGrabber);
					

访问函数:

QObject * exclusivePointGrabber () const
void setExclusivePointGrabber (QObject * exclusiveGrabber )

成员函数文档编制

Qt::MouseButton QSinglePointEvent:: button () const

返回导致事件的按钮。

返回值始终是 Qt::NoButton 对于鼠标移动事件而言,及 TabletMove , TabletEnterProximity ,和 TabletLeaveProximity 事件。

另请参阅 buttons ().

Qt::MouseButtons QSinglePointEvent:: buttons () const

返回按钮状态,当生成事件时。

按钮状态是组合的 Qt::LeftButton , Qt::RightButton ,和 Qt::MiddleButton 使用 OR 运算符。

对于鼠标移动或 TabletMove 事件,这是被按下的所有按钮。

对于鼠标按下、双击、或 TabletPress 事件,这包括导致事件的按钮。

对于鼠标释放或 TabletRelease 事件,这排除导致事件的按钮。

另请参阅 button ().

QPointF QSinglePointEvent:: globalPosition () const

返回此事件中的点在屏幕 (或虚拟桌面) 上的位置。

注意: 鼠标指针全局位置的记录 当事件发生时 。这对异步窗口系统 (譬如 X11) 很重要;每当围绕响应鼠标事件移动 Widget 时,globalposition() 会非常不同于当前光标位置返回通过 QCursor::pos ().

另请参阅 position ().

[override virtual] bool QSinglePointEvent:: isBeginEvent () const

返回 true 若此事件表示 button 被按下。

[override virtual] bool QSinglePointEvent:: isEndEvent () const

返回 true 若此事件表示 button 被释放。

[override virtual] bool QSinglePointEvent:: isUpdateEvent () const

返回 true 若此事件不包括改变在 按钮状态 .

QPointF QSinglePointEvent:: position () const

返回此事件中点的位置,相对于接收事件的 Widget 或项。

若围绕响应鼠标事件移动 Widget,使用 globalPosition () 代替。

另请参阅 globalPosition ().

QPointF QSinglePointEvent:: scenePosition () const

返回此事件中点的位置,相对于窗口或场景。

另请参阅 QEventPoint::scenePosition .