文本按钮-textbutton

描述

文本按钮，父对象为ui，无子对象。支持按下（press），释放（release）和保持（hold）事件。

---

事件

• 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.textbutton-name.x; 获取对象的x坐标
y	y坐标（只读属性）	var y = ui.form-name.textbutton-name.x; 获取对象的y坐标
width	宽（只读属性）	var width = ui.form-name.textbutton-name.width; 获取对象的宽
height	高（只读属性）	var height = ui.form-name.textbutton-name.height; 获取对象的高
marginRight	右外边距 （只读属性）	无
marginBottom	底外边距 （只读属性）	无
enabled	使能：如果选中，对象处于激活状态，否则处于”禁止”状态，对所有触摸操作无反应。	ui.form-name.textbutton-name.enabled=0 禁止对象
visible	可见：如果选中，对象可见，否则隐藏	ui.form-name.textbutton-name.visible=0 隐藏对象
verbose	事件通知：当触发条件满足时，ExpOS主动向device.io.com0发送事件消息。仅当选择device.io.com0通讯协议为script mode时适用。	ui.form-name.textbutton-name.verbose=1 设置对象触发的事件有效时向device.io.com0发送事件消息
checkable	可锁定的：每按一次按钮，按钮状态改变一次。如果当前是未锁定状态，按一下，触发press事件，状态变成锁定；再按一下，触发release事件，状态变成未锁定。	ui.form-name.textbutton-name.checkable=1 设置对象支持状态锁定
checked	锁定：1-按钮处于按下和锁定状态 0-按钮处于抬起状态	ui.form-name.textbutton-name.checked=1 设置对象处于按下和锁定状态
icon	图标	ui.form-name.textbutton-name.icon=’icon.jpg’ 设置图标为资源图片icon.jpg
iconSize	图标大小	无
font	字体	无
text	文字	ui.form-name.textbutton-name.text=”test” 设置对象当前语言环境下的文字为’test’
textAlign	文字对齐方式: 0-Center, 1-Left，2-Right，3-Top，4-Bottom	ui.form-name.textbutton-name.textAlign=0 设置对象文本居中对齐
textColor	文字颜色, 颜色定义参看 控件对象	ui.form-name.textbutton-name.textColor=’#ff0000’ 设置文字颜色为红色
backgroundColorType	背景色类型：0-Linear_A, 1-Linear_B, 2-Radial_A, 3-Radial_B, 4-Circle, 5-Pure, 6-No_Color可选	ui.form-name.textbutton-name.backgroundColorType=4 设置form的背景颜色类型为Circle
backgroundColor	背景色，颜色定义参看 控件对象	ui.form-name.textbutton-name.backgroundColor=’#0000ff’ 设置背景色为蓝色
borderType	边框类型: 0-Inset，1-Outset，2-Dotted，3-Solid，4-No_Border。	ui.form-name.textbutton-name.borderType=4 设置对象无边框
borderColor	边框颜色，颜色定义参看 控件对象	ui.form-name.textbutton-name.borderColor=’#ff0000’ 设置边框颜色为红色
highlightedTextColor	高亮文字颜色	ui.form-name.textbutton-name.highlightedTextColor=’#ffffff’ 设置高亮时文字颜色为白色
highlightedBackgroundColor	高亮背景颜色	ui.form-name.textbutton-name.highlightedBackgroundColor=’#0000ff’ 设置高亮时背景颜色为蓝色
highlightedBorderColor	高亮边框颜色	ui.form-name.textbutton-name.highlightedBorderColor=’#ff0000’ 设置高亮时边框颜色为红色
highlightExclusive	高亮互斥，勾选表示同一分组只能有一个按钮高亮显示	ui.form-name.textbutton-name.highlightExclusive=true 设置高亮互斥
borderWidth	边框宽度，单位：像素	ui.form-name.textbutton-name.borderWidth=5 设置对象边框宽为5个像素
borderRadius	边框拐角弧度半径，单位：像素	ui.form-name.textbutton-name.borderRadius=8 设置对象边框拐角半径为8个像素
autoRepeat	自动重复hold事件。如果选中，当按钮被按下并保持时， 自动产生hold事件，间隔时间由autoRepeatInterval指定.	ui.form-name.textbutton-name.autoRepeat=1 设置对象支持产生onHold事件
autoRepeatInterval	自动重复hold的时间间隔，单位：ms。 只有autoRepeat选中，该属性才有效.	ui.form-name.textbutton-name.autoRepeatInterval=500 设置对象500ms产生一次onHold事件
group	分组：使能高亮互斥属性后才有效，组名相同的按钮高亮互斥。	ui.form-name.textbutton-name.group=’row1’ 设置高亮互斥的分组名为row1

方法

名称	功能说明	脚本例子
名称	功能说明	脚本例子
simulateTouch(state)	软件模拟触摸动作，state表示触摸的动作状态：0-release(抬起)，1-Press（按下）	ui.form-name.textbutton-name.simulateTouch(1) 模拟触摸按下按钮
setFontSize(size)	设置字体大小	ui.form-name.textbutton-name.setFontSize(12) 设置字体为12号
setText(string, index)	设置语言环境为index时的文字标识：string为文字字符串，index为语言环境索引值。当通过service.ctl.setLanguage(index)设置对应的语言环境时，该文字字符串自动显示。	ui.form-name.textbutton-name.setText(‘测试’, 1) 设置语言环境1下的文字标识为’测试’，当切换到语言环境1时，该标识自动显示替代之前的语言环境字符串
backspace()	回退操作，删除最后一个字符	ui.form-name.textbutton-name.backspace() 删除最后一个字符
append(text)	追加字符串，参数text为字符串	ui.form-name.textbutton-name.append(‘A’) 在最后面追加一个字符’A’
highlight(enabled)	设置按钮高亮显示，如果设置了高亮互斥，同一分组只能有一个按钮高亮	ui.form-name.textbutton-name.highlight(true) 按钮高亮
move(x,y)	移动对象：将对象移动到(x,y)坐标位置，坐标系的原点在屏幕的左上角	ui.form-name.textbutton-name.move(10,10) 移动对象到坐标（10，10）
resize(width, height)	设置对象宽和高	ui.form-name.textbutton-name.resize(30,20) 设置对象宽30像素，高20像素