UGUI源码-事件系统-3

小白要加油哈

已于 2024-05-03 22:41:31 修改

阅读量392

点赞数 5

分类专栏： UGUI源码文章标签： unity 游戏引擎 c#

于 2024-05-03 22:41:08 首次发布

本文链接：https://blog.csdn.net/2301_76618920/article/details/138417770

版权

UGUI源码专栏收录该内容

5 篇文章 0 订阅

订阅专栏

文章详细解析了UnityUGUI中的事件系统，特别是如何处理鼠标交互，包括鼠标点击、移动和拖拽等操作，以及ButtonClick事件从触发到执行的详细流程。

摘要由CSDN通过智能技术生成

事件系统-输入模块

问题：为什么UI中的元素可以交互？

在这里插入图片描述

Button Click触发过程

在这里插入图片描述

调试
点击按钮
调用堆栈
Update方法
ProcessMouseEvent()函数来处理鼠标事件

 protected void ProcessMouseEvent()
 {
     ProcessMouseEvent(0);
 }

ProcessMouseEvent(0)方法

protected void ProcessMouseEvent(int id)
{
	//通过 mouseData 获取鼠标左键的按钮状态数据
    var mouseData = GetMousePointerEventData(id);
    var leftButtonData = mouseData.GetButtonState(PointerEventData.InputButton.Left).eventData;
	//设置当前焦点游戏对象为鼠标指针当前射线检测到的游戏对象
    m_CurrentFocusedGameObject = leftButtonData.buttonData.pointerCurrentRaycast.gameObject;

    //处理鼠标左键的按下事件
    ProcessMousePress(leftButtonData);
    //处理鼠标移动事件
    ProcessMove(leftButtonData.buttonData);
    //处理鼠标拖拽事件
    ProcessDrag(leftButtonData.buttonData);

    // 处理右键和中键点击事件，分别调用 ProcessMousePress 和 ProcessDrag
    ProcessMousePress(mouseData.GetButtonState(PointerEventData.InputButton.Right).eventData);
    ProcessDrag(mouseData.GetButtonState(PointerEventData.InputButton.Right).eventData.buttonData);
    ProcessMousePress(mouseData.GetButtonState(PointerEventData.InputButton.Middle).eventData);
    ProcessDrag(mouseData.GetButtonState(PointerEventData.InputButton.Middle).eventData.buttonData);

    if (!Mathf.Approximately(leftButtonData.buttonData.scrollDelta.sqrMagnitude, 0.0f))
    {
        var scrollHandler = ExecuteEvents.GetEventHandler<IScrollHandler>(leftButtonData.buttonData.pointerCurrentRaycast.gameObject);
        ExecuteEvents.ExecuteHierarchy(scrollHandler, leftButtonData.buttonData, ExecuteEvents.scrollHandler);
    }
}

进入到鼠标左键点击的按下事件ProcessMousePress(leftButtonData)方法里，通过调用 ReleaseMouse 方法，可以在释放鼠标时执行一些操作

protected void ProcessMousePress(MouseButtonEventData data)
{
    var pointerEvent = data.buttonData;
    var currentOverGo = pointerEvent.pointerCurrentRaycast.gameObject;

    // PointerDown notification
    if (data.PressedThisFrame())
    {
        pointerEvent.eligibleForClick = true;
        pointerEvent.delta = Vector2.zero;
        pointerEvent.dragging = false;
        pointerEvent.useDragThreshold = true;
        pointerEvent.pressPosition = pointerEvent.position;
        pointerEvent.pointerPressRaycast = pointerEvent.pointerCurrentRaycast;

        DeselectIfSelectionChanged(currentOverGo, pointerEvent);

        var resetDiffTime = Time.unscaledTime - pointerEvent.clickTime;
        if (resetDiffTime >= doubleClickTime)
        {
            pointerEvent.clickCount = 0;
        }

        // search for the control that will receive the press
        // if we can't find a press handler set the press
        // handler to be what would receive a click.
        var newPressed = ExecuteEvents.ExecuteHierarchy(currentOverGo, pointerEvent, ExecuteEvents.pointerDownHandler);
        var newClick = ExecuteEvents.GetEventHandler<IPointerClickHandler>(currentOverGo);

        // didnt find a press handler... search for a click handler
        if (newPressed == null)
            newPressed = newClick;

        // Debug.Log("Pressed: " + newPressed);

        float time = Time.unscaledTime;

        if (newPressed == pointerEvent.lastPress)
        {
            var diffTime = time - pointerEvent.clickTime;
            if (diffTime < doubleClickTime)
                ++pointerEvent.clickCount;
            else
                pointerEvent.clickCount = 1;

            pointerEvent.clickTime = time;
        }
        else
        {
            pointerEvent.clickCount = 1;
        }

        pointerEvent.pointerPress = newPressed;
        pointerEvent.rawPointerPress = currentOverGo;
        pointerEvent.pointerClick = newClick;

        pointerEvent.clickTime = time;

        // Save the drag handler as well
        pointerEvent.pointerDrag = ExecuteEvents.GetEventHandler<IDragHandler>(currentOverGo);

        if (pointerEvent.pointerDrag != null)
            ExecuteEvents.Execute(pointerEvent.pointerDrag, pointerEvent, ExecuteEvents.initializePotentialDrag);

        m_InputPointerEvent = pointerEvent;
    }

    // PointerUp notification
    if (data.ReleasedThisFrame())
    {
        ReleaseMouse(pointerEvent, currentOverGo);
    }
}

ReleaseMouse方法

在这里插入图片描述

//pointerEvent是鼠标当前事件里面存储的一些数据
private void ReleaseMouse(PointerEventData pointerEvent, GameObject currentOverGo)
{
	//ExecuteEvents.Execute 方法执行指针按下处理器的指针抬起事件（pointerUpHandler）
    ExecuteEvents.Execute(pointerEvent.pointerPress, pointerEvent, ExecuteEvents.pointerUpHandler);
	// 获取当前射线检测到的游戏对象上的指针点击处理器
    var pointerClickHandler = ExecuteEvents.GetEventHandler<IPointerClickHandler>(currentOverGo);

	//如果指针点击处理器与指针事件中的 pointerClick 相同，并且事件符合点击条件（eligibleForClick 为 true），则执行指针点击处理器的指针点击事件（pointerClickHandler）
    // PointerClick and Drop events
    if (pointerEvent.pointerClick == pointerClickHandler && pointerEvent.eligibleForClick)
    {
        ExecuteEvents.Execute(pointerEvent.pointerClick, pointerEvent, ExecuteEvents.pointerClickHandler);
    }
    //如果存在指针拖拽目标并且正在拖拽中，则通过 ExecuteEvents.ExecuteHierarchy 方法执行指定对象上的拖拽处理器的放置事件（dropHandler）
    if (pointerEvent.pointerDrag != null && pointerEvent.dragging)
    {
        ExecuteEvents.ExecuteHierarchy(currentOverGo, pointerEvent, ExecuteEvents.dropHandler);
    }
	//重置指针事件的一些属性，包括取消点击条件、清除指针按下对象
    pointerEvent.eligibleForClick = false;
    pointerEvent.pointerPress = null;
    pointerEvent.rawPointerPress = null;
    pointerEvent.pointerClick = null;
	//如果存在指针拖拽目标并且正在拖拽中，则执行指针拖拽处理器的结束拖拽事件（endDragHandler）
    if (pointerEvent.pointerDrag != null && pointerEvent.dragging)
        ExecuteEvents.Execute(pointerEvent.pointerDrag, pointerEvent, ExecuteEvents.endDragHandler);
	//将指针事件的拖拽状态和拖拽对象重置为 false 和 null
    pointerEvent.dragging = false;
    pointerEvent.pointerDrag = null;

    // redo pointer enter / exit to refresh state
    // so that if we moused over something that ignored it before
    // due to having pressed on something else
    // it now gets it.
    //重新处理指针进入和离开事件，以刷新状态，确保当前射线检测到的游戏对象的状态正确更新
    if (currentOverGo != pointerEvent.pointerEnter)
    {
        HandlePointerExitAndEnter(pointerEvent, null);
        HandlePointerExitAndEnter(pointerEvent, currentOverGo);
    }
	//将更新后的指针事件赋值给 m_InputPointerEvent
    m_InputPointerEvent = pointerEvent;
}

ExecuteEvents.Execute方法

public static bool Execute<T>(GameObject target, BaseEventData eventData, EventFunction<T> functor) where T : IEventSystemHandler
{
   var internalHandlers = ListPool<IEventSystemHandler>.Get();
   GetEventList<T>(target, internalHandlers);
   //  if (s_InternalHandlers.Count > 0)
   //      Debug.Log("Executinng " + typeof (T) + " on " + target);

   var internalHandlersCount = internalHandlers.Count;
   for (var i = 0; i < internalHandlersCount; i++)
   {
       T arg;
       try
       {
           arg = (T)internalHandlers[i];
       }
       catch (Exception e)
       {
           var temp = internalHandlers[i];
           Debug.LogException(new Exception(string.Format("Type {0} expected {1} received.", typeof(T).Name, temp.GetType().Name), e));
           continue;
       }

       try
       {
           functor(arg, eventData);
       }
       catch (Exception e)
       {
           Debug.LogException(e);
       }
   }

   var handlerCount = internalHandlers.Count;
   ListPool<IEventSystemHandler>.Release(internalHandlers);
   return handlerCount > 0;
}

在这里插入图片描述

Excute方法，专门执行 IPointerClickHandler 接口的 OnPointerClick 方法，面向接口编程，谁实现接口，谁来做这件事情

//它接受两个参数：一个实现了 IPointerClickHandler 接口的对象 handler 和一个基本事件数据对象 eventData
private static void Execute(IPointerClickHandler handler, BaseEventData eventData)
{
    handler.OnPointerClick(ValidateEventData<PointerEventData>(eventData));
}

用于处理指针点击事件（例如鼠标点击、触摸点击）

 public virtual void OnPointerClick(PointerEventData eventData)
 {
     if (eventData.button != PointerEventData.InputButton.Left)
         return;

     Press();
 }

Press方法,调用了按钮的点击事件委托 m_OnClick 的 Invoke 方法，触发了按钮的点击事件。这意味着与该按钮相关联的所有点击事件监听器都会收到通知，并执行相应的操作

 private void Press()
 {
     Debug.Log("点击按钮");
     //检查按钮是否处于激活状态且可交互
     if (!IsActive() || !IsInteractable())
         return;
	//用于添加性能分析标记，以便在性能分析工具中跟踪按钮点击事件
     UISystemProfilerApi.AddMarker("Button.onClick", this);
     //调用了按钮的点击事件委托 m_OnClick 的 Invoke 方法，触发了按钮的点击事件。这意味着与该按钮相关联的所有点击事件监听器都会收到通知，并执行相应的操作
     m_OnClick.Invoke();
 }