Unity UGUI的PointerEventData的介绍及使用

Unity UGUI的PointerEventData的介绍及使用

1. 什么是PointerEventData？

PointerEventData是Unity中UGUI系统中的一个重要组件，用于处理用户输入的指针事件。它可以获取用户的点击、拖拽、滚动等操作，并提供了一系列的属性和函数来处理这些事件。

2. PointerEventData的工作原理

PointerEventData通过封装底层的输入系统，将用户的输入事件转化为Unity中的事件。它可以获取用户的点击位置、点击类型、点击对象等信息，并将这些信息传递给相应的事件处理函数。

3. PointerEventData的常用属性

• position：获取用户点击的屏幕坐标。
• delta：获取用户拖拽的位移量。
• button：获取用户点击的鼠标按钮。
• clickCount：获取用户点击的次数。
• pointerEnter：获取鼠标指针所在的UI对象。

4. PointerEventData的常用函数

• GetPress()：判断鼠标按钮是否按下。
• GetPressDown()：判断鼠标按钮是否刚刚按下。
• GetPressUp()：判断鼠标按钮是否刚刚抬起。
• IsPointerMoving()：判断鼠标指针是否在移动。
• IsPointerOverGameObject()：判断鼠标指针是否在UI对象上。

5. 完整例子代码

例子1：获取鼠标点击位置

using UnityEngine;
using UnityEngine.EventSystems;

public class ClickPosition : MonoBehaviour, IPointerClickHandler
{
    public void OnPointerClick(PointerEventData eventData)
    {
        Debug.Log("点击位置：" + eventData.position);
    }
}

操作步骤：

1. 创建一个空物体，并将脚本挂载到该物体上。
2. 在场景中点击鼠标，查看控制台输出的点击位置。

注意事项：

• 需要将脚本挂载到有Collider组件的物体上，以便接收鼠标点击事件。

例子2：判断鼠标按钮是否按下

using UnityEngine;
using UnityEngine.EventSystems;

public class ButtonPress : MonoBehaviour, IPointerDownHandler, IPointerUpHandler
{
    public void OnPointerDown(PointerEventData eventData)
    {
        Debug.Log("鼠标按钮按下");
    }

    public void OnPointerUp(PointerEventData eventData)
    {
        Debug.Log("鼠标按钮抬起");
    }
}

操作步骤：

1. 创建一个按钮，并将脚本挂载到该按钮上。
2. 按下和抬起鼠标按钮，查看控制台输出。

注意事项：

• 需要将脚本挂载到Button组件上，以便接收鼠标按钮事件。

例子3：获取鼠标拖拽位移

using UnityEngine;
using UnityEngine.EventSystems;

public class DragPosition : MonoBehaviour, IDragHandler
{
    public void OnDrag(PointerEventData eventData)
    {
        Debug.Log("拖拽位移：" + eventData.delta);
    }
}

操作步骤：

1. 创建一个物体，并将脚本挂载到该物体上。
2. 按住鼠标左键拖拽物体，查看控制台输出的拖拽位移。

注意事项：

• 需要将脚本挂载到有Collider组件的物体上，以便接收鼠标拖拽事件。

例子4：判断鼠标指针是否在UI对象上

using UnityEngine;
using UnityEngine.EventSystems;

public class PointerOverUI : MonoBehaviour
{
    public void Update()
    {
        if (EventSystem.current.IsPointerOverGameObject())
        {
            Debug.Log("鼠标指针在UI对象上");
        }
    }
}

操作步骤：

1. 创建一个UI对象，并将脚本挂载到一个空物体上。
2. 将鼠标指针移动到UI对象上，查看控制台输出。

注意事项：

• 需要将脚本挂载到一个空物体上，并在Update函数中判断鼠标指针是否在UI对象上。

例子5：获取鼠标点击次数

using UnityEngine;
using UnityEngine.EventSystems;

public class ClickCount : MonoBehaviour, IPointerClickHandler
{
    public void OnPointerClick(PointerEventData eventData)
    {
        Debug.Log("点击次数：" + eventData.clickCount);
    }
}

操作步骤：

1. 创建一个按钮，并将脚本挂载到该按钮上。
2. 连续点击按钮，查看控制台输出的点击次数。

注意事项：

• 需要将脚本挂载到Button组件上，以便接收鼠标点击事件。

参考资料

• Unity官方文档：https://docs.unity3d.com/ScriptReference/EventSystems.PointerEventData.html
• Unity官方教程：https://learn.unity.com/tutorial/unity-ui