eui.Button
包 eui
类 public class Button
继承 eui.Button → eui.Component → egret.DisplayObjectContainer → egret.DisplayObject → egret.EventDispatcher → egret.HashObject
Button 组件是常用的矩形按钮。Button 组件看起来可以按压。默认外观具有一个文本标签和图标显示对象。
公共属性
| 属性 |
|---|
| icon : string |
| iconDisplay : eui.Image [SkinPart] 按钮上的图标显示对象 |
| label : string 要在按钮上显示的文本 |
| labelDisplay : eui.IDisplayText [SkinPart] 按钮上的文本标签 |
公共方法
| 方法 |
|---|
| Button() 创建一个按钮实例 |
事件
| Events |
|---|
| egret.TouchEvent.TOUCH_CANCEL 取消触摸事件 |
| egret.Event.COMPLETE 当设置skinName为外部exml文件路径时，加载并完成EXML解析后调度。 |
| egret.Event.RESIZE 当UI组件的尺寸发生改变时调度 |
| eui.UIEvent.MOVE 当UI组件在父级容器中的位置发生改变时调度 |
| eui.UIEvent.CREATION_COMPLETE 当UI组件第一次被添加到舞台并完成初始化后调度 |
| egret.Event.ADDED 将显示对象添加到显示列表中时调度。 |
| egret.Event.ADDED_TO_STAGE 在将显示对象直接添加到舞台显示列表或将包含显示对象的子树添加至舞台显示列表中时调度。 |
| egret.Event.REMOVED 将要从显示列表中删除显示对象时调度。 |
| egret.Event.REMOVED_FROM_STAGE 在从显示列表中直接删除显示对象或删除包含显示对象的子树时调度。 |
| egret.Event.ENTER_FRAME [广播事件] 播放头进入新帧时调度。 |
| egret.Event.RENDER [广播事件] 将要更新和呈现显示列表时调度。 |
| egret.TouchEvent.TOUCH_MOVE 当用户触碰设备时进行调度，而且会连续调度，直到接触点被删除。 |
| egret.TouchEvent.TOUCH_BEGIN 当用户第一次触摸启用触摸的设备时（例如，用手指触摸手机屏幕）调度。 |
| egret.TouchEvent.TOUCH_END 当用户移除与启用触摸的设备的接触时（例如，将手指从屏幕上抬起）调度。 |
| egret.TouchEvent.TOUCH_TAP 当用户在启用触摸设备上的已启动接触的同一 DisplayObject 实例上抬起接触点时（例如，手机点击屏幕后抬起）调度。 |
| egret.TouchEvent.TOUCH_RELEASE_OUTSIDE 当用户在启用触摸设备上的已启动接触的不同 DisplayObject 实例上抬起接触点时（例如，按住屏幕上的某个对象,然后从它上面挪开后再松开手指）调度。 |
属性详细信息
icon
icon : string|egret.Texture
- 支持版本:eui 1.0
- 运行平台:Web,Native
要在按钮上显示的图标数据
iconDisplay
iconDisplay : eui.Image = null
- 支持版本:eui 1.0
- 运行平台:Web,Native
[SkinPart] 按钮上的图标显示对象。
label
label : string
- 支持版本:eui 1.0
- 运行平台:Web,Native
要在按钮上显示的文本。
labelDisplay
labelDisplay : eui.IDisplayText = null
- 支持版本:eui 1.0
- 运行平台:Web,Native
[SkinPart] 按钮上的文本标签。
方法详细信息
Button()
public Button()
创建一个按钮实例
- 支持版本:eui 1.0
- 运行平台:Web,Native
示例
**
* 下面的例子显示了如何使用 eui.Button 类
*/
class ButtonExample extends eui.Group {
constructor() {
super();
var buttonSkin =
`<e:Skin class="skins.ButtonSkin" states="up,down,disabled" minHeight="50" minWidth="100" xmlns:e="http:/ns.egret.com/eui">
<e:Image width="100%" height="100%" scale9Grid="1,3,8,8" alpha.disabled="0.5"
source="resource/button_up.png"
source.down="resource/button_down.png"/>
<e:Label id="labelDisplay" top="8" bottom="8" left="8" right="8"
textColor="0xFFFFFF" verticalAlign="middle" textAlign="center"/>
<e:Image id="iconDisplay" horizontalCenter="0" verticalCenter="0"/>
</e:Skin>`;
var button = new eui.Button();
//组件可以接受：皮肤类定义,皮肤类名,皮肤实例,EXML文件内容,或外部EXML文件路径作为 skinName 的值
//这里我们直接用 EXML 内容作为 skinName
button.skinName = buttonSkin;
button.label = "Button";
button.addEventListener(egret.TouchEvent.TOUCH_TAP, e=> button.label = " Tap! ", this);
button.x = 50;
button.y = 50;
this.addChild(button);
}
}
