控件应用中,当原始数据中存储的字段不适宜展现在报表上;或需要根据不同的原始数据在报表中显示不同的值时,部分控件支持通过使用数据字典功能将实际值和显示值做巧妙变换。如下图所示:

支持数据字典功能,有实际值和显示值区分的控件如下表所示:

那在使用中,这部分控件传值和引用值的过程中,传的是实际值,还是显示值呢?本章将具体介绍这些有实际值与显示值区分的控件,在使用时的传值逻辑。

1)控件绑定数据字典,传值的时候传的都是实际值;显示值只是用来显示,传值的时候不会被传递。如下图所示。

2)参数和控件绑定,通过$参数名(控件名),获取到的值也是实际值,不是显示值。如下图所示:

3)通常实际值和显示值是一一对应的关系,但也会存在不一一对应的情况,即多个显示值对应一个实际值;多个实际值对应多个显示值。

多个实际值对应一个显示值时,控件会列表展示所有的显示值,不会将同样的值合并。如下图所示:

多个显示值对应一个实际值时,控件会将所有显示值显示出来。如下图所示:

传递值时都会传递实际值,按顺序对应,不会合并。

4)控件默认值处可以填写显示值,也可以填写实际值。填写显示值也可以匹配到选项,但传递值时传递的依旧是实际值。

如果实际值和显示值不一一对应,情况如下图所示:

控件值处写入显示值,这个显示值对应多个实际值:传值时,将会按顺序传递第一个实际值。

控件值处写入实际值,这个实际值对应多个显示值:显示时,单选情况下只会选中第一个显示值。

示例完成一个实际值和显示值不一样的查询模板,演示实际值和显示值不一样时,值的传输规则。