Dorado 5 : 3.组件的API、属性与事件 (WP)

表现层组件提供API、属性与事件,属性与事件可以在运行期热设置与热加载,例如实现组件字体动态变化、动态改变按钮点击后的不同动作等。
例如文本编辑器的部分API如下:

API

说明

voidactivate()

激活控件

voiddisableBinding()

禁用数据绑定

voidenableBinding()

启用数据绑定

voidestablishBinding()

建立与数据集的绑定关系.

String getDataType()

获取数据类型


例如文本编辑器的主要属性如下:

属性

说明

dataType

数据类型

dataset

绑定的记录集

dropDown

绑定下拉框

editorType

编辑框的类型

field

绑定的字段名

name

编辑框的名字

readOnly

编辑框的只读属性,可选值为true/false

toolTip

编辑框的用户提示信息

value

设定编辑框的默认值,和记录集绑定的编辑框该属性无效,默认值需要通过绑定字段的defaultValue属性设定


文本编辑器的主要事件如下:

属性

说明

onPost

当外界试图从编辑器中读取数值时触发的事件

onSetValue

当该编辑器中的新录入的数据已被确认并已成功更新到绑定的数据集中时触发.

onGetValue

当外界试图将一个新的数值赋值给编辑器时触发的事件