引用
功能用途说明
“引用”增强控件,用于定义统一的样式信息,包括前景色、背景色、字体、框线等。
页面样式相关:
- 直接设置样式
对于页面元素(或者区域),可以直接编辑字体、颜色、背景色、框线等等样式。
- 使用样式库样式
一般来说,页面的多个元素会使用相同的样式,而如果是对页面元素单独地进行样式设置,将会非常繁琐。这种情况可以在样式库中预定义一些样式,绘制页面时直接使用预定义的样式。
使用样式库中的预定义样式为页面元素设置了样式后,如果修改预定义样式,绘制页面时,报表的展现效果会直接使用修改后的样式,无需再编辑报表。
- 使用全局样式
通常一个应用系统或模块(若干个页面)会要求有统一的样式风格。如果一个页面的样式有改动,往往希望相关的页面的样式都会更新,即类似于换肤效果。针对这种情况,我们提供了“全局样式”。
全局样式与样式库的使用方法相同,都是预先定义好样式信息,制作页面是引用预定义的样式。不同的是,制作页面时,如果使用全局样式,则页面上保存的是全局样式名称,而非实际样式内容。这样,如果修改了全局样式的内容,则所有引用的页面元素均会更新为新样式。
- 使用“引用”设置样式
有些情况下,页面中可能只有少数几个元素需要特定样式。如果单独设置每个元素的样式,可能仍然会显得繁琐;如果在样式库、全局样式中预定义样式,又会显得多余。
此时,可以在当前页面(报表)中定义“引用”格,在此“引用”格上设置样式,而希望使用此样式的其他单元格则直接引用此“引用”格即可。
并不是只有“引用”增强控件才可以被其他格引用,实际上只要是独立单元格的增强类型,都可以作为“引用”格。具体包括:各类按钮、各类选择器、上传文件、小统计图、实时保存、参数。
配置项说明
名称
增强控件标识。该属性值应该保证页面内唯一,否则该控件被其他单元格引用时会出错。
此项为必填项。
行数
被引用区域的行数,默认为1。
此项为必填项。
列数
被引用区域的列数,默认为1。
此项为必填项。
示例
如上图:
- 示例1:
A8单元格插入“引用”特效
{name:"inputLabelStyle"}
A2、A4、A6单元格插入“参数”特效,通过reference引用A8单元格
{name:"inputLabel1", reference:"inputLabelStyle"}
{name:"inputLabel2", reference:"inputLabelStyle"}
{name:"inputLabel3", reference:"inputLabelStyle"}
则A2、A4、A6单元格会复制A8单元格的样式(字体、颜色、边框等)。修改时只需修改A8的样式。
- 示例2:
B8单元格插入“引用”特效
{name:"inputValueStyle"}
B2单元格设置编辑风格,同时插入“参数”特效,用reference引用B8单元格
{name:"inputValue1", reference:"inputValueStyle"}
B4单元格插入“文件选择器”特效,用reference引用B8单元格
{name:"inputValue2", reference:"inputValueStyle"}
B6单元格分别插入“上传”特效、,通过reference引用A8单元格
{name:"inputValue3", reference:"inputValueStyle"}
则B2、B4、B6单元格会复制B8单元格的样式(字体、颜色、边框等)
- 示例3:
A10单元格插入“单一按钮”特效,并设置按钮的宽、高、样式名属性
{name:"btn1", width:100, height:24, class:"gezBrighterButton"}
A12、A14单元格插入“单一按钮”,通过reference引用A10单元格
{name:"btn2", reference:"btn1"}
{name:"btn3", reference:"btn1"}
则A12、A14单元格会复制A10单元格的样式(字体、颜色、边框等),同时也会复制单元格中按钮的样式相关的属性(宽、高、样式名)
页面效果:
引用的设置:
如上图:添加引用后,需要设置名称、行数、列数,就可应用此引用。详细可参考【配置项说明】。