引用控件及控件方法列表
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.visible() | 设置控件可见 |
| 不可见 | Widget.invisible() | 设置控件不可见 |
| 是否可见 | Widget.isVisible() | 返回控件是否可见，返回true可见，false不可见 |
| 设置可见 | Widget.setVisible(boolean) | 设置控件是否可见，参数为true可见，false不可见 |
| 设置可用 | Widget.setEnable(boolean) | 设置控件是否可用，参数为true可用，false不可用 |
| 是否可用 | Widget.isEnabled() | 返回控件是否可用，返回true可用，false不可用 |
| 调用控件事件 | Widget.fireEvent("事件名称") | 设置控件触发指定名字的事件 |
注：若js脚本在当前控件的事件中，可以不用获取当前控件，直接使用this，如this.getValue();
另：Widget.fireEvent("事件名称")中填写的值可查看控件事件章节中的事件名称。
另：Widget.setValue()该方法是给控件赋值，但是不建议在填报页面用该方法给控件赋值，因为这是给控件赋值，并不是单元格，在填报的时候如果使用该方法赋值，每次给控件赋值完成之后，将值传给单元格之前，会被清空，最后单元格的值还是为空，所以在填报页面建议使用setCellValue()给控件赋值。
附件列表
主题： 二次开发
标签：
已验证