MenuItem - 悬浮按钮#

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

悬浮按钮

一个悬浮球中只能有一个容器，而一个容器可以添加多个悬浮小按钮，容器用来控制按钮的展开与关闭动画，而按钮主要是用于功能交互。

样式(样式)#

设置样式

注意：此方法必须要优先调用!因为会重置其他设置的所有属性

• 参数 : 样式 {字符串} 按钮样式可选值:默认,边框,色调

• 返回 : {MenuItem} 自己

• 版本 : 1.6.9

//先创建小按钮
定义 小按钮 = $悬浮球.按钮("logo_ag") //创建一个按钮
.样式("边框"); //(优先调用)设置样式

点击(点击事件)#

设置点击事件

当小按钮被点击的时候会执行其中的回调函数

• 参数 : 点击事件 {()=>{}} 回调函数

• 返回 : {MenuItem} 自己

• 版本 : 1.6.9

//先创建小按钮
定义 小按钮 = $悬浮球.按钮("logo_ag");//图标资源名称或者图标的相对路径
//设置点击事件
小按钮.点击(()=>{
    //点击事件
    信息("我被点击了");
});

涟漪(颜色字符串)#

设置涟漪颜色

小按钮被点击时背景阴影会有水波涟漪的效果

• 参数 : 颜色字符串 {字符串} 颜色

• 返回 : {MenuItem} 自己

• 版本 : 1.6.9

//先创建小按钮
定义 小按钮 = $悬浮球.按钮("logo_ag") //创建一个按钮(图标资源名称或者图标的相对路径)
.涟漪("#FF0000");//设置涟漪颜色

涟漪(颜色值)#

设置涟漪颜色

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

• 返回 : {MenuItem} 自己

• 版本 : 1.6.9

//先创建小按钮
定义 小按钮 = $悬浮球.按钮("logo_ag") //创建一个按钮
.涟漪($颜色.红色);//设置涟漪颜色

提示(提示)#

设置提示

按钮被长按的时候就会显示提示文字

• 参数 : 提示 {字符串} 提示文字

• 返回 : {MenuItem} 自己

• 版本 : 1.6.9

//先创建小按钮
定义 小按钮 = $悬浮球.按钮("logo_ag") //创建一个按钮
.提示("提示文字");//设置长按提示文字

背景(颜色字符串)#

设置背景颜色

• 参数 : 颜色字符串 {字符串} 背景颜色

• 返回 : {MenuItem} 自己

• 版本 : 1.6.9

//先创建小按钮
定义 小按钮 = $悬浮球.按钮("logo_ag") //创建一个按钮
.背景("#FF0000");//设置按钮背景颜色

背景(颜色值)#

设置背景颜色

• 参数 : 颜色值 {整数} 背景颜色值

• 返回 : {MenuItem} 自己

• 版本 : 1.6.9

//先创建小按钮
定义 小按钮 = $悬浮球.按钮("logo_ag") //创建一个按钮
.背景($颜色.红色); //设置背景颜色值

弧度(弧度)#

设置圆角大小

• 参数 : 弧度 {小数} 圆角大小

• 返回 : {MenuItem} 自己

• 版本 : 1.6.9

//先创建小按钮
定义 小按钮 = $悬浮球.按钮("logo_ag") //创建一个按钮
.弧度(15); //设置圆角弧度大小

图标(资源名称)#

设置图标

支持内置的图标设置

支持路径中的图片(最好是相对于项目路径的)

• 参数 : 资源名称 {字符串} 资源名称或者本地路径

• 返回 : {MenuItem} 自己

• 版本 : 1.6.9

//创建一个按钮
定义 小按钮 = $悬浮球.按钮("ic_code_run"); //创建一个按钮
//设置点击事件
小按钮.点击(()=>{
    //点击时我们切换图标(设置图标)
    小按钮.图标("ic_stop");//图标资源名称或者图标的相对路径
});

图标内边距(内边距)#

设置图标内边距

• 参数 : 内边距 {整数} 边距

• 返回 : {MenuItem} 自己

• 版本 : 1.6.9

//先创建小按钮
定义 小按钮 = $悬浮球.按钮("logo_ag") //创建一个按钮
.图标内边距(10); //设置图标内边距

图标大小(大小)#

设置图标尺寸

• 参数 : 大小 {整数} 尺寸

• 返回 : {MenuItem} 自己

• 版本 : 1.6.9

//先创建小按钮
定义 小按钮 = $悬浮球.按钮("logo_ag") //创建一个按钮
.图标大小(30); //设置按钮大小

取消图标颜色()#

取消填充颜色

此函数等价于：图标颜色(空);

• 返回 : {MenuItem} 自己

• 版本 : 1.6.9

//先创建小按钮
定义 小按钮 = $悬浮球.按钮("logo_ag") //创建一个按钮
.取消图标颜色(); //清空图标的颜色

图标颜色(颜色字符串)#

设置图标填充颜色

当颜色值为空时，会取消填充颜色

• 参数 : 颜色字符串 {字符串} 颜色

• 返回 : {MenuItem} 自己

• 版本 : 1.6.9

//先创建小按钮
定义 小按钮 = $悬浮球.按钮("logo_ag") //创建一个按钮
.图标颜色("#000000"); //设置图标颜色

图标颜色(颜色值)#

设置图标填充颜色

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

• 返回 : {MenuItem} 自己

• 版本 : 1.6.9

//先创建小按钮
定义 小按钮 = $悬浮球.按钮("logo_ag") //创建一个按钮
.图标颜色($颜色.红色); //设置图标颜色值

获取宽度()#

获取按钮宽度

• 返回 : {整数} 宽度

• 版本 : 1.6.9

//先创建小按钮
定义 小按钮 = $悬浮球.按钮("logo_ag");  //创建一个按钮
//获取宽度
小按钮.获取宽度();
//一般获取宽度可以用来设置弧度，例如：
小按钮.设置弧度(小按钮.获取宽度()/2);
//这样就能设置成圆形了

获取高度()#

获取按钮高度

• 返回 : {整数} 高度

• 版本 : 1.6.9

//先创建小按钮
定义 小按钮 = $悬浮球.按钮("logo_ag");  //创建一个按钮
//获取高度
小按钮.获取高度();