Version: Unity 6.0 (6000.0)
语言 : 中文
操控器
事件参考

合成和发送事件

在合成和发送自定义事件之前,需了解 UI 工具包事件系统如何分配和发送操作系统事件

UI 工具包通过面板将事件发送到视觉元素。如果事件没有目标,则发送到面板的根元素。元素必须有目标才能获得传播路径,并且发送方必须预先设置该目标。某些事件类型不需要目标。例如,键盘事件发送到获得焦点的元素,指针事件发送到指针下的元素。

事件系统使用事件池来避免重复分配事件对象。

通过以下步骤合成和发送自己的事件:

  1. 从事件池中获取一个事件对象。
  2. 填写事件属性。
  3. 将事件包含在 using 代码块中以确保其返回到事件池。
  4. 将事件传递给 panel.visualTree.SendEvent()

您可以发送操作系统事件,例如键盘和指针事件。为此,请使用 UnityEngine.Event 初始化__ UI__(即用户界面,User Interface)让用户能够与您的应用程序进行交互。Unity 目前支持三种 UI 系统。更多信息
See in Glossary
工具包事件。

以下示例演示了如何合成和发送事件:

void SynthesizeAndSendKeyDownEvent(IPanel panel, KeyCode code,
     char character = '\0', EventModifiers modifiers = EventModifiers.None)
{
    // Create a UnityEngine.Event to hold initialization data.
    var evt = new Event() {
        type = EventType.KeyDownEvent,
        keyCode = code,
        character = character,
        modifiers = modifiers
    };

    using (KeyDownEvent keyDownEvent = KeyDownEvent.GetPooled(evt))
    {
        panel.visualTree.SendEvent(keyDownEvent);
    }
}

重要提示:不要发送来自操作系统外部或 UnityEngine.Event 类型中不存在的事件。UI 工具包会发送一些事件作为对内部状态变化的反应。外部进程不得发送这些事件。例如,如果发送 PointerCaptureEvent,视觉元素会假设满足该事件的基本条件,而不会为它们设置指针捕获。这可能会破坏视觉元素的内部配置并导致未定义的行为。

其他资源

操控器
事件参考