# 变更记录 | 产品版本 | 更新内容 | 更新日期 | | --- | --- | --- | | V7.0.1 | 更新了数值字段属性，用户可通过"格式化"属性来设置数值的展示格式 | 2024-10-24 | # 1 功能介绍 用于录入小数数据。结合 *字段布局面板 *控件使用，布局体验最佳。 # 2 控件对象 `kd.bos.form.field.DecimalEdit` # 3 视觉展示  # 4 属性说明 ## 4.1 通用属性 >通用属性包含字段和控件的一些公有的属性，如宽高，帮助文本等。请参考[通用属性](https://vip.kingdee.com/article/215559076720798976) ## 4.2 样式属性 >样式属性是每个控件在设计器右侧样式栏可以设置的属性，请参考[样式属性](https://vip.kingdee.com/article/252017936767406336) ## 4.3 业务属性 | 属性名 | 类型 | 默认值 | 说明 | 支持版本 | | --- | --- | --- | --- | --- | | 不显示尾零 | 复选框 | false | 勾选后，若末位小数为0，则不展示 | | | 格式化 | 下拉 | - | 设置数值编辑完成之后的显示，控制数值的显示格式，包括分隔符和百分号的控制，详情见4.3.1 | V7.0.1 | | 掩码 | 下拉 | - | 设置数值编辑完成之后的显示，控制数值的显示格式，包括分隔符和百分号的控制 | V7.0.1以后不再支持该属性，可使用格式化属性 | | 格式化字符串 | 文本 | - | 设置数值编辑完成之后的显示，控制数值的显示格式，包括分隔符和百分号的控制，优先级高于掩码 | V7.0.1以后不再支持该属性，可使用格式化属性 | | 缺省值 | 小数 | - | 设置默认显示的值 | | | 整体精度 | 整数 | 23 | 数值总长度，控制整数部分和小数部分的精度 | | | 小数精度 | 整数 | 20 | 设置小数部分的精度，设置后整数部分精度为整体精度减去小数精度 | | | 数值范围 | 文本 | - | 设置数据可输入范围，例：[0,99] (0,99)，详情见4.3.3 | | | 为零显示 | 复选框 | false | 未勾选不允许存入空值；勾选允许存入空值 | | | 允许为空 | 复选框 | false | 未勾选不允许存入空值，缺省值为0；勾选允许存入空值，缺省值为null | | | 加密存储 | 复选框 | false | 设置文本是否加密存储 | | ### 4.3.1 格式化 在V7.0.1版本后，将原来的“掩码”以及“格式化字符串“属性合并为“格式化”属性，用于设置数值的显示格式。 在输入框编辑完内容，输入框失焦后。根据设置的内容格式进行格式化显示。支持输入的格式包括： |格式说明符|属性|说明|示例| |-|-|-|-| |“0”|零占位符|用于小数位，用对应的数字替换零；否则，将在结果字符串中显示零。|0.123（“0.00”）-> 0.12
0.1（“0.00”）-> 0.10| |“#”|数字占位符|用对应的数字替换“#”符号；否则，不会在结果字符串中显示任何数字。

请注意，若前面有固定数字，则会将固定数字复制到对应位置。|123.45（“###”）-> 123

45678（“12,###”）-> 12,678| |“.”|小数点|确定小数点分隔符在结果字符串中的位置。|0.123（“0.00”）-> 0.12| |“,”|组分隔符|在各个组插入本地化的组分隔符字符。|123456（“###,###”）-> 123,456| |“%”|百分比占位符|将数字乘以 100，并在结果字符串中插入百分比符号|0.1234（“0.00%”）-> 12.34%| ### 4.3.2 数值范围 用于设置数值的范围。支持输入的符号包括： * [ ：大于等于 * ] ：小于等于 * ( ：大于 * ) ：小于 如数值范围为大于1、小于等于10，则设置为 (1,10] # 5 小数接口介绍 ## 5.1 控件编程模型 ### 5.1.1 控件编程模型定义 小数字段的控件编程模型是DecimalEdit，派生自文本字段的控件编程模型TextEdit： ``` package kd.bos.form.field; public class DecimalEdit extends TextEdit { ``` ### 5.1.2 控件方法清单 DecimalEdit重写、新增的方法： | 方法 | 来源 | 说明 | | --- | --- | --- | | getControlPropName | 新增 | 获取精度控制字段标识；
小数字段的精度，可以在设计时设置，也可以在运行时，取其他字段值作为精度 | ## 5.2 数据模型 小数字段的属性对象类型为DecimalProp，派生自FieldProp，存储BigDecimal类型字段值： ``` package kd.bos.entity.property; public class DecimalProp extends FieldProp { ``` DecimalProp重写、新增的方法： | 方法 | 来源 | 说明 | | --- | --- | --- | | getControlPropName | 新增 | 精度控制字段的标识 | | getDataScope | 新增 | 数据范围 | | getDbType | 重写 | 物理字段类型，Types.DECIMAL | | getPrecision | 新增 | 整数位+小数位总长度，默认23 | | getPropertyType | 重写 | 字段值类型，BigDecimal.class | | getScale | 新增 | 小数位长度，默认10 | | getValueComparator | 重写 | 输出字段必录判断的匿名类：与BigDecimal.ZERO比较 | | isUseRegion | 新增 | 用户时区 | | setFieldValue | 重写 | 设置字段值，对传入的字段值进行必要的类型转换；
确保存储到数据模型中的字段值，是BigDecimal类型 | ### 5.3 插件事件 小数字段，继承了字段值改变事件，未增加其他插件事件。