图片按钮-imagebutton
描述
图片标识的按钮，无边框，可定制按下和抬起时的图片，父对象为ui，无子对象
事件
press： 按下，按下按钮时触发，事件函数定义: onPress()
release：释放，松开按钮时触发，事件函数定义: onRelease()
hold：保持，按住按钮时触发，只适用于非锁定按钮（属性checkable=false），事件函数定义: onHold()
userevent: 当订阅了某 用户自定义事件，通过service.ctl.emitEvent(name, value)广播时触发, 事件函数定义: onUserEvent(name,value)，参数name为事件名，value为数据
属性
名称 |
功能说明 |
脚本例子 |
|---|---|---|
geometryLocked |
区域锁定，锁定后控件的位置及大小不能修改 |
无 |
x |
x坐标 （只读属性） |
var x = ui.form-name.imagebutton-name.x; 获取对象的x坐标 |
y |
y坐标 （只读属性） |
var y = ui.form-name.imagebutton-name.y; 获取对象的y坐标 |
width |
宽 （只读属性） |
var width = ui.form-name.imagebutton-name.width; 获取对象的宽 |
height |
高 （只读属性） |
var height = ui.form-name.imagebutton-name.width; 获取对象的高 |
marginRight |
右外边距 （只读属性） |
无 |
marginBottom |
底外边距 （只读属性） |
无 |
enabled |
使能：如果选中，对象处于激活状态，否则处于”禁止”状态，对所有触摸操作无反应。 |
ui.form-name.imagebutton-name.enabled=0 禁止对象 |
visible |
可见：如果选中，对象可见，否则隐藏 |
ui.form-name.imagebutton-name.visible=0 隐藏对象 |
verbose |
事件通知：当触发条件满足时，ExpOS主动向device.io.com0发送事件消息。仅当选择device.io.com0通讯协议为script mode时适用。 |
ui.form-name.imagebutton-name.verbose=1 设置对象触发的事件有效时向device.io.com0发送事件消息 |
text |
按钮文字 |
ui.form-name.imgagebutton-name.text=”test” 设置对象当前语言环境下的文字为’test’ |
textColor |
文字颜色, 颜色定义参看 控件对象 |
ui.form-name.imagebutton-name.textColor=’#ff0000’ 设置文字颜色为红色 |
textAlign |
文字对齐方式: 0-Center, 1-Left，2-Right，3-Top，4-Bottom |
ui.form-name.imagebutton-name.textAlign=0 设置对象文本居中对齐 |
releasedSource |
抬起状态时的图片源文件 |
ui.form-name.imagebutton-name.releasedSource=’test.png’ 设置抬起时显示资源图片test.png |
pressedSource |
按下和保持状态时的图片源文件 |
ui.form-name.imagebuttonname.presssedSource=’test.png’ 设置按下时显示资源图片test.png |
stretched |
拉伸背景图片，默认值为使能 |
ui.form-name.imagebuttonname.stretched=false 设置背景图片不拉伸占满控件 |
spacing |
字距，文字和图片的间距 |
ui.form-name.imagebuttonname.spacing=20 设置文字与图片的间距为20像素 |
textIconLayout |
图文布局(0-左文右图,1-右文左图,2-上文下图,3-下文上图) |
ui.form-name.imagebuttonname.textIconLayout=1 设置上文下图的布局 |
backgroundColorType |
背景色类型：0-Linear_A, 1-Linear_B, 2-Radial_A, 3-Radial_B, 4-Circle, 5-Pure, 6-No_Color |
ui.form-name.imagebuttonname.backgroundColorType=5 设置背景颜色类型为纯颜色 |
pressBackgroundColor |
按下的背景颜色 |
ui.form-name.imagebuttonname.pressBackgroundColor=’#b7e5f3’ 设置按下时的背景颜色 |
releaseBackgroundColor |
释放的背景颜色 |
ui.form-name.imagebuttonname.releaseBackgroundColor=’#add8e6’ 设置释放时的背景颜色 |
borderType |
边框类型：0-Inset，1-Outset，2-Dotted，3-Solid，4-No_Border。 |
ui.form-name.imagebuttonname.borderType=4 设置对象无边框 |
borderColor |
边框颜色,颜色定义参看 控件对象 |
ui.form-name.imagebuttonname.borderColor=’#ff0000’ 设置边框为红色 |
borderWidth |
边框宽度，单位：像素 |
ui.form-name.imagebuttonname.borderWidth=5 设置对象边框宽为5个像素 |
borderRadius |
边框拐角弧度半径，单位：像素 |
ui.form-name.imagebuttonname.borderRadius=8 设置对象边框拐角半径为8个像素 |
effect |
显示效果：0-None, 1-Shadow, 2-Blur |
ui.form-name.imagebuttonname.effect=1 显示效果为Shadow |
blurRadius |
模糊半径 |
ui.form-name.imagebuttonname.blurRadius=2 设置模糊半径为2 |
checkable |
支持状态锁定。如果选中，每按一次按钮，按钮状态只变一次。如：当按钮处于抬起状态时，按一次按钮，按钮处于按下状态并一直锁定在该状态，直到再按一次该按钮，按钮解除锁定，回到抬起状态。 |
|
checked |
按钮的锁定状态。1：按钮处于按下和锁定状态 0：按钮处于抬起状态 |
ui.form-name.imagebutton-name.checked=1 设置对象处于按下和锁定状态 |
autoRepeat |
自动重复onHold事件。如果选中，当按钮被按下并保持时， 自动产生onHold事件，间隔时间由autoRepeatInterval指定. |
ui.form-name.imagebutton-name.autoRepeat=1 设置对象支持产生onHold事件 |
autoRepeatInterval |
自动重复onHold的时间间隔，单位：ms。 只有autoRepeat选中，该属性才有效. |
ui.form-name.imagebutton-name.autoRepeatInterval=500 设置对象500ms产生一次onHold事件 |
方法
名称 |
功能说明 |
脚本例子 |
|---|---|---|
simulateTouch(state) |
软件模拟触摸动作，state表示触摸的动作状态：0-release(抬起)，1-Press（按下） |
ui.form-name.imagebutton-name.simulateTouch(1) 模拟触摸按下按钮 |
move(x,y) |
移动对象：将对象移动到(x,y)坐标位置，坐标系的原点在屏幕的左上角。 |
ui.form-name.imagebutton-name.move(10,10) 移动对象到坐标（10，10） |
resize(width, height) |
设置对象宽和高 |
ui.form-name.imagebutton-name.resize(30,20) 设置对象宽30像素，高20像素 |