历史版本7 :控件实际值和显示值 返回文档
编辑时间:
内容长度:图片数:目录数:
修改原因:
目录:
1. 描述编辑
在我们平时对控件的使用中，避免不了需要对控件值的引用，那么在引用控制的值时，会涉及控件实际值和显示值，现在具体划分哪些控件有实际值与显示值之分，以及控件值的使用！
2. 控件（值）对比编辑
| 控件 | 实际值 | 显示值 | 是否一致 |
|---|---|---|---|
| 文本控件 | -- | -- | 是 |
| 文本域控件 | -- | -- | 是 |
| 数字控件 | -- | -- | 是 |
| 密码控件 | -- | -- | 是 |
| 按钮控件 | -- | -- | 是 |
| 复选框控件 | -- | -- | 是 |
| 单选按钮组控件 | 有 | 有 | 否 |
| 复选框组控件 | 有 | 有 | 否 |
| 下拉框控件 | 有 | 有 | 否 |
| 下拉复选控制件 | 有 | 有 | 否 |
| 日期控件 | -- | -- | 是 |
| 文件控件 | -- | -- | 是 |
| 列表控件 | -- | -- | 是 |
| 网页框 | -- | -- | 是 |
| 下拉树 | -- | -- | 是 |
| 视图树 | -- | -- | 是 |
注：对于文本框这类控件来说，实际值和显示值是没有区别的，但是对于下拉框这种能设置数据字典来定义实际值和显示值的控件就不一样了。
3. 实例一编辑
我们先演示一下控件显示值和实际值的获取方法及使用区别！
过程：在参数面板新建：下拉框控件（t1）、单选按钮组控件（t2）、复选框控件（t3）、下拉复选框控件（t4）、文本控件（t5）及预定义按钮（提交）
注：上述控件全部独立，不存在联动！
3.1 下拉框控件（t1）
1）选中t1按钮，设置字典：
2）在预定义按钮中设置点击事件，如下：
js代码：
var Widget = this.options.form.getWidgetByName("t1"); //在参数界面获取控件的方法，先获取决策报表，再通过控件名称来获取控件 var value_1 =Widget.getValue(); //获取控件实际值 alert('我的实际值是：'+value_1); //弹出控件实际值 var value_2 =Widget.getText(); //获取控件显示值 alert('我的显示值是：'+value_2); //弹出控件显示值
3）效果预览：（实际值和显示值不同）
同理设置：单选按钮组控件（t2）、复选框控件（t3）、下拉复选框控件（t4）得到的结果一样：（实际值和显示值不同）
3.2 文本控件（t5）
文本框控件就不一样了，它的结果表明：（实际值和显示值相同）
结论：目前除了下拉框控件、单选按钮组控件、复选框控件、下拉复选框控件，这种能设置数据字典来定义实际值和显示值的控件［实际值和显示值不同］外，其他控件实际值和显示值均相同！
具体请参考上面的控件对比图表
4. 示例二编辑
如果在单元格中获取控件值，获取到的是控件的显示值还是实际值！
过程：我们分别在报表的B3、C3、D3、E3、F3单元格获取参数控件t1、t2、t3、t4、t5的值！
1）设置方法：
2）效果预览：
结论：参数界面的控件传递到后台或在单元格直接获取，都是控件的［实际值］。