
# 1 功能介绍
用于输入较长的文本内容,即可在输入框直接输入,也可点击按钮弹出对话框输入。结合 *字段布局面板 *控件使用,布局体验最佳。
# 2 控件对象
`kd.bos.form.field.LargeTextEdit`
# 3 视觉展示
录入摘要:

录入详情:

# 4 属性说明
## 4.1 通用属性
>通用属性包含字段和控件的一些公有的属性,如宽高,帮助文本等。请参考[通用属性](https://vip.kingdee.com/article/215559076720798976)
## 4.2 样式属性
>样式属性是每个控件在设计器右侧样式栏可以设置的属性,请参考[样式属性](https://vip.kingdee.com/article/252017936767406336)
## 4.3 业务属性
| 属性名 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| 缺省值 | 文本 | - | 设置默认显示的值 |
| 按钮图标 | 弹框选择 | | 设置按钮点击图标 |
| 编辑模式 | 下拉 | 摘要模式 | 编辑模式可选摘要模式和多行文本模式,详见4.3.1 |
| 为空提示信息 | 文本 | - | 当字段内容为空时,输入框内显示的信息 |
| 锁定为空提示信息 | 文本 | - | 当字段内容为空且字段锁定时显示的信息,锁定为空信息会覆盖为空提示信息 |
### 4.3.1 编辑模式
编辑模式分为摘要模式和多行文本模式:
* 摘要模式:有按钮图标和最大长度限制;点击图标可弹出对话框输入内容。

* 多行文本模式:没有按钮图标,也没有最大长度限制。

# 5 大文本接口介绍
## 5.1 控件编程模型
### 5.1.1 控件编程模型定义
大文本字段的控件编程模型是LargeTextEdit,派生自文本字段的控件编程模型[TextEdit](https://vip.kingdee.com/article/228981705241898752):
```java
package kd.bos.form.field;
public class LargeTextEdit extends TextEdit implements ICloseCallBack{
```
### 5.1.2 控件方法清单
LargeTextEdit增加的方法:
| 方法 | 说明 |
| --- | --- |
| getTagFieldKey | 在数据模型中,存储大文本详情的属性名 |
## 5.2 数据模型
大文本字段运行时,表单主实体模型会创建两个属性对象,类型为LargeTextProp、TextProp,分别存储摘要信息、大文本详情,字段值都是String类型;
摘要信息的属性对象标识,就是大文本字段标识;
* 大文本详情属性对象标识,默认为大文本字段标识+”_tag”;
* 大文本详情的物理字段名,默认为大文本物理字段名+”_tag”;
插件可以通过大文本字段的控件编程模型LargeTextEdit,获取详情属性名(getTagFieldKey)。
LargeTextProp派生自普通文本字段的属性对象TextProp:
```java
package kd.bos.entity.property;
public class LargeTextProp