当您使用鼠标与 UI 交互时会发生鼠标事件。触控、笔或其他指针设备会生成其他事件，而不是鼠标事件。 在鼠标事件 API 和本文档中，术语“鼠标”仅指物理鼠标或模拟物理鼠标的虚拟鼠标。

鼠标事件总是以相应的 PointerEvent 开始。

所有鼠标事件的基类是 MouseEventBase。

button：button 属性返回一个整数，该整数标识被按下以触发事件的鼠标键。下表列出了整数和关联的鼠标键：

pressedButtons：pressedButton 属性返回一个整数，用于标识当前按下的鼠标键组合。

该数字是单个鼠标键的整数值的总和（见下表）。例如，同时按住鼠标右键和鼠标中键将导致 pressedButton 的值为 6。

modifiers：modifiers 属性返回在键盘事件期间按下的修改键。修改键的一些示例是 Shift、Ctrl 或 Alt 键。

有关更多信息，请参阅 MDN 文档的“修改键”部分。

mousePosition：mousePosition 属性返回面板内的鼠标位置，也称为屏幕坐标系。有关面板坐标的更多信息，请参阅视觉树页面。

localMousePosition：localMousePosition 属性返回相对于目标视觉元素的坐标。

mouseDelta：上一个鼠标事件与当前鼠标事件之间指针位置的差异。

以下列表提供了该事件系列中每个事件的名称、描述和目标。有关事件的更多信息，请参阅 UI 工具包 API。

当光标位于视觉元素内时按下鼠标键时发送 MouseDownEvent。

target：接收鼠标捕获的视觉元素。否则是光标下最上层的可选元素。

当光标位于视觉元素内时释放鼠标键时触发 MouseUpEvent。MouseUpEvent 是 MouseDownEvent 的互补事件。

target：接收鼠标捕获的视觉元素。否则是光标下最上层的可选元素。

当光标热点在视觉元素内移动时发送 MouseMoveEvent。

target：接收鼠标捕获的视觉元素。否则是光标下最上层的可选元素。

按下鼠标滚轮时发送 WheelEvent。

target：接收鼠标捕获的视觉元素。否则是光标下最上层的可选元素。

当光标移动到编辑器窗口时触发 MouseEnterWindowEvent。当您进入 Game 视图窗口时，运行时面板不会收到此事件。

target：接收鼠标捕获的视觉元素。否则是光标下最上层的可选元素。

当光标退出编辑器窗口的空间时触发 MouseLeaveWindowEvent。MouseLeaveWindowEvent 与 MouseEnterWindowEvent 相对应。

target：接收鼠标捕获的视觉元素。否则它返回 null，因为光标不在元素上。

当光标移动到视觉元素或其后代之一时发送 MouseEnterEvent。

target：鼠标光标下的视觉元素或其后代之一。

当光标移动到视觉元素之外时触发 MouseLeaveEvent。此事件与 MouseOutEvent 的不同之处在于，此事件将发送到鼠标退出的每个元素。此事件不会传播。

target：鼠标光标退出的视觉元素（或其后代之一）。

当光标进入一个元素时发送 MouseOverEvent。此事件与 MouseEnterEvent 不同，因为此事件仅发送到鼠标进入的元素。

target：位于鼠标光标下的视觉元素。

当指针设备将光标移动到视觉元素的边界之外时触发 MouseOutEvent。

MouseOutEvent 与 MouseLeaveEvent 的不同之处在于 MouseOutEvent 在离开视觉元素到任何其他元素时发送，而 MouseLeaveEvent 在从视觉元素转换到后代元素时不发送。

target：鼠标光标退出的视觉元素。

当需要使用菜单项填充上下文菜单时由 ContextualMenuManager 发送的事件。

target：要构建上下文菜单的视觉元素。

用户按下并松开第三个鼠标键时发送的事件。此事件仅用于向后兼容 IMGUI。

下面的代码示例创建一个带有三个按钮的编辑器窗口，当鼠标移到一个元素上或按下鼠标上的按键时，将消息打印到控制台。

此代码示例重点演示 MouseDownEvent 和 MouseEnterEvent 的事件触发，以及如何使用事件参数。

要查看示例运行效果，请执行以下操作：