使用事件调试器检查 UI 工具包事件

使用 UI 工具包事件调试器在 编辑（Edit） 和 播放（Play） 模式下检查和排查 UI 事件。

注意：UI Toolkit 事件调试器是一项实验性功能，因此它仍在变得足够稳定以发布的过程中。

事件调试器提供事件发生时的实时视图，允许您分析事件传播和已注册的回调。这对于调试复杂的事件处理方案特别有用，例如，当有多个元素具有重叠的事件处理程序时，或者当你尝试了解事件如何在 UI 层次结构中传播时。

启用事件调试器

在使用调试器之前，必须在项目设置广泛的设置集合，允许您配置物理、音频、网络、图形、输入和项目的许多其他区域的行为方式。更多信息
请参阅术语表.

1. 从菜单中，选择 编辑（Edit） > 项目设置（Project Settings） 。
2. 在“UI 工具包”部分中，启用“UI 工具包”>“高级”>“启用事件调试器”。

打开并设置事件调试器

启用事件调试器后，请按照以下步骤打开调试器并定位特定面板：

1. 从菜单中，选择 窗口（Window > UI Toolkit） > 事件调试器（Event Debugger） 以打开 UI 工具包事件调试器（UI Toolkit Event Debugger） 窗口。

2. 选择要调试的面板。

   

   提示：若要查找面板的名称，请打开 UI 工具包调试器，将焦点放在目标编辑器窗口上，然后按 Ctrl+F5（macOS：Cmd+F5）或使用该窗口的“更多”（⫶） 菜单。面板名称显示在调试器的下拉列表中，类似于事件调试器中的 选择面板（Select a panel） 下拉菜单。

   

   注意：要在播放模式下调试运行时面板，请先进入播放模式并选择目标面板。

3. 打开 UI 工具包事件调试器窗口后，与面板交互，例如单击或移动鼠标。事件实时显示在事件日志中。

4. （可选）若要清除事件日志，请选择 UI 工具包事件调试器窗口一角的 清除日志。

按类型筛选事件

若要减少监视的事件数，请按类型筛选它们。

选择面板选择控件旁边的下拉图标，以选择要调试的事件类型。事件按类别分组，并计数每种类型发生的频率。

默认情况下，指针事件处于选中状态。您可以切换整个类别或特定事件类型。

分析事件详细信息

在事件日志中选择事件时，事件调试器的底部部分会提供有关该事件的详细信息。

事件调试器的底部部分分为三个主要区域：

• 事件回调：列出在事件生命周期内调用的 C# 方法。
• 事件传播路径：显示事件传播中涉及的元素层次结构。这包括任何具有已注册回调或覆盖的元素，例如HandleEventBubbleUp或HandleEventTrickleDown.
• 事件信息：显示特定于上下文的属性，例如：
  • 指针事件的鼠标位置。
  • 键盘事件的关键代码。
  • 上下文相关信息，例如事件发生时焦点的元素。

检查已注册的回传

若要将事件行为追溯到代码，请使用回调查看器检查注册了哪些方法以及在何处注册。

右侧面板列出了所选事件类型和面板的所有已注册回传。每个回调条目都包含一个对角箭头图标，用于在注册点打开 C# 代码编辑器。

注意：回调被分类为 TrickleDown 或 NoTrickleDown，具体取决于其传播阶段。有关详细信息，请参阅 Dispatch 事件。

其他资源

• UI 工具包调试器