QMouseEvent Class
QMouseEvent 类包含描述鼠标事件的参数。更多
| 头文件： | #include <QMouseEvent> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS Gui)target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake： | QT += gui |
| 继承： | QSinglePointEvent |
- 所有成员（包括继承成员）的列表
- 已废弃成员
- QMouseEvent 属于事件类。
公共函数
| QMouseEvent(QEvent::Type type, const QPointF &localPos, const QPointF &globalPos, Qt::MouseButton button, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers, const QPointingDevice *device = QPointingDevice::primaryPointingDevice()) | |
| QMouseEvent(QEvent::Type type, const QPointF &localPos, const QPointF &scenePos, const QPointF &globalPos, Qt::MouseButton button, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers, const QPointingDevice *device = QPointingDevice::primaryPointingDevice()) | |
| Qt::MouseEventFlags | flags() const |
详细说明
当鼠标按键在 widget 中被按下或释放，或者鼠标光标被移动时，鼠标事件就会发生。
只有当鼠标按钮被按下时才会发生鼠标移动事件，除非使用QWidget::setMouseTracking() 启用了鼠标跟踪功能。
当鼠标按钮在 widget 内被按下时，Qt 会自动抓取鼠标；该 widget 将继续接收鼠标事件，直到最后一个鼠标按钮被释放。
鼠标事件包含一个特殊的接受标志，表示接收者是否需要该事件。如果鼠标事件未被部件处理，则应调用ignore() 。鼠标事件会沿着父窗口部件链向上传播，直到某个窗口部件使用accept() 接受了该事件，或者某个事件过滤器消耗了该事件。
注意： 如果鼠标事件被传播到已设置Qt::WA_NoMousePropagation 的widget ，则该鼠标事件将不会在父窗口部件链中继续向上传播。
通过调用继承自QInputEvent 的modifiers() 函数，可以找到键盘修改键的状态。
position() 函数给出了光标相对于接收鼠标事件的部件或项目的位置。如果因鼠标事件而移动部件，则应使用globalPosition() 返回的全局位置，以避免晃动。
QWidget::setEnabled() 函数可用于启用或禁用部件的鼠标和键盘事件。
重新实现QWidget 事件处理程序、QWidget::mousePressEvent() 、QWidget::mouseReleaseEvent() 、QWidget::mouseDoubleClickEvent() 和QWidget::mouseMoveEvent() 可在自己的窗口部件中接收鼠标事件。
另请参阅 QWidget::setMouseTracking()、QWidget::grabMouse() 和QCursor::pos()。
成员函数文档
QMouseEvent::QMouseEvent(QEvent::Type type, const QPointF &localPos, const QPointF &globalPos, Qt::MouseButton button, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers, const QPointingDevice *device = QPointingDevice::primaryPointingDevice())
构造源于device 的鼠标事件对象。
type 参数必须是QEvent::MouseButtonPress,QEvent::MouseButtonRelease,QEvent::MouseButtonDblClick 或QEvent::MouseMove 。
localPos 是鼠标光标相对于接收部件或项目的位置。光标在屏幕坐标中的位置由globalPos 指定。窗口位置设置为与localPos 相同的值。引起该事件的button 是Qt::MouseButton 枚举中的一个值。如果事件type 是MouseMove ，则该事件的相应按钮是Qt::NoButton 。buttons 是事件发生时所有按钮的状态，modifiers 是所有键盘修改器的状态。
QMouseEvent::QMouseEvent(QEvent::Type type, const QPointF &localPos, const QPointF &scenePos, const QPointF &globalPos, Qt::MouseButton button, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers, const QPointingDevice *device = QPointingDevice::primaryPointingDevice())
构造鼠标事件对象。
type 参数必须是QEvent::MouseButtonPress,QEvent::MouseButtonRelease,QEvent::MouseButtonDblClick, 或QEvent::MouseMove 。
localPos 、scenePos 和globalPos 分别指定鼠标指针相对于接收部件或项目、窗口、屏幕或桌面的位置。
引起事件的button 是Qt::MouseButton 枚举中的一个值。如果事件type 是MouseMove ，则该事件的相应按钮是Qt::NoButton 。buttons 是事件发生时所有按钮的状态，modifiers 是所有键盘修改器的状态。
Qt::MouseEventFlags QMouseEvent::flags() const
返回鼠标事件标志。
鼠标事件标志提供了鼠标事件的附加信息。
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
