UG3L11——UI事件监听接口

UI事件监听接口

目前所有的控件都只提供了常用的事件监听列表
如果想做一些类似长按，双击，拖拽等功能是无法制作的
或者想让 Image​ 和 Text​，RawImage​三大基础控件能够响应玩家输入也是无法制作的

而事件接口就是用来处理类似问题
让所有控件都能够添加更多的事件监听来处理对应的逻辑

  • 好处：
    需要监听自定义事件的控件挂载继承实现了接口的脚本就可以监听到一些特殊事件
    可以通过它实现一些长按，双击拖拽等功能
  • 坏处：
    不方便管理，需要自己写脚本继承接口挂载到对应控件上，比较麻烦

事件接口种类

使用所有相关接口都需要引用命名空间 UnityEngine.EventSystems​

注意，以下的大部分事件接口需要打开 Raycast Target 才能使用，请注意是否打开！

  • 常用接口

    • 鼠标指针（或者触屏点击）和操作相关

      需要继承的接口 监听函数名 作用
      IPointerEnterHandler OnPointerEnter 当指针进入对象时调用 （鼠标进入）
      IPointerExitHandler OnPointerExit 当指针退出对象时调用 （鼠标离开）
      IPointerDownHandler OnPointerDown 在对象上按下指针时调用 （按下）
      IPointerUpHandler OnPointerUp 松开指针时调用（在指针正在点击的游戏对象上调用）（抬起）
      IPointerClickHandler OnPointerClick 在同一对象上按下再松开指针时调用 （点击）

    • 拖拽相关

      脚本需要继承的接口 监听函数名 作用
      IBeginDragHandler OnBeginDrag 即将开始拖动时在拖动对象上调用 （开始拖拽）
      IDragHandler OnDrag 发生拖动时在拖动对象上调用 （拖拽中）
      IEndDragHandler OnEndDrag 拖动完成时在拖动对象上调用 （结束拖拽）

  • 不常用接口

    以下接口了解即可

    脚本需要继承的接口 监听函数名 作用
    IInitializePotentialDragHandler OnInitializePotentialDrag 在找到拖动目标时调用，可用于初始化值
    IDropHandler OnDrop 在拖动目标对象上调用
    IScrollHandler OnScroll 当鼠标滚轮滚动时调用
    IUpdateSelectedHandler OnUpdateSelected 每次勾选时在选定对象上调用
    选定对象相关
    ISelectHandler OnSelect 当对象成为选定对象时调用
    IDeselectHandler OnDeselect 取消选择选定对象时调用
    导航相关
    IMoveHandler OnMove 发生移动事件（上、下、左、右等）时调用
    ISubmitHandler OnSubmit 按下 Submit 按钮时调用
    ICancelHandler OnCancel
    		 按下 Cancel 按钮时调用

使用事件接口

  1. 继承MonoBehaviour​的脚本继承对应的事件接口，引用命名空间
  2. 实现接口中的内容
  3. 将该脚本挂载到想要监听自定义事件的UI控件上
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
using UnityEngine;
using UnityEngine.EventSystems;

public class Lesson18 : MonoBehaviour, IPointerEnterHandler, IPointerExitHandler, IPointerDownHandler, IPointerUpHandler
{
    public void OnPointerDown(PointerEventData eventData)
    {
        print("鼠标（触碰）按下");
    }

    public void OnPointerEnter(PointerEventData eventData)
    {
        print("鼠标进入");
    }

    public void OnPointerExit(PointerEventData eventData)
    {
        print("鼠标离开");
    }

    public void OnPointerUp(PointerEventData eventData)
    {
        print("触碰抬起");
    }
}

PointerEventData参数的关键内容

当实现事件接口的函数时，可以看到这些函数都带有 类型为PointerEventData​或者其他类似的类型 的参数

其继承的父类：BaseEventData​

  • 主要属性

    • ​pointerId​： 鼠标左右中键点击鼠标的ID
      通过它可以判断右键点击
    • ​position​：当前指针位置 （屏幕坐标系）
    • ​pressPosition​：按下的时候指针的位置（只有按下的一瞬间的位置）
    • ​delta​：指针移动增量
    • ​clickCount​：连击次数
    • ​clickTime​：点击时间

  • 摄像机相关

    • ​pressEventCamera​：最后一个OnPointerPress​按下事件关联的摄像机
    • ​enterEventCamera​：最后一个OnPointerEnter​进入事件关联的摄像机

‍

‍