图片-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; 获取对象的高 |
marginRight |
右外边距 （只读属性） |
无 |
marginBottom |
底外边距 （只读属性） |
无 |
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 <br> 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) 播放两次动画<br> 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像素 |