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

UI - 界面对象

  • 更新时间:2025-12-02 10:12:49

界面对象

获得视图()

获取解析后的最大布局

  • 返回 : {View} 返回最大布局

  • 版本 : 1.5.8

//解析布局
定义 界面 = $界面.解析布局("主界面.xml");
//获取最大视图
定义 最大视图 = 界面.获得视图();

找控件(标识)

通过标识找到组件

  • 参数 : 标识 {字符串} 组件标识

  • 返回 : {XView} 控件

定义 界面 = $界面.解析布局("主界面.xml");
//获取组件
定义 按钮 = 界面.找控件("按钮");

界面线程(回调函数)

在ui线程中执行

  • 参数 : 回调函数 {()=>{}} ui线程回调函数

定义 界面 = $界面.解析布局("主界面.xml");
//在ui线程中执行
界面.界面线程(()=>{
    //在ui线程中执行的代码
});

土司(文本)

悬浮土司

悬浮土司是基于悬浮窗来实现的，因此在显示的时候会处于界面顶层。

  • 参数 : 文本 {字符串} 文本

  • 版本 : 1.1.2

定义 界面 = $界面.解析布局("主界面.xml");
//悬浮土司
界面.土司("文本");

土司(文本, 重力)

悬浮土司

悬浮土司是基于悬浮窗来实现的，因此在显示的时候会处于界面顶层。

  • 参数 : 文本 {字符串} 文本

  • 参数 : 重力 {字符串} 重力

  • 版本 : 1.1.2

定义 界面 = $界面.解析布局("主界面.xml");
//悬浮土司
界面.土司("文本","中间");

显示()

显示界面

  • 返回 : {UI} 界面

  • 版本 : 1.12

定义 界面 = $界面.解析布局("主界面.xml");
//显示界面
界面.显示();

结束()

结束界面

定义 界面 = $界面.解析布局("主界面.xml");
//显示界面
界面.显示();
//找一个按钮控件来关闭界面
界面.找控件("关闭按钮").点击事件(函数(){
    //关闭界面
    界面.结束();
});

获得活动对象()

等待获得activity对象

注意:如果没有解析界面,那么就直接返回null 如果没有显示界面,也会直接返回null 如果解析成功并且成功显示,那么就会进入循环中,不断的等待判断activity是否获取成功,如果获取成功,则直接返回activity

  • 返回 : {AppCompatActivity} activity

  • 版本 : 1.1.2

//解析界面
定义 界面 = $界面.解析布局("主界面.xml");
//显示界面
界面.显示();
//显示完界面之后即可等待获取到activity对象
定义 活动对象 = 界面.获得活动对象();

当活动开始(回调)

界面初始时执行

  • 参数 : 回调 {(activity)=>{}} 生命周期回调

  • 版本 : 1.1.2

定义 界面 = $界面.解析布局("主界面.xml");
界面.显示();
//周期函数
界面.当活动开始((activity)=>{
    //界面初始时执行
});

当活动恢复(回调)

重返界面时执行

  • 参数 : 回调 {(activity)=>{}} 生命周期回调

  • 版本 : 1.1.2

定义 界面 = $界面.解析布局("主界面.xml");
界面.显示();
//周期函数
界面.当活动恢复((activity)=>{
    //重返界面时执行
});

当活动暂停(回调)

界面暂停时执行

  • 参数 : 回调 {(activity)=>{}} 生命周期回调

  • 版本 : 1.1.2

定义 界面 = $界面.解析布局("主界面.xml");
界面.显示();
//周期函数
界面.当活动暂停((activity)=>{
    //界面暂停时执行
});

当活动停止(回调)

界面停止时执行

  • 参数 : 回调 {(activity)=>{}} 生命周期回调

  • 版本 : 1.1.2

定义 界面 = $界面.解析布局("主界面.xml");
界面.显示();
//周期函数
界面.当活动停止((activity)=>{
    //界面停止时执行
});

当活动销毁(回调)

界面销毁时执行

  • 参数 : 回调 {(activity)=>{}} 生命周期回调

  • 版本 : 1.1.2

定义 界面 = $界面.解析布局("主界面.xml");
界面.显示();
//周期函数
界面.当活动销毁((activity)=>{
    //界面销毁时执行(一般用来释放资源)
});

当活动重启(回调)

重新刷新界面时执行

  • 参数 : 回调 {(activity)=>{}} 生命周期回调

  • 版本 : 1.1.2

定义 界面 = $界面.解析布局("主界面.xml");
界面.显示();
//周期函数
界面.当活动重启((activity)=>{
    //重新刷新界面时执行
});

当活动结果(回调)

活动结果事件

  • 参数 : 回调 {(requestCode,resultCode,intent,activity)=>{}} 活动结果事件

  • 版本 : 1.4.9

定义 界面 = $界面.解析布局("主界面.xml");
界面.显示();
//周期函数
界面.当活动结果((requestCode,resultCode,intent,activity)=>{
    //活动结果事件(一般用来申请权限时作为结果回调)
    //回调参数类型:
    //int requestCode
    //int resultCode
    //Intent intent
    //AppCompatActivity activity
});

当上下文菜单创建(回调)

上下文菜单创建事件

  • 参数 : 回调 {(menu,view,menuInfo,activity)=>{}} 上下文菜单创建事件

  • 版本 : 1.4.9

定义 界面 = $界面.解析布局("主界面.xml");
界面.显示();
//周期函数
界面.当上下文菜单创建((menu,view,menuInfo,activity)=>{
    //上下文菜单创建事件
    //回调函数参数类：
    //ContextMenu menu (其API涉及安卓API，请自行参考安卓文档)
    //View view
    //ContextMenu.ContextMenuInfo menuInfo (其API涉及安卓API，请自行参考安卓文档)
    //AppCompatActivity activity
});

当选项菜单创建(回调)

选项菜单创建事件

  • 参数 : 回调 {(menu,activity)=>{}} 选项菜单创建事件

  • 版本 : 1.4.9

定义 界面 = $界面.解析布局("主界面.xml");
界面.显示();
//周期函数
界面.当选项菜单创建((menu,activity)=>{
    //选项菜单创建事件
    //回调函数参数类：
    //Menu menu (其API涉及安卓API，请自行参考安卓文档)
    //AppCompatActivity activity
});

当选项菜单面板创建(回调)

选项菜单面板创建事件

  • 参数 : 回调 {(featureId,menu,activity)=>{}} 选项菜单面板创建事件

  • 版本 : 1.4.9

定义 界面 = $界面.解析布局("主界面.xml");
界面.显示();
//周期函数
界面.当选项菜单面板创建((featureId,menu,activity)=>{
    //选项菜单创建事件
    //回调函数参数类：
    //int featureId
    //Menu menu (其API涉及安卓API，请自行参考安卓文档)
    //AppCompatActivity activity
});

当选项菜单选中(回调)

选项菜单点击事件

  • 参数 : 回调 {(item,activity)=>{}} 选项菜单点击事件

  • 版本 : 1.4.9

定义 界面 = $界面.解析布局("主界面.xml");
界面.显示();
//周期函数
界面.当选项菜单选中((item,activity)=>{
    //选项菜单创建事件
    //回调函数参数类：
    //MenuItem item (其API涉及安卓API，请自行参考安卓文档)
    //AppCompatActivity activity
});

当按键按下(回调)

按键按下事件

  • 参数 : 回调 {(keyCode,event,activity)=>{return false;}} 按键抬起事件

  • 版本 : 1.1.2

定义 界面 = $界面.解析布局("主界面.xml");
界面.显示();
//周期函数
界面.当按键按下((keyCode,event,activity)=>{
    //当按键按下回调
    //回调参数类型:
    //int keyCode
    //KeyEvent event (其API涉及安卓API，请自行参考安卓文档)
});

当按键抬起(回调)

按键抬起事件

  • 参数 : 回调 {(keyCode,event,activity)=>{return false;}} 按键抬起事件

  • 版本 : 1.1.2

定义 界面 = $界面.解析布局("主界面.xml");
界面.显示();
//周期函数
界面.当按键抬起((keyCode,event,activity)=>{
    //按键抬起回调
    //回调参数类型:
    //int keyCode
    //KeyEvent event (其API涉及安卓API，请自行参考安卓文档)
});

当按键长按(回调)

长按事件

  • 参数 : 回调 {(keyCode,event,activity)=>{return false;}} 长按事件

  • 版本 : 1.1.2

定义 界面 = $界面.解析布局("主界面.xml");
界面.显示();
//周期函数
界面.当按键长按((keyCode,event,activity)=>{
    //按键长按回调
    //回调参数类型:
    //int keyCode
    //KeyEvent event (其API涉及安卓API，请自行参考安卓文档)
});
ON THIS PAGE