【应用场景】

基于元数据构建控件属性包的过程中，动态设置控件属性。

注意：表单构建插件只能修改已有控件的属性，不能创建新控件，且此插件受前端缓存影响，不会每次打开界面时都触发，只有在当前页面元数据，在前端的缓存失效时，服务端才会触发表单构建插件的相应事件。

【案例演示】

采购订单，新增界面，设置明细信息单据体显示过滤行，将文本控件改为多行文本控件。

【实现步骤】

<1>编写表单构建插件，代码如下。

using Kingdee.BOS.Core.DynamicForm.PlugIn;

using Kingdee.BOS.Core.DynamicForm.PlugIn.Args;

using Kingdee.BOS.Util;

using System.ComponentModel;

namespace Jac.XkDemo.BOS.Business.PlugIn

{

    /// <summary>

    /// 【构建插件】设置控件属性

    /// </summary>

    [Description("【构建插件】设置控件属性"), HotUpdate]

    public class SetControlPropertyFormBuilderPlugIn : AbstractDynamicWebFormBuilderPlugIn

    {

        public override void CreateControl(CreateControlEventArgs e)

        {

            base.CreateControl(e);

            if (e.ControlAppearance.Key.EqualsIgnoreCase("FPOOrderEntry"))

            {

                // 设置采购明细单据体显示过滤行

                e.Control.Put("showFilterRow", true);

            }

            if (e.ControlAppearance.Key.EqualsIgnoreCase("F_Jac_Text"))

            {

                // 将文本控件改为多行文本控件

                var item = e.Control["item"] as JSONObject;

                if (item != null)

                {

                    item["xtype"] = "kdtextarea"; // textfield->kdtextarea

                }

                // 调整控件高度

                e.Control.Put("height", 50);

            }

        }

    }

}

<2>拷贝插件组件到应用站点的WebSite\Bin目录下，重启IIS。

<3>BOSIDE扩展采购订单，添加一个文本字段，注册表单构建插件，保存元数据，开发完毕。

现在可以登录业务站点，打开采购订单新增界面，检验一下插件效果啦。

---------------------------------------------------------------------------------------------------------

【金蝶云星空BOS二次开发案例演示】