图片按钮-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事件 ui.form-name.imagebutton-name.checkable=1 设置对象支持状态锁定

方法

名称 功能说明 脚本例子
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像素

results matching ""

    No results matching ""