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

MenuBody - 按钮容器

  • 更新时间:2025-12-13 11:58:44

按钮容器

用于装载多个悬浮按钮的容器，并控制显示与关闭。

add(menu)

添加悬浮按钮

可以向按钮容器中添加多个悬浮小按钮

  • 参数 : menu {MenuItem} 悬浮按钮

  • 返回 : {MenuBody} 自己

  • 版本 : 1.0.0

//创建按钮容器(用来装小按钮(MenuItem))
let menuBody = $arc.body("我的悬浮球1号"); //指定容器名称
//添加按钮
menuBody.add($arc.item("logo_ag"));
//之后就可以显示出来了
menuBody.show();

show()

显示悬浮按钮

会优先判断是否存在悬浮球名称了，如果存在则不显示，如果不存在则记录悬浮球名称并且显示。

  • 版本 : 1.0.0

//创建按钮容器(用来装小按钮(MenuItem))
let menuBody = $arc.body("我的悬浮球1号");
//创建小按钮(自定义按钮的各种样式)
let menu1 = $arc.item("logo_ag").bg("#55FFFFFF"); //指定按钮图标
let menu2 = $arc.item("ic_close").style("outline").iconTint("#FF0000"); //可以这样指定样式[方法1]
let menu3 = $arc.item("ic_code_run");
let menu4 = $arc.item("ic_cloud");
let menu5 = $arc.item("ic_color");
//连续添加小按钮并且显示
menuBody.add(menu1) //添加小按钮1
        .add(menu2) //添加小按钮2
        .add(menu3) //添加小按钮3
        .add(menu4) //添加小按钮4
        .add(menu5) //添加小按钮5
        .show(); //这里直接调用显示

name(name)

设置悬浮球名称

每个悬浮球被显示之前都会判断当前悬浮球的名称是否已经存在了，如果存在了，就不显示。

  • 参数 : name {string} 悬浮窗名称

  • 返回 : {MenuBody} 自己

  • 版本 : 1.0.0

//创建按钮容器(用来装小按钮(MenuItem))
let menuBody = $arc.body("我的悬浮球1号") //创建悬浮球按钮容器
.name("悬浮球1号"); //为容器设置一个名称

margin(left, right)

设置贴边边距

  • 参数 : left {int} 左边距，默认为 0

  • 参数 : right {int} 右边距，默认为 0

  • 返回 : {MenuBody} 自己

  • 版本 : 1.0.0

//创建按钮容器(用来装小按钮(MenuItem))
let menuBody = $arc.body("我的悬浮球1号") //创建悬浮球按钮容器
.margin(50,50); //设置左右两边的贴边边距

radius(radius)

设置圆弧半径

圆弧半径决定了容器中每个小按钮展开时的距离

  • 参数 : radius {int} 半径

  • 返回 : {MenuBody} 自己

  • 版本 : 1.0.0

//创建按钮容器(用来装小按钮(MenuItem))
let menuBody = $arc.body("我的悬浮球1号") //创建悬浮球按钮容器
.radius(25); //设置圆弧半径

global(isGlobalShow)

设置是否全局显示

默认就是全局显示的（需要悬浮窗权限），任何应用都能够看到这个悬浮球，如果不是全局显示的，那么就只能在当前应用中显示。

  • 参数 : isGlobalShow {boolean} 是否全局显示(默认:true)

  • 返回 : {MenuBody} 自己

  • 版本 : 1.0.0

//创建按钮容器(用来装小按钮(MenuItem))
let menuBody = $arc.body("我的悬浮球1号") //创建悬浮球按钮容器
.global(true); //设置为全局显示(需要悬浮窗权限)

dur(expandAnimDur)

设置展开动画时间

默认是 250 毫秒

  • 参数 : expandAnimDur {int} 展开动画时长

  • 返回 : {MenuBody} 自己

  • 版本 : 1.0.0

//创建按钮容器(用来装小按钮(MenuItem))
let menuBody = $arc.body("我的悬浮球1号") //创建悬浮球按钮容器
.dur(500); //设置展开动画时间

x(x)

设置初始位置

初始位置决定了悬浮球最开始显示时的位置

  • 参数 : x {int} x坐标

  • 返回 : {MenuBody} 自己

  • 版本 : 1.0.0

//创建按钮容器(用来装小按钮(MenuItem))
let menuBody = $arc.body("我的悬浮球1号") //创建悬浮球按钮容器
.x(300); //设置初始位置

y(y)

设置初始位置

初始位置决定了悬浮球最开始显示时的位置

  • 参数 : y {int} y坐标

  • 返回 : {MenuBody} 自己

  • 版本 : 1.0.0

//创建按钮容器(用来装小按钮(MenuItem))
let menuBody = $arc.body("我的悬浮球1号") //创建悬浮球按钮容器
.y(500); //设置初始位置
ON THIS PAGE