# 1 功能介绍 员工头像属性字段，派生自基础资料属性字段，必须与用户字段，创建人等人员相关的基础资料绑定，显示用户的头像。 # 2 控件对象 `kd.bos.form.field.UserAvatarEdit` # 3 视觉展示  # 4 属性说明 ## 4.1 通用属性 >通用属性包含字段和控件的一些公有的属性，如宽高，帮助文本等等。请参考[通用属性](https://vip.kingdee.com/article/215559076720798976) ## 4.2 样式属性 >样式属性是每个控件在设计器右侧样式栏可以设置的属性，请参考[样式属性](https://vip.kingdee.com/article/252017936767406336) ## 4.3 业务属性 | 属性名 | 类型 | 默认值 | 说明 | | --- | --- | --- | --- | | 基础资料字段 | 下拉 | - | 配置关联的用户字段，只能选择用户、创建人、修改人这种，不能选择一般的基础资料 | # 5 员工头像属性接口介绍 ## 5.1 控件编程模型 ### 5.1.1 控件编程模型定义 员工头像属性字段，控件编程模型为UserAvatarEdit，派生自基础资料属性字段控件编程模型BasedataPropEdit： ```java package kd.bos.form.field; public class UserAvatarEdit extends BasedataPropEdit { ``` ### 5.1.2 控件方法清单 重写、新增了如下方法： | 方法 | 说明 | | --- | --- | | addClickListener | 监听点击事件 | | addItemClickListener | 暂无效果 | | click | 用户点击头像时，系统自动调用此方法：
触发插件点击事件，打开云之家沟通工具 | ## 5.2 数据模型 员工头像属性字段，数据来自用户字段，在数据模型中不单独存储。 ## 5.3 插件事件 员工头像属性字段，支持点击事件，不支持字段值更新事件： | 方法 | 说明 | | --- | --- | | [beforeClick](https://vip.kingdee.com/article/228984722725409536) | 用户点击用户头像时，触发此事件 | | [click](https://vip.kingdee.com/article/228985226008129024) | 用户点击用户头像时，触发此事件 | 系统内置响应了字段的点击事件，默认打开云之家，与目标用户进行沟通。 插件可以捕获点击事件，对此进行干预。 ### 5.3.1 beforeClick事件 * 事件介绍 插件可以在此事件，取消后续处理。 * 事件触发时机 用户点击头像时，触发此事件。 * 代码模板 ```java package kd.bos.plugin.sample.dynamicform.pcform.field.template; import java.util.EventObject; import kd.bos.dataentity.utils.StringUtils; import kd.bos.form.control.Control; import kd.bos.form.control.events.BeforeClickEvent; import kd.bos.form.plugin.AbstractFormPlugin; public class UserAvatarBeforeClick extends AbstractFormPlugin { private final static String KEY_USERAVATARFIELD1 = "useravatarfield1"; @Override public void registerListener(EventObject e) { super.registerListener(e); // 侦听用户头像点击事件 this.addClickListeners(KEY_USERAVATARFIELD1); } @Override public void beforeClick(BeforeClickEvent evt) { super.beforeClick(evt); Control source = (Control)evt.getSource(); if (StringUtils.equals(KEY_USERAVATARFIELD1, source.getKey())){ // TODO 在此添加业务逻辑 } } } ``` * 事件参数 ```java public class BeforeClickEvent extends ClickEvent： public Object getSource()：事件源，用户头像控件编程模型 public void setCancel(boolean cancel)：取消后续处理 ``` ### 5.3.2 Click事件 * 事件介绍 此事件触发时，已经下达了打开云之家沟通工具的指令，不能在此事件取消沟通工具；插件可以在此事件，进行其他逻辑处理。 * 事件触发时机 用户点击头像时，触发此事件。 * 代码模板 ```java package kd.bos.plugin.sample.dynamicform.pcform.field.template; import java.util.EventObject; import kd.bos.dataentity.utils.StringUtils; import kd.bos.form.control.Control; import kd.bos.form.plugin.AbstractFormPlugin; public class UserAvatarClick extends AbstractFormPlugin { private final static String KEY_USERAVATARFIELD1 = "useravatarfield1"; @Override public void registerListener(EventObject e) { super.registerListener(e); // 侦听用户头像点击事件 this.addClickListeners(KEY_USERAVATARFIELD1); } @Override public void click(EventObject evt) { super.click(evt); Control source = (Control)evt.getSource(); if (StringUtils.equals(KEY_USERAVATARFIELD1, source.getKey())){ // TODO 在此添加业务逻辑 } } } ``` * 事件参数 ```java public class EventObject implements java.io.Serializable： public Object getSource()：事件源，字段的控件编程模型 ```