AIGame
API英文文档
API中文文档
UI英文文档
UI中文文档
API英文文档
API中文文档
UI英文文档
UI中文文档

输入框

  • 更新时间:2026-01-30 19:33:13

输入框-input

组件原生类型:{com.google.android.material.textfield.TextInputEditText}

布局原生类型:{com.google.android.material.textfield.TextInputLayout}

输入框：一个可以输入文字的地方。

一、基础用法

二、常用属性

三、常用函数

设置提示(提示)

设置预提示

  • 参数 : 提示 {string} 提示文本

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 输入框 = 界面.找控件("我的输入框");
//设置预提示
输入框.设置提示("请输入名字");

设置背景颜色(颜色)

设置背景颜色

  • 参数 : 颜色 {string} 颜色值

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 输入框 = 界面.找控件("我的输入框");
//设置背景颜色
输入框.设置背景颜色("#ff0000");//也可以是M3主题动态色，例如:主题主颜色

设置边框颜色(颜色)

设置边框颜色

  • 参数 : 颜色 {string} 颜色值

  • 版本 : 1.5.3

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 输入框 = 界面.找控件("我的输入框");
//设置边框颜色
输入框.设置边框颜色("#ff0000");//也可以是M3主题动态色，例如:主题主颜色

设置边框宽度(宽度)

设置边框宽度

  • 参数 : 宽度 {int} 边框宽度

  • 版本 : 1.5.3

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 输入框 = 界面.找控件("我的输入框");
//设置边框宽度
输入框.设置边框宽度(5);//单位:dp

设置弧度(左上, 上右, 左下, 右下)

设置弧度

  • 参数 : 左上 {float} 左上角弧度

  • 参数 : 上右 {float} 右上角弧度

  • 参数 : 左下 {float} 左下角弧度

  • 参数 : 右下 {float} 右下角弧度

  • 版本 : 1.5.3

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 输入框 = 界面.找控件("我的输入框");
//设置边框弧度
输入框.设置弧度(20,20,5,5);//单位:dp

设置文字(文本)

设置文字

  • 参数 : 文本 {string} 文字内容

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 输入框 = 界面.找控件("我的输入框");
//设置文本
输入框.设置文字("我是文字");

获取文字()

获取输入框内容

  • 返回 : {string} 内容

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 输入框 = 界面.找控件("我的输入框");
//获得文本
定义 文本 = 输入框.获取文字();

设置错误(提示)

设置异常信息提示

  • 参数 : 提示 {string} 错误提示信息

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 输入框 = 界面.找控件("我的输入框");
//设置异常提示
输入框.设置错误("输入内容有误");

获取编辑框()

获取文本输入编辑框对象

  • 返回 : {TextInputEditText} 编辑框对象

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 输入框 = 界面.找控件("我的输入框");
//获得文本输入编辑框对象
定义 编辑框 = 输入框.获取编辑框();

监听文本改变(回调)

监听文本改变

  • 参数 : 回调 {(文本,开始,之前,数量)=>{}} 监听回调

  • 版本 : 1.8.0

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 输入框 = 界面.找控件("我的输入框");
//监听文本改变
输入框.监听文本改变((文本,开始,之前,数量)=>{
    日志("文本改变了:"+文本);
});

监听文本改变后(回调)

监听文本改变后

  • 参数 : 回调 {(文本,开始,之前,数量)=>{}} 监听回调

  • 版本 : 1.8.0

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 输入框 = 界面.找控件("我的输入框");
//监听文本改变后
输入框.监听文本改变后((文本)=>{
    日志("文本改变了:"+文本);
});

监听文本改变前(回调)

监听文本改变前

  • 参数 : 回调 {(文本,开始,数量,之前)=>{}} 监听回调

  • 版本 : 1.8.0

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 输入框 = 界面.找控件("我的输入框");
//监听文本改变前
输入框.监听文本改变前((文本,开始,数量,之前)=>{
    日志("文本改变了:"+文本);
});

监听焦点改变(回调)

监听焦点改变

  • 参数 : 回调 {(有焦点)=>{}} 监听回调

  • 版本 : 1.8.2

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 输入框 = 界面.找控件("我的输入框");
//监听焦点改变
输入框.监听焦点改变((有焦点)=>{
    日志("焦点改变了:"+文本);
});
ON THIS PAGE