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

单选按钮

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

单选按钮-radio

原生类型:{com.google.android.material.radiobutton.MaterialRadioButton}

单选按钮：一般需要配合单选按钮组(radio-group)的配合才能实现互相排斥的效果，这个控件常用在只需要在多个选择中选择一个的情况。

一、常用属性

主题颜色 - 主题颜色

设置主题颜色

<单选按钮 主题颜色="#57965C" 文本="主题色为绿色" />

选中 - 选中状态

设置选中状态

<单选按钮 选中="是" 文本="主题色为绿色" />

文本 - 文本

设置文本

<单选按钮 文本="默认文本" />

文本颜色 - 文本颜色

设置文本颜色

<单选按钮 主题颜色="#57965C" 文本="文本为白色" 文本颜色="#FFFFFF" />

最小宽度 - 最小宽度

设置最小宽度

<单选按钮 最小宽度="100" />

最小高度 - 最小高度

设置最小高度

<单选按钮 最小高度="100" />

内边距 - 内边距

设置内边距

<!--内边距顺序是:左,上,右,下-->
<!--内边距只设置一个值：则设置所有方向的内边距-->
<!--内边距只设置两个值：则设置左右和上下方向的内边距-->
<单选按钮 内边距="20" 文本="内边距" />

重力 - 重力

设置重力

<单选按钮 重力="开始" 高="100" 外边距="20" 文本="重力:开始" 宽="最大" />

背景颜色 - 背景颜色

设置背景颜色

<单选按钮 背景颜色="#1E1F22" 文本="背景颜色" />

背景图片 - 背景图片

设置背景图片

<单选按钮 背景图片="./资源/图片01.png" 文本="背景图片" />

二、常用函数

是选中的()

判断选中状态

  • 返回 : {布尔值} 是否选中

  • 版本 : 1.8.2

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./资源/主界面.xml");
//获取控件
定义 单选按钮 = 界面.找控件("我的单选按钮");
//判断选中状态
如果(单选按钮.是选中的()){
    日志("选中了");
}

设置选中(状态)

设置选中状态

  • 参数 : 状态 {boolean} 是否选中

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 单选按钮 = 界面.找控件("我的单选按钮");
//设置选中状态
单选按钮.设置选中(是);

监听选中(回调)

监听选中事件

  • 参数 : 回调 {(是否选中)=>{}} 选中事件回调

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 单选按钮 = 界面.找控件("我的单选按钮");
//监听选中事件
单选按钮.监听选中((是否选中)=>{
    //..
});

设置重力(重力)

设置重力

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

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

设置文字(文本)

设置文字

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

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 单选按钮 = 界面.找控件("我的单选按钮");
//设置文字
单选按钮.设置文字("吃饭");

获取文字()

获取文字

  • 返回 : {String} 文字内容

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

设置主题颜色(颜色)

设置主题颜色

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

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 单选按钮 = 界面.找控件("我的单选按钮");
//设置主题颜色
单选按钮.设置主题颜色("#26282E");

设置文本颜色(颜色)

设置文本颜色

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

//解析布局,获得界面对象
定义 界面 = $界面.解析布局("./主界面.xml");
//获取控件
定义 单选按钮 = 界面.找控件("我的单选按钮");
//设置文本颜色
单选按钮.设置文本颜色("#26282E");
ON THIS PAGE