Qt3DInput::QMouseHandler Class
class Qt3DInput::QMouseHandler当连接到QMouseDevice 实例时，提供了一种接收鼠标事件通知的方式。更多内容...
| 头文件： | #include <Qt3DInput/QMouseHandler> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS 3dinput) target_link_libraries(mytarget PRIVATE Qt6::3dinput) |
| qmake： | QT += 3dinput |
| 在 QML 中： | MouseHandler |
| 继承自： | Qt3DCore::QComponent |
| 状态： | 已弃用 |
该类已弃用。我们强烈建议不要在新代码中使用它。
属性
- containsMouse : bool
- sourceDevice : Qt3DInput::QMouseDevice*
公共函数
| QMouseHandler(Qt3DCore::QNode *parent = nullptr) | |
| bool | containsMouse() const |
| Qt3DInput::QMouseDevice * | sourceDevice() const |
公共槽位
| void | setSourceDevice(Qt3DInput::QMouseDevice *mouseDevice) |
信号
| void | clicked(Qt3DInput::QMouseEvent *mouse) |
| void | containsMouseChanged(bool containsMouse) |
| void | doubleClicked(Qt3DInput::QMouseEvent *mouse) |
| void | entered() |
| void | exited() |
| void | positionChanged(Qt3DInput::QMouseEvent *mouse) |
| void | pressAndHold(Qt3DInput::QMouseEvent *mouse) |
| void | pressed(Qt3DInput::QMouseEvent *mouse) |
| void | released(Qt3DInput::QMouseEvent *mouse) |
| void | sourceDeviceChanged(Qt3DInput::QMouseDevice *mouseDevice) |
| void | wheel(Qt3DInput::QWheelEvent *wheel) |
另请参阅 QMouseDevice 和QMouseEvent 。
属性文档
[read-only] containsMouse : bool
如果QMouseHandler 当前包含鼠标，则返回true 。
注意：在 此上下文中 ，“包含”意味着源自鼠标的光线与聚合当前QMouseHandler 实例组件的 Qt3DCore::QEntity 发生了相交。
访问函数：
| bool | containsMouse() const |
通知器信号：
| void | containsMouseChanged(bool containsMouse) |
sourceDevice : Qt3DInput::QMouseDevice*
保存QMouseHandler 实例的当前鼠标源设备。
访问函数：
| Qt3DInput::QMouseDevice * | sourceDevice() const |
| void | setSourceDevice(Qt3DInput::QMouseDevice *mouseDevice) |
通知器信号：
| void | sourceDeviceChanged(Qt3DInput::QMouseDevice *mouseDevice) |
成员函数文档
[explicit] QMouseHandler::QMouseHandler(Qt3DCore::QNode *parent = nullptr)
创建一个新的 QMouseHandler 实例，其父类为parent 。
[signal] void QMouseHandler::clicked(Qt3DInput::QMouseEvent *mouse)
当鼠标按钮被点击时，会触发此信号，事件详细信息包含在mouse 中。
[signal] void QMouseHandler::doubleClicked(Qt3DInput::QMouseEvent *mouse)
当鼠标按钮被双击时，会发出此信号，事件详细信息包含在mouse 中。
[signal] void QMouseHandler::entered()
[signal] void QMouseHandler::exited()
[signal] void QMouseHandler::positionChanged(Qt3DInput::QMouseEvent *mouse)
当鼠标位置发生变化时，会发出此信号，事件详细信息包含在mouse
[signal] void QMouseHandler::pressAndHold(Qt3DInput::QMouseEvent *mouse)
当鼠标按钮被按下并持续按住时，会发出此信号，其中包含事件的详细信息mouse
[signal] void QMouseHandler::pressed(Qt3DInput::QMouseEvent *mouse)
当鼠标按钮被按下时，会发出此信号，事件详细信息包含在mouse
[signal] void QMouseHandler::released(Qt3DInput::QMouseEvent *mouse)
当鼠标按钮被释放时，会发出此信号，事件详细信息包含在mouse
[slot] void QMouseHandler::setSourceDevice(Qt3DInput::QMouseDevice *mouseDevice)
将QMouseHandler 实例的鼠标设备设置为mouseDevice 。
注意： 这是属性sourceDevice 的设置 函数。
另请参阅 sourceDevice()。
[signal] void QMouseHandler::wheel(Qt3DInput::QWheelEvent *wheel)
当使用鼠标滚轮时会发出此信号，事件详情包含在wheel
© 2026 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.
