构造函数
| 构造函数 | 说明 | 备注 |
|---|---|---|
| IButton(bmp1,bmp2,txt,viewport,isNeedDraw) | bmp1(Image) 按钮按下前位图 bmp2(Image) 按钮按下后的位图 txt(string) 按钮上的文字 可缺省 viewport(IViewprot) 按钮所归属的视窗 可缺省 isNeedDraw(bool) 需要生成单独绘制精灵 可缺省 | 无 |
属性
| 属性 | 说明 | 备注 |
|---|---|---|
| tag(any) | 绑定在button上的数据 | 无 |
| onload(function) | 设置按钮的资源读取回调函数 | 仅Web有效，其他端直接执行函数内容 |
| x(Number) | 设置或获得 按钮的x坐标 | 无 |
| y(Number) | 设置或获得 按钮的y坐标 | 无 |
| z(Number) | 设置或获得 按钮的图层 | 无 |
| zoomX(Number) | 设置或获得 按钮的X方向缩放率 | 无 |
| zoomY(Number) | 设置或获得 按钮的Y方向缩放率 | 无 |
| visible(bool) | 设置按钮是否可见 | 无 |
| opacity(Number) | 设置按钮的不透明度 取值范围0~1 | 无 |
| width(Number) | 获得按钮宽度 | 只读 |
| height(Number) | 获得按钮高度 | 只读 |
函数
| 函数 | 说明 | 备注 |
|---|---|---|
| drawTitle(str,x,y) | 重新绘制按钮文字 str(string) 要绘制的文字，支持转译 x(Number) 相对于按钮的x坐标 y(Number) 相对于按钮的y坐标 | 无 |
| drawTitleQ(str,color,size) | 高效重新绘制按钮文字 str(string) 要绘制的文字 color(IColor) 文字颜色 size(Number) 文字大小 文字在居中位置 | 无 |
| toSimple(tp,sn) | 转换按钮类型 tp(Number) -1 默认双图片样式 0 单图片样式 sn 单图片按下缩放率 | 无 |
| setYXYY(yx,yy) | 设置按钮圆心点位置 yx 圆心x 取值0~1 yy 圆心y 取值0~1 | 无 |
| setBitmap(bmp1,bmp2,dispose) | 重新设置按钮图片 bmp1 未按下图片 bmp2 按下图片 dispose 释放之前的图片 | 无 |
| getSprite() | 获得绘制精灵（需要在构造时isNeedDraw为true才可获得绘制精灵） 返回值 ISprite | 无 |
| getText() | 获得绘制文字的精灵（需要在构造时 txt 不为空字符串才可获取） 返回值 ISprite | 无 |
| exchange() | 交换设置的按下状态与未按下状态的图片 | 无 |
| dispose() | 释放按钮资源 | 无 |
| disposeMin() | 释放按钮索引资源，保留按钮图片资源 | 无 |
| isSelected() | 按钮是否被选中 返回值 isBool | 无 |
| setEnableBitmap(bmp) | 设置按钮不可用情况的图片 bmp(Image) 位图 | 无 |
| setEnable(b) | 设置按钮的可用状态 b(Bool) | 无 |
| getEnable() | 获得按钮的可用状态 返回值 Bool | 无 |
| isClick() | 按钮是否按下 返回值 Bool | 无 |
| isOn() | 按钮是否被鼠标悬停/触摸 返回值 Bool | 无 |
| cancelSelect() | 取消按钮选择 | 无 |
| getBack() | 获得按钮的基本精灵 返回值 ISprite | 无 |
| update() | 按钮的主刷新逻辑 返回值 Bool（按钮是否被按下） 此函数需要放进状态机中动画才能有实际效果 | 无 |
| fade(bo,eo,frame) | 设置按钮淡入淡出动画 bo(Number) 起始不透明度 eo(Number) 结束不透明度 | 无 |
| fadeTo(o, frame) | 设置按钮从当前不透明度起的淡入淡出动画 o(Number) 目标不透明度 frame(Number) 帧数 | 无 |
| slide(bx, by,ex,ey, frame) | 设置按钮位移动画 bx(Number) 起始x坐标 by(Number) 起始y坐标 ex(Number) 目标x坐标 ey(Number) 目标y坐标 frame(Number) 所需帧数 | 无 |
| slideTo(x, y, frame) | 设置按钮从当前位置到目标位置的移动动画 x(Number) 目标x坐标 y(Number) 目标y坐标 frame(Number) 所需帧数 | 无 |
| scale(bzx, bzy,ezx,ezy, frame) | 设置按钮缩放动画 bzx(Number) 起始x轴缩放率 bzy(Number) 起始y轴缩放率 ezx(Number) 目标x轴缩放率 ezy(Number) 目标y轴缩放率 frame(Number) 帧率 | 无 |
| scaleTo(zx, zy, frame) | 设置按钮从当前缩放率到目标缩放率的动画 zx(Number) 目标x轴缩放率 zy(Number) 目标y轴缩放率 frame(Number) 帧率 | 无 |
| setAction(action,args) | 设置按钮动作序列 action(action枚举) args(多参数) 具体动作参数 | 无 |
| setActLoop(loop) | 是否重复执行动作序列 loop(bool) true为重复执行 false 只执行一次 | 无 |