Version: 2021.2
Synthesizing events
捕获事件

事件参考

当用户与 UI 工具包中的元素交互并更改这些元素的状态时,UI 工具包会发送一个事件。例如,以下操作均已关联:

  • 调整窗口大小
  • 选择面板
  • 按下键盘上的一个键

事件的设计类似于用于 HTML 元素的事件接口

事件系列

事件类型适合基于 EventBase 类的层级视图。每个事件系列都实现了一个接口;该接口定义了同一系列的所有事件的共同特征。例如,BlurEventFocusEvent 使用 FocusEventBase 类。

选择下面列出的任何事件类型,以获取有关事件、其父类和 API 文档链接的更多信息。

事件参考表

下表是每种事件类型的简单概述。有关某个事件的更多信息,请参阅上面列出的页面。

事件类型 描述 涓滴 冒泡 可取消
捕获事件
MouseCaptureEvent 当某一元素接受鼠标捕获时发送。
MouseCaptureOutEvent 当某一元素释放鼠标捕获或以其他方式失去鼠标捕获时发送。
PointerCaptureEvent 当某一元素捕获指针时发送。
PointerCaptureOutEvent 当某一元素释放指针时发送。
更改事件
ChangeEvent 当某个元素的值更改时发送的通用事件。
命令事件
ValidateCommandEvent IMGUI 可确定该命令是否由面板中的某一元素处理时发送此事件。
ExecuteCommandEvent 当面板中的某一元素应执行命令时,IMGUI 发送此事件。
拖动事件
DragExitedEvent 在拖放过程结束时发送。
DragUpdatedEvent 在拖动的元素移到放置目标上方时发送。
DragPerformEvent 在拖动的元素放置到可接收目标上方时发送。
DragEnterEvent 拖动的元素进入了新的 VisualElement。此事件在拖动操作开始时发送。
DragLeaveEvent 拖动的元素离开了当前放置目标。此事件在拖动操作结束时发送。
焦点事件
FocusOutEvent 某一元素失去焦点前发送。
FocusInEvent 某一元素获得焦点前发送。
BlurEvent 某一元素失去焦点后发送。
FocusEvent 某一元素获得焦点后发送。
IMGUI 事件
IMGUIEvent 发送以封装 IMGUI 特定事件。
输入事件
InputEvent 在数据输入到视觉元素(通常是控件)时发送。
键盘事件
KeyDownEvent 用户按下键盘上的某个键时发送。
KeyUpEvent 用户松开键盘上的某个键时发送。
布局事件
GeometryChangedEvent 当某一元素的位置或尺寸发生变化时发送。
鼠标事件
MouseDownEvent 当用户按下鼠标键时发送。
MouseUpEvent 当用户释放鼠标键时发送。
MouseMoveEvent 当用户移动鼠标时发送。
WheelEvent 当用户激活鼠标滚轮时发送。
MouseEnterWindowEvent 当鼠标进入某个窗口时发送。 Yes
MouseLeaveWindowEvent 当鼠标离开某个窗口时发送。 Yes
MouseEnterEvent 当鼠标进入某一元素或其后代之一时发送。
MouseLeaveEvent 当鼠标离开某一元素或其后代之一时发送。
MouseOverEvent 当鼠标进入某一元素时发送。
MouseOutEvent 当鼠标离开某一元素时发送。
ContextClickEvent(已弃用) 用户按下并松开第三个鼠标键时发送。此事件用于向后兼容 IMGUI。
指针事件
PointerDownEvent 当您按下指针时发送。
PointerUpEvent 当您松开指针时发送。
PointerMoveEvent 当指针状态变化时发送。
PointerEnterEvent 当指针进入某一视觉元素或其后代之一时发送。
PointerLeaveEvent 当指针离开某一视觉元素及其所有后代时发送。
PointerOverEvent 当指针进入某一视觉元素时发送。
PointerOutEvent 当指针离开某一视觉元素时发送。
PointerStationaryEvent 当某个指针类型(如触笔或手指)经过操作系统设定的时间量之后未发生变化时发送。
PointerCancelEvent 当操作系统取消指针操作时发送。
面板事件
AttachToPanelEvent 在元素附加到某个面板后立即发送。
DetachFromPanelEvent 在元素即将从某个面板分离时发送。
工具提示事件
TooltipEvent 在即将显示某个工具提示时发送。

  • 2018–11–02 页面已修订
Synthesizing events
捕获事件