FineReport智能数据图表- 文本域控件

news2024/9/20 0:59:50

1. 概述

1.1 版本

报表服务器版本

11.0

1.2 应用场景

1.2.1 填报控件

填报报表中可以通过该控件输入多行文本信息，录入填报的数据，如下图所示：

1.2.2 参数控件

参数面板处可以通过该控件输入多行文本信息，键入查询参数，如下图所示：

1.2.3 注意事项

1）「文本域控件」支持换行，填报预览界面按 Ctrl+Enter 键，参数面板和决策报表中按 Enter 键即可换行。

2）「文本域控件」的换行符可以提交入库，但数据库和模板数据集中不会显示换行效果，需要预览模板时才可以看到换行效果。

3）「文本域控件」不支持使用Ctrl+Z实现回退效果。

1.3 如何添加

1.3.1 填报控件

选中单元格后，点击右侧属性面板的「控件设置」，「选择控件」处下拉选择「文本域控件」，如下图所示：

1.3.2 参数控件

将参数面板控件工具栏中的「文本域控件」拖入到参数面板中，如下图所示：

2. 控件介绍

2.1 属性

2.1.1 填报控件

「文本域控件」的属性设置界面如下图所示：

各属性设置项的详细介绍如下：

注：「文本域控件」在填报应用时，可通过在单元格中添加值的方式设置默认值。

分类	设置项	详细介绍
基本	控件名称	控件的名称，手动输入，通常与参数结合使用，如通过控件名获取控件后将控件值传递给对应参数，默认为空。
	可用	控件是否可用，勾选后，填报时控件可编辑；不勾选，填报时控件灰化，不可编辑，默认勾选。
	可见	控件是否可见，勾选后，填报时页面显示控件；不勾选，填报时页面不显示控件，默认勾选。
高级	水印	填报时控件内显示的浅灰色水印文字，手动输入，以提示用户需要输入的信息，点击控件编辑区域后消失，默认为空。
校验	允许为空	是否允许控件为空值，勾选后，允许控件为空值；不勾选，填报校验和提交时会提示，默认勾选。
	错误提示	不勾选「允许为空」时出现的设置项，可自定义提示信息。默认情况下将显示：不能为空
	填写规则	控件输入值需要符合的规则，若不符合规则，则提示错误信息。支持的校验规则共有 3 种，如下： 1）无：不限制校验规则。 2）长度：定义文本域的长度区间，校验多行文本长度。 3）自定义：正则表达式自定义校验规则。默认为无。

2.1.2 参数控件

「文本域控件」的属性设置界面如下图所示：

各属性设置项的详细介绍如下：

分类	设置项	详细介绍
基本	控件名称	控件的名称，手动输入，通常与参数结合使用，如通过控件名获取控件后将控件值传递给对应参数，默认为 textArea#。
	可用	控件是否可用，勾选后，填报时控件可编辑；不勾选，填报时控件灰化，不可编辑，默认勾选。
	可见	控件是否可见，勾选后，填报时页面显示控件；不勾选，填报时页面不显示控件，默认勾选。
高级	标签名称	用来弥补参数界面中标签控件不支持的问题，默认为空。
	控件值	控件初始化时的默认值，支持字符串、字段、公式，默认为空。字符串：字符文字，例如：华东华北，像这样中间加几个空格后，文本域会换行显示字段：数据集字段，数据集包括模板数据集和服务器数据集。例如：数据集 ds1 的地区字段公式：设计器支持的公式，例如： A1 单元格的值
	水印	填报时控件内显示的浅灰色水印文字，手动输入，以提示用户需要输入的信息，点击控件编辑区域后消失，默认为空。
	字体大小	文本框中输入的字体的大小，默认为12 。
校验	允许为空	是否允许控件为空值，勾选后，允许控件为空值；不勾选，填报校验和提交时会提示，默认勾选。
	错误提示	不勾选「允许为空」时出现的设置项，可自定义提示信息。默认情况下将显示：不能为空
	填写规则	控件输入值需要符合的规则，若不符合规则，则提示错误信息。支持的校验规则共有 3 种，如下： 1）无：不限制校验规则。 2）长度：定义文本域的长度区间，校验多行文本长度。 3）自定义：正则表达式自定义校验规则。默认为无
坐标.尺寸	控件位置	控件在参数面板中的位置，通过横纵坐标调整，坐标会根据控件在参数面板中的位置自动显示。
坐标.尺寸	控件大小	控件的大小，通过宽度、高度调整，若通过拖拽调整，高宽度也随着自动调整。