1 插件介绍

字段是特殊的控件，用来显示、录入数据。相对于普通控件，字段除了具有控件编程模型外，还有数据模型。

系统根据数据类型、录入方式的差异，封装了一批常用字段；另外，还针对一些特殊的业务逻辑，封装了一批业务字段。

系统封装的所有的字段，都派生自字段基类Field，本节介绍字段基类的功能特点，各种具体的字段类型继承这些功能。具体各个控件字段的插件介绍请参考控件使用指南。

2 控件编程模型

2.1 控件编程模型定义

字段基类的控件编程模型为FieldEdit，派生自控件基类Control；各种具体字段的控件编程模型，均从此派生：

package kd.bos.form.field;
public class FieldEdit extends Control

插件可以使用如下代码，获取到字段控件实例，实现对前端界面上字段的控制：

private FieldEdit getFieldEdit(String key){
return this.getView().getControl(key);
}

2.2 控件方法清单

字段控件FieldEdit，继承了控件基类Control的全部方法，并添加如下新方法：

3 数据模型

3.1 属性对象

在保存表单设计时，会把字段，转为表单主实体模型中的属性对象，即运行时字段元数据。

常用字段的属性对象，都派生自FieldProp，基础资料字段的属性对象，不是派生自FieldProp。

FieldProp的定义如下：

package kd.bos.entity.property;
public class FieldProp extends DynamicSimpleProperty implements IFieldHandle, IValidatorHanlder {

字段属性对象基类FieldProp提供的完整方法如下，派生的属性对象自动具有这些方法：

3.2 字段值

各种字段的值类型，会有不同。

给字段赋值，必须传入正确的值类型，否则会报转换错误。某些特殊字段，值类型进行了一定的兼容。

3.3 字段值存取方法

表单数据模型IDataModel提供了很多方法，能够设置表单、单据体、字段的数据。

其中与字段相关的方法如下：

4 插件事件

字段基类支持如下事件：