历史版本17 :引用控件及控件方法列表 返回文档
编辑时间:
内容长度:图片数:目录数:
修改原因:
1. 概述编辑
控件有很多的方法,比如控制控件是否可见,是否可用等等,在调用控件方法前必须要获取到控件。从 6.5.5 版本开始,在cpt和frm的参数界面,在 cpt 的填报界面和在 frm 的 body 主体中,都可以获取到控件,并引用控件的方法。
但是 6.5.5 之前的版本,填报界面是获取不到控件的。
2. 获取控件编辑
在参数界面、决策报表界面获取控件的方法是相同的,先获取决策报表,再通过控件名称来获取控件,如下所示:
var Widget = this.options.form.getWidgetByName("WidgetName");
在 cpt 填报时获取控件,先获取报表对象 contentPane,再通过控件名称来获取控件,如下所示:
var Widget = contentPane.getWidgetByName("WidgetName");
3. 控件常用方法编辑
通过上述的方法可以获取到控件,例如我们获取的控件变量为 Widget,那么可以通过 Widget.getValue();来调用控件的方法。
以下列出控件的方法,假设获取到的控件变量为 Widget:
方法名 | 方法 | 说明 |
取值 | Widget.getValue() | 获取控件值 |
取值 | Widget.getText() | 获取控件显示值 |
赋值 | Widget.setValue() | 给参数控件赋值,不建议给填报控件赋值 |
重置 | Widget.reset() | 清空数据 |
是否可见 | Widget.isVisible() | 返回控件是否可见,返回 true 可见,false 不可见 |
设置可见 | Widget.setVisible(boolean) | 设置控件是否可见,参数为 true 可见,false 不可见 |
设置可用 | Widget.setEnable(boolean) | 设置控件是否可用,参数为 true 可用,false 不可用 |
是否可用 | Widget.isEnabled() | 返回控件是否可用,返回 true 可用,false 不可用 |
调用控件事件 | Widget.fireEvent("事件名称") | 设置控件触发指定名字的事件 |
注:若 JavaScript 脚本在当前控件的事件中,可以不用获取当前控件,直接使用 this,如 this.getValue();
另:Widget.fireEvent("事件名称")中填写的值可查看 控件事件 章节中的事件名称。
另:Widget.setValue()该方法是给控件赋值,但是不建议在填报页面用该方法给控件赋值,因为这是给控件赋值,并不是单元格,在填报的时候如果使用该方法赋值,每次给控件赋值完成之后,将值传给单元格之前,会被清空,最后单元格的值还是为空,所以在填报页面建议使用 setCellValue() 给控件赋值。