输入文本

输入文本元件用于接收用户输入文字。

实例属性

点击主工具栏中的按钮,生成一个输入文本文本元件。

GTextInput

Unity引擎可以通过UIConfig.inputHighlightColorUIConfig.inputCaretSize修改光标的颜色和大小。注意,输入光标的大小会自动根据屏幕缩放选择最合适的宽度,一般情况下你不需要修改。

输入文本在文本改变时有通知事件:

//Unity/Cry
aTextInput.onChanged.Add(onChanged);

//AS3
aTextInput.addEventListener(Event.CHANGE, onChanged);

//Egret
aTextInput.addEventListener(Event.CHANGE, this.onChanged, this);

//Laya
aTextInput.on(laya.events.Event.INPUT, this, this.onChanged);

在获得焦点和失去焦点时有通知事件:

//Unity
aTextInput.onFocusIn.Add(onFocusIn);
aTextInput.onFocusOut.Add(onFocusOut);

//AS3
aTextInput.addEventListener(FocusEvent.FOCUS_IN, onFocusIn);
aTextInput.addEventListener(FocusEvent.FOCUS_OUT, onFocusOut);

//Egret
aTextInput.addEventListener(FocusEvent.FOCUS_IN, this.onFocusIn, this);
aTextInput.addEventListener(FocusEvent.FOCUS_OUT, this.onFocusOut, this);

//Laya
aTextInput.on(laya.events.Event.FOCUS, this, this.onFocusIn);
aTextInput.on(laya.events.Event.BLUR, this, this.onFocusOut);

如果要主动设置焦点,可以用

aTextInput.RequestFocus();

如果输入文本设置了单行,则当用户按回车键时会派发一个事件(注意,仅在PC上有效。在手机上的键盘按Done不属于支持范围内,引擎一般没有提供和手机键盘交互的接口):

//Unity
aTextInput.onSubmit.Add(onSubmit);