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

__EOF__