Unity InputFiled TMP属性和各种监听示例详解

Unity InputField TMP属性和各种监听示例详解

什么是InputField？

InputField是Unity中的一个UI控件，它可以让用户在UI界面中输入文本。InputField通常结合TextMeshPro（简称TMP）组件使用，用于控制文本的显示。InputField有丰富的属性和事件可以掌控，本文将详细解析。

InputField常用属性

text

InputField默认显示的文本。

selectionColor

设置用户选中文本时的高亮颜色。

characterLimit

输入的字符数量限制。

contentType

设置输入的内容类型，如普通文本、整数、浮点数、电子邮件等。

inputType

设置输入方式，如默认的标准字符输入、密码输入等。

placeholder

InputField中无文本时显示的占位符文本。

caretBlinkRate

光标闪烁的速率。

caretWidth

光标的宽度。

InputField常用事件

onValueChanged

当InputField中的文本发生改变时发生。

onEndEdit

当用户结束编辑InputField时发生，比如鼠标离开InputField或按下回车键。

onSelect

当用户选中InputField时发生。

onDeselect

当用户取消选中InputField时发生。

InputField常用方法

ActivateInputField()

激活InputField，让其获得焦点并在其内部等待用户输入。

DeactivateInputField()

使InputField失去焦点并停止输入状态。

示例1：显示InputField中的文本

我们通过下面这段代码来显示InputField中的文本：

using TMPro;
using UnityEngine;
using UnityEngine.UI;

public class ShowInput : MonoBehaviour
{
    public InputField inputField;
    public TextMeshProUGUI outputText;

    private void Start()
    {
        inputField.onEndEdit.AddListener(ShowText);
    }

    private void ShowText(string text)
    {
        outputText.text = "输入的文本为：" + text;
    }
}

这个示例中，我们在Start方法中为InputField的onEndEdit事件添加了一个回调。回调函数ShowText会在用户编辑完成InputField后被触发，将InputField中的文本传递给了一个TextMeshProUGUI组件，从而在UI界面上显示出来。

示例2：限制用户输入的字符数量

我们通过下面这段代码来限制用户在InputField中输入的字符数量：

using TMPro;
using UnityEngine;
using UnityEngine.UI;

public class LimitInput : MonoBehaviour
{
    public InputField inputField;
    public TextMeshProUGUI infoText;
    public int maxCharacters = 10;

    private void Start()
    {
        inputField.characterLimit = maxCharacters;
        inputField.onEndEdit.AddListener(LimitText);
    }

    private void LimitText(string text)
    {
        if (text.Length > maxCharacters)
        {
            infoText.text = "您输入的字符数超过了" + maxCharacters + "个，请重新输入。";
            inputField.text = "";
        }
        else
        {
            infoText.text = "您当前已输入" + text.Length + "个字符。";
        }
    }
}

这个示例中，我们设置了InputField的characterLimit属性来限制用户输入的字符数量，并在onEndEdit事件触发时，检查用户输入的字符数量是否超过了设定限制。如果超过了限制，就将InputField中的文本清空，并提示用户重新输入。如果没有超过限制，就在UI界面上显示已输入字符数量。