1 插件介绍

大文本字段，可以录入信息摘要，及不限长度的大文本内容。

图1：运行时，录入摘要

图2：运行时，录入详情

2 控件编程模型

2.1 控件编程模型定义

大文本字段的控件编程模型是LargeTextEdit，派生自文本字段的控件编程模型TextEdit。

package kd.bos.form.field;
public class LargeTextEdit extends TextEdit implements ICloseCallBack{

2.2 控件方法清单

LargeTextEdit增加的方法：

3 数据模型

大文本字段，在运行时表单主实体模型中，会创建两个属性对象，分别存储摘要信息（LargeTextProp）、大文本详情（TextProp），字段值，都是String类型；

摘要信息的属性对象标识，就是大文本字段标识；

• 大文本详情属性对象标识，默认为大文本字段标识+”_tag”;

• 大文本详情的物理字段名，默认为大文本物理字段名+”_tag”;

插件可以通过大文本字段的控件编程模型LargeTextEdit，获取详情属性名(getTagFieldKey)。

LargeTextProp，派生自普通文本字段的属性对象TextProp：

package kd.bos.entity.property;
public class LargeTextProp extends TextProp {

如下示例，演示了如何给大文本字段赋值、取值：

package kd.bos.plugin.sample.dynamicform.pcform.field.bizcase;
 
import kd.bos.form.field.LargeTextEdit;
import kd.bos.form.plugin.AbstractFormPlugin;
 
public class LargeTextFieldSample extends AbstractFormPlugin {
 
       private final static String KEY_HEADLARGETEXT = "headlargetext";
 
       /**
        * 演示如何存取字段值，只演示了存取单据头字段值
        */
       private void demoFieldValue(){
 
              // 需要通过如下方式，获取大文本详情属性名
              LargeTextEdit largeTextEdit = this.getView().getControl(KEY_HEADLARGETEXT);
              String tagPropName = largeTextEdit.getTagFieldKey();
 
              // 获取单据头大文本的摘要、详情
              String largeText = (String) this.getModel().getValue(KEY_HEADLARGETEXT);
              String largeTextTag = (String) this.getModel().getValue(tagPropName);
 
              // 赋值
              this.getModel().setValue(KEY_HEADLARGETEXT, largeText);   // 摘要
              this.getModel().setValue(tagPropName, largeTextTag);  // 详情
       }
}

4 插件事件

大文本字段，继承了字段值改变事件，未增加其他插件事件。

说明：
大文本字段，在数据模型中两个属性对象：摘要、详情；这两个属性值改变时，均会触发插件事件，插件需要注意区分。