跳到主要内容

eui.RadioButtonGroup

包    eui

类    public class RadioButtonGroup

继承    eui.RadioButtonGroup → egret.EventDispatcher → egret.HashObject

RadioButtonGroup 组件定义一组 RadioButton 组件，这些组件相互排斥；因此，用户每次只能选择一个 RadioButton 组件

公共属性​

属性
enabled : boolean
确定是否允许选择
numRadioButtons : number
属于此 RadioButtonGroup 的 RadioButton 数
selectedValue : any
组中所选 RadioButton 组件的 value 属性（如果未设置），否则为所选 RadioButton 组件的 label 属性
selection : eui.RadioButton
当前被选中的单选按钮引用

公共方法​

方法
RadioButtonGroup()
构造函数
getRadioButtonAt(index:number):eui.RadioButton
返回指定索引处的 RadioButton 组件

事件​

Events
egret.Event.CHANGE
此组中所选 RadioButton 组件的值更改时分派。

属性详细信息​

enabled​

enabled : boolean = true

  • 支持版本:eui 1.0
  • 运行平台:Web,Native

确定是否允许选择。请注意，返回的值仅反映对 RadioButtonGroup 显式设置的值，而不反映对各个 RadioButton 显式设置的任何值。

numRadioButtons​

numRadioButtons : number = 0

  • 支持版本:eui 1.0
  • 运行平台:Web,Native

属于此 RadioButtonGroup 的 RadioButton 数。

selectedValue​

selectedValue : any = null

  • 支持版本:eui 1.0
  • 运行平台:Web,Native

组中所选 RadioButton 组件的 value 属性（如果未设置），否则为所选 RadioButton 组件的 label 属性。如果未选择任何 RadioButton，则此属性为 null。如果设置了 selectedValue，则会选择 value 或 label 属性与此值匹配的第一个 RadioButton 组件。

selection​

selection : eui.RadioButton = null

  • 支持版本:eui 1.0
  • 运行平台:Web,Native

当前被选中的单选按钮引用。此属性仅当目标RadioButton在显示列表时有效。

方法详细信息​

RadioButtonGroup()​

public RadioButtonGroup()

构造函数。

  • 支持版本:eui 1.0
  • 运行平台:Web,Native

getRadioButtonAt()​

public getRadioButtonAt(index:number):eui.RadioButton

返回指定索引处的 RadioButton 组件。

  • 支持版本:eui 1.0

  • 运行平台:Web,Native

  • 参数

    • index:number - RadioButtonGroup 中的 RadioButton 的从零开始的索引。

  • 返回:当索引位于 0 和

    Copy

    numRadioButtons

    之间时，指定的 RadioButton 组件为 1。如果索引无效，则返回

    Copy

    null

    。

示例​

class  RadioButtonGroupExample  extends  egret.Sprite  {

public  constructor()  {

super();

var skinExml =

`<e:Skin class="skins.RadioButtonSkin" states="up,down,disabled,upAndSelected,downAndSelected,disabledAndSelected" xmlns:e="http:/ns.egret.com/eui">

<e:Image height="22" includeIn="disabledAndSelected" source="resource/RadioButton/radiobutton_select_disabled.png"/>

<e:Image height="22" includeIn="downAndSelected" source="resource/RadioButton/radiobutton_select_down.png"/>

<e:Image height="22" includeIn="upAndSelected" source="resource/RadioButton/radiobutton_select_up.png"/>

<e:Image height="22" includeIn="up,down,disabled" source="resource/RadioButton/radiobutton_unselect.png"/>

<e:Label x="38" id="labelDisplay" textColor="0xffffff" size="18"/>

</e:Skin>`;

EXML.parse(skinExml);

var exml =

`<e:Group xmlns:e="http:/ns.egret.com/eui">

<e:layout>

<e:VerticalLayout gap="20"/>

</e:layout>

<e:RadioButton id="radio1" groupName="en" label="A. This is a radioButton." skinName="skins.RadioButtonSkin"/>

<e:RadioButton id="radio2" groupName="en" label="B. This is a progressBar." skinName="skins.RadioButtonSkin"/>

<e:RadioButton id="radio3" groupName="cn" label="1. 今天是晴天." skinName="skins.RadioButtonSkin"/>

<e:RadioButton id="radio4" groupName="cn" label="2. 今天是雨天." skinName="skins.RadioButtonSkin"/>

</e:Group>`;

var clazz =  EXML.parse(exml);

var group =  new  clazz();

this.addChild(group);

group.radio1.group.addEventListener(eui.UIEvent.CHANGE,  (evt)  =>  {

var radioGroup: eui.RadioButtonGroup  = evt.target;

egret.log(radioGroup.selectedValue);

egret.log(group.radio1.selected);

},this)

group.x  =  50;

group.y  =  50;

}

}