PointerDownEvent

描述

当指针在视觉元素内部按下时发送。

在运行时 UI 中，每次用户触摸屏幕或按下鼠标按钮时，都会发送 PointerDownEvent。

在编辑器 UI 中，当用户最初触摸屏幕或按下鼠标按钮时，会发送 PointerDownEvent。但是，如果用户在不释放初始鼠标按钮的情况下按下其他鼠标按钮（右键或中键），则会发送 PointerMoveEvents 而不是 PointerDownEvent。释放所有鼠标按钮并再次按下鼠标按钮会发送新的 PointerDownEvent。

PointerDownEvent 遵循默认指针 事件传播路径。它向下传递，向上冒泡，并且可以取消。

禁用的元素不会接收此事件。

有关 PointerDownEvent 与其他指针事件的关系信息，请参阅 PointerEventBase<T0> 和 指针事件。

其他资源：PointerMoveEvent、PointerUpEvent、PointerCancelEvent

 // This example creates a ClickDetector class to detect a click sequence.
 
 namespace UnityEngine.UIElements
 {
     public class ClickDetector : VisualElement
     {
         public ClickDetector()
         {
             RegisterCallback<PointerDownEvent>(ProcessEvent);
             RegisterCallback<PointerMoveEvent>(ProcessEvent);
             RegisterCallback<PointerUpEvent>(ProcessEvent);
         }
         private void ProcessEvent<TEvent>(PointerEventBase<TEvent> evt)
             where TEvent : PointerEventBase<TEvent>, new()
         {
             if (evt.eventTypeId == PointerDownEvent.TypeId() && evt.button == 0)
             {
                 StartClickTracking(evt);
             }
             else if (evt.eventTypeId == PointerMoveEvent.TypeId())
             {
                 // Button 1 was pressed while another button was already pressed.
                 if (evt.button == 0 && (evt.pressedButtons & 1) == 1)
                 {
                     StartClickTracking(evt);
                 }
                 // Button 1 is released while another button is still pressed.
                 else if (evt.button == 0 && (evt.pressedButtons & 1) == 0)
                 {
                     SendClickEvent(evt);
                 }
                 // Pointer movement detected or button state changed.
                 else
                 {
                     UpdateClickStatus(evt);
                 }
             }
             else if (evt.eventTypeId == PointerUpEvent.TypeId() && evt.button == 0)
             {
                 SendClickEvent(evt);
             }
         }

         private void StartClickTracking(IPointerEvent evt) { Debug.Log("Starting click sequence"); }
         private void UpdateClickStatus(IPointerEvent evt) { Debug.Log("Tracking"); }
         private void SendClickEvent(IPointerEvent evt) { Debug.Log("Completed click"); }
     }
 }

构造函数

受保护的方法

继承的成员