点击事件

当用户在 VisualElement 上单击鼠标左键（或指向设备上的第一个按钮）时，将发生 ClickEvent。

单击由指向指向的指针向下事件组成，后跟同一 VisualElement 上的指向指向的指向的事件。允许指针在两个事件之间移动，只要向下和向上事件发生在同一 VisualElement 上即可。

此事件可用于检测视觉元素实例化或派生自 C# 的可视化树的节点VisualElement类。您可以设置外观样式、定义行为并将其作为 UI 的一部分显示在屏幕上。更多信息
请参阅术语表那不是按钮。例如，实现Toggle控件使用ClickEvent以显示或隐藏复选标记，以及更改控件的值。

的基类ClickEvent是 PointerEventBase。有关更多信息，另请参阅有关指针事件的文档。

独特的属性

这ClickEvent没有唯一属性，但从其基类继承所有属性。您可以在“指针事件”页面上找到属性列表。

活动列表

点击事件

当鼠标左键单击视觉元素时，Unity 会发送此事件。

target：单击发生时鼠标或指点设备下方的元素。

以下示例注册ClickEvent在视觉元素上：

btnClose.RegisterCallback<ClickEvent, VisualElement>(Clicked, asset); // asset is the root visual element that will be closed

private void Clicked(ClickEvent evt, VisualElement root)
{
  root.ShowVisualElement(false); 
}

例子

以下示例演示如何对彩色视觉元素上的 ClickEvent 做出反应。单击元素时，其颜色将更改为新的随机颜色。

要查看示例的实际效果，请执行以下作：

1. 创建一个名为 ClickEventExampleWindow 的新 C# 脚本。
2. 将示例代码复制到 C# 脚本中。
3. 在 窗口>UI 工具包（UI Toolkit） > 单击 事件示例（Event Example） 下，打开新创建的 编辑器（Editor） 窗口。

using UnityEditor;
using UnityEngine;
using UnityEngine.UIElements;

public class ClickEventExampleWindow : EditorWindow
{
  [MenuItem("Window/UI Toolkit/ClickEventExample")]
  public static void ShowExample()
  {
    var wnd = GetWindow<ClickEventExampleWindow>();
    wnd.titleContent = new GUIContent("Click Event Example");
  }

  public void CreateGUI()
  {
    // Create a few different colored boxes
    for (int i = 0; i < 4; i++)
    {
      // Create VisualElement with random background color
      var newBox = new VisualElement() { style = { flexGrow = 1, backgroundColor = GetRandomColor() } };
      rootVisualElement.Add(newBox);

      // Register a click event to the visual element to change the background color to a new color
      newBox.RegisterCallback<ClickEvent>(OnBoxClicked);
    }
  }

  private void OnBoxClicked(ClickEvent evt)
  {
    // Only perform this action at the target, not in a parent
    if (evt.propagationPhase != PropagationPhase.AtTarget)
      return;

    // Assign a random new color
    var targetBox = evt.target as VisualElement;
    targetBox.style.backgroundColor = GetRandomColor();
  }

  private Color GetRandomColor()
  {
    return new Color(Random.Range(0, 1f), Random.Range(0, 1f), Random.Range(0, 1f));
  }
}