图片-image
描述
图片，支持静态图片格式bmp，jpg，png等，动态图片支持gif，默认gif动画是停止的，只有调用play方法后才开始播放。父对象为ui，无子对象
事件
- sourcechange： 设置新图片源时触发，事件函数：onSourceChange(source)， source为当前图片源名称。
- framechange：帧改变时触发，只适用于gif动画图片， 事件函数：onFrameChange(frameNumber)， frameNumber为当前帧序号
- loopdone：循环完所有帧时触发，只适用于gif动画图片，事件函数：onLoopDone()。
- userevent: 当订阅了某自定义事件，通过service.ctl.emitEvent(name, value)广播时触发, 事件函数定义: onUserEvent(name,value)，参数name为事件名，value为数据
属性
| 名称 | 功能说明 | 脚本例子 |
|---|---|---|
| geometryLocked | 区域锁定，锁定后控件的位置及大小不能修改 | 无 |
| x | x坐标 （只读属性） | var x = ui.form-name.image-name.x; 获取对象的x坐标 |
| y | y坐标 （只读属性） | var y = ui.form-name.image-name.y; 获取对象的y坐标 |
| width | 宽 （只读属性） | var width = ui.form-name.image-name.width; 获取对象的宽 |
| height | 高 （只读属性） | var height = ui.form-name.image-name.width; 获取对象的高 |
| enabled | 使能：如果选中，对象处于激活状态，否则处于"禁止"状态，对所有触摸操作无反应。 | ui.form-name.image-name.enabled=0 禁止对象 |
| visible | 可见：如果选中，对象可见，否则隐藏 | ui.form-name.image-name.visible=0 隐藏对象 |
| layer | 图层：显示图层，值为0-Bottom_Layer, 1-Top_Layer. | ui.form-name.image-name.layer=0 将控件置于显示底层，如果其他top层的控件与该控件重合，将覆盖该控件 |
| verbose | 事件通知：当触发条件满足时，ExpOS主动向device.io.com0发送事件消息。仅当选择device.io.com0通讯协议为script mode时适用。 | ui.form-name.image-name.verbose=1 设置对象触发的事件有效时向device.io.com0发送事件消息 |
| stretched | 图片扩展：如果为true，图片会拉伸扩展至整个对象尺寸 | ui.form-name.image-name.stretched=1 设置图片扩展至整个对象尺寸 |
| source | 图片源 (支持App内部资源图片和外部图片源) | ui.form-name.image-name.source='test.png' 设置图片源为资源图片test.png ui.form-name.imgae-name.source='/storage/d0/1.png' 设置图片源为U盘路径下1.png |
| speedRatio | 动画播放速度比：用于设置播放速度，值为原始播放速度的倍数，只适用于gif图片 | ui.form-name.image-name.speedRatio=1.5 设置动画播放速度为原始速度的1.5倍 |
方法
| 名称 | 功能说明 | 脚本例子 |
|---|---|---|
| play() | 播放动画：可带一个参数，标识播放次数（一个循环为一次） | ui.form-name.image-name.play(2) 播放两次动画 ui.form-name.image-name.play() 播放动画，直到调用pause()或者stop() |
| stop() | 停止动画，再次播放时，动画从第一帧开始 | ui.form-name.image-name.stop() 停止动画播放 |
| pause() | 暂停动画，恢复播放时，从暂停时帧继续 | ui.form-name.image-name.pause() 暂停动画播放 |
| resume() | 恢复动画播放，从暂停时帧继续 | ui.form-name.image-name.resume() 恢复动画播放 |
| frameNumber() | 当前播放动画帧序号 | num = ui.form-name.image-name.frameNumber() 读取当前播放动画帧序号存入变量num |
| move(x,y) | 移动对象：将对象移动到(x,y)坐标位置，坐标系的原点在屏幕的左上角。 | ui.form-name.image-name.move(10,10) 移动对象到坐标（10，10） |
| resize(width, height) | 设置对象宽和高 | ui.form-name.image-name.resize(30,20) 设置对象宽30像素，高20像素 |