按钮

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

按钮-button

按钮控件{XButton}是属于{XView}的子控件,因此{XView}中的所有方法,按钮控件都可以调用。

按钮是界面的最简单的元素,一般用于点击操作。

示例:基础使用

其实按钮本身是没有点击事件的,由于它继承了父类{XView},因此可以调用其父类中的函数来实现点击操作。

事实上,所有的组件都是继承自{XView}的,因此都可以调用{XView}中的方法。

<界面>
    <状态栏 />
    <按钮 标识="我的按钮" 文本="点击我试试" />
</界面>
定义 界面 = $界面.解析布局("ui.xml");
界面.显示();//显示界面
//找到界面中的元素并且实现点击事件
界面.找控件("我的按钮").点击事件(() => {
    信息("我被点击了");
});

二、常用属性

三、常用函数

设置重力(重力)

设置重力

  • 参数 : 重力 {String} 例如:"中|下"

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获得控件
定义 按钮 = 界面.找控件("我的按钮");
//设置重力
按钮.设置重力("中|下");

设置字体(字体)

设置字体

  • 参数 : 字体 {int} 字体类型(使用$界面中的常量,例如:$界面.加粗)

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获得控件
定义 按钮 = 界面.找控件("我的按钮");
//设置字体
按钮.设置字体($界面.加粗);//常用值:$界面.正常,$界面.斜体,$界面.加粗,$界面.加粗斜体

设置主题颜色(颜色值)

设置主题颜色

由于打包后的apk可以选则不同的主题,那么我们就需要根据所选择的主题动态的获取颜色,详细请参考$颜色($color)的文档

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

//解析布局,获得ui对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获得控件
定义 按钮 = 界面.找控件("我的按钮");
//设置红色
按钮.设置主题颜色($颜色.红色);
//设置成主题的颜色(具体颜色请参考$颜色文档)
//按钮.设置主题颜色($颜色.解析("主题主颜色"));

设置主题颜色(颜色值)

设置主题颜色

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

//解析布局,获得ui对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获得控件
定义 按钮 = 界面.找控件("我的按钮");
//设置红色
按钮.设置主题颜色("#FF0000");

设置文本(文本)

设置文本

  • 参数 : 文本 {string} 文本

//解析布局,获得ui对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获得控件
定义 按钮 = 界面.找控件("我的按钮");
//设置文字
按钮.设置文本("我是新的");

获取文本()

获得文本

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

设置文本颜色(颜色)

设置文本颜色

  • 参数 : 颜色 {string} 颜色

//解析布局,获得ui对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获得控件
定义 按钮 = 界面.找控件("我的按钮");
//设置文本颜色
按钮.设置文本颜色("#FF0000");

设置文本颜色(颜色)

设置文本颜色

  • 参数 : 颜色 {string} 颜色

//解析布局,获得ui对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获得控件
定义 按钮 = 界面.找控件("我的按钮");
//设置文本颜色
按钮.设置文本颜色($颜色.红色);

设置涟漪颜色(颜色)

设置涟漪颜色

  • 参数 : 颜色 {int} 颜色

//解析布局,获得ui对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获得控件
定义 按钮 = 界面.找控件("我的按钮");
//设置涟漪颜色
按钮.设置涟漪颜色($颜色.红色);

设置涟漪颜色(颜色)

设置涟漪颜色

  • 参数 : 颜色 {string} 颜色

//解析布局,获得ui对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获得控件
定义 按钮 = 界面.找控件("我的按钮");
//设置涟漪颜色
按钮.设置涟漪颜色("#FF0000");

设置弧度(弧度)

设置弧度

  • 参数 : 弧度 {int} 弧度

//解析布局,获得ui对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获得控件
定义 按钮 = 界面.找控件("我的按钮");
//设置弧度
按钮.设置弧度(13);

设置文本尺寸(尺寸)

设置文本尺寸

  • 参数 : 尺寸 {float} 尺寸

//解析布局,获得ui对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获得控件
定义 按钮 = 界面.找控件("我的按钮");
//设置文本尺寸
按钮.设置文本尺寸(13);

设置图标(图标)

设置图标

  • 参数 : 图标 {string} 图标名称

//解析布局,获得ui对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获得控件
定义 按钮 = 界面.找控件("我的按钮");
//设置图标
按钮.设置图标("logo_ag");

设置图标颜色(颜色)

设置图标颜色

  • 参数 : 颜色 {int} 颜色

//解析布局,获得ui对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获得控件
定义 按钮 = 界面.找控件("我的按钮");
//设置图标颜色
按钮.设置图标颜色($颜色.红色);

设置图标颜色(颜色)

设置图标颜色

  • 参数 : 颜色 {string} 颜色

//解析布局,获得ui对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获得控件
定义 按钮 = 界面.找控件("我的按钮");
//设置图标颜色
按钮.设置图标颜色("#FF0000");

设置图标尺寸(尺寸)

设置图标尺寸

  • 参数 : 尺寸 {int} 尺寸

//解析布局,获得ui对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获得控件
定义 按钮 = 界面.找控件("我的按钮");
//设置图标尺寸
按钮.设置图标尺寸(15);

设置图标内边距(内边距)

设置图标内边距

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

//解析布局,获得ui对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获得控件
定义 按钮 = 界面.找控件("我的按钮");
//设置图标内边距
按钮.设置图标内边距(15);