合成事件

内置控件

事件类型参考

本主题将提供每种事件类型的概要。请参阅 API 文档了解每个事件成员及其用途的完整描述。

捕获事件

实现 IMouseCaptureEvent 的事件。

MouseCaptureEvent

元素接受鼠标捕获时发送 MouseCaptureEvent。

target：接受捕获的元素。

MouseCaptureOutEvent

元素释放鼠标捕获或以其他方式失去鼠标捕获时发送 MouseCaptureOutEvent。

target：失去捕获的元素。

更改事件

实现 IChangeEvent 的事件。

ChangeEvent

ChangeEvent<T> 是元素值更改时发送的通用事件。通常在控件更改时发送。对于 InputEvent 控件，不会针对控件中的每个输入事件发送此事件，而是仅在值更改时发送。通常是控件失去焦点或按下 Enter 键时。

<T> ：值的类型。

target ：发生值更改的元素。

previousValue ：旧控件值。

newValue ：新控件值。

命令事件

实现 ICommandEvent 的事件。

target ：获得键盘焦点的元素。如果没有元素获得焦点，则为 null。

commandName ：用于验证或执行的命令。

ValidateCommandEvent

此事件由 IMGUI 发送，同时可确定该命令是否由面板中的元素处理。

ExecuteCommandEvent

当面板中的元素执行命令时，IMGUI 将发送此事件。

拖放事件

拖放操作期间发送的事件。

DragExitedEvent

已取消拖放操作。放置目标未接受拖动元素。

DragUpdatedEvent

拖动的元素移到放置目标上方。如果放置目标愿意接受拖动的元素，则此事件的回调应设置 DragAndDrop.visualMode 以确保在用户松开鼠标键时发送 DragPerformEvent。

DragPerformEvent

拖动的元素已放置在接受它们的目标上。拖放操作现在已完成。

DragEnterEvent

拖动的元素进入了新的 VisualElement。具体而言，此事件在拖动操作开始时发送。

DragLeaveEvent

拖动的元素离开了当前放置目标。具体而言，此事件在拖动操作结束时发送。

布局事件

GeometryChangedEvent

当元素的位置或尺寸发生变化时发送的事件。此类型的事件仅发送到事件目标。它们不会传播。

target ：具有新几何形状的元素。

oldRect ：元素先前的位置和尺寸。

newRect ：元素的新位置和尺寸。

焦点事件

实现 IFocusEvent 的事件。

在元素获得或失去键盘焦点时发送这些事件。有两组焦点事件：

在焦点发生变化之前沿着传播路径发送 FocusOutEvent 和 FocusInEvent 事件。
在焦点变化后仅立即将 FocusEvent 和 BlurEvent 事件发送到事件目标。

FocusOutEvent

当元素即将失去焦点时发送的事件。

target ：将失去焦点的元素。

relatedTarget ：将获得焦点的元素。

FocusInEvent

当元素即将获得焦点时发送的事件。

target ：将获得焦点的元素。

relatedTarget ：将失去焦点的元素。

BlurEvent

当元素失去焦点后发送的事件。

target ：失去焦点的元素。

relatedTarget ：获得焦点的元素。

FocusEvent

当元素获得焦点后发送的事件。

target ：获得焦点的元素。

relatedTarget ：失去焦点的元素。

输入事件

InputEvent

将数据输入到视觉元素（通常是控件）时发送的事件。此事件与 ChangeEvent 的不同之处在于，即使控件的值未更改，也会针对控件中的每个输入事件发送此事件。

target ：执行输入的元素。

previousData ：以前的数据。

newData ：新数据。

键盘事件

实现 IKeyboardEvent 的事件。

KeyDownEvent

用户按下键盘上的键时发送的事件。

target ：具有键盘焦点的元素。如果没有元素具有键盘焦点，则为面板的根元素。

KeyUpEvent

用户松开键盘上的键时发送的事件。

target ：具有键盘焦点的元素。如果没有元素具有键盘焦点，则为面板的根元素。

鼠标事件

实现 IKeyboardEvent 的事件。

当元素捕获鼠标时，鼠标事件仅发送到进行捕获的元素。无传播。