【应用场景】

在界面上显示并使用私有下拉列表控件。

【案例演示】

采购订单，新增私有下拉列表字段，显示枚举值。

【实现步骤】

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

using Kingdee.BOS.Core.DynamicForm.PlugIn;

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

using Kingdee.BOS.Core.Metadata.FieldElement;

using Kingdee.BOS.Orm.DataEntity;

using Kingdee.BOS.Util;

using System;

using System.ComponentModel;

using System.Linq;

namespace Jac.XkDemo.BOS.Business.PlugIn

{

    /// <summary>

    /// 【表单插件】私有下拉列表

    /// </summary>

    [Description("【表单插件】私有下拉列表"), HotUpdate]

    public class PrivateComboFieldFormPlugIn : AbstractDynamicFormPlugIn

    {

        public override void BarItemClick(BarItemClickEventArgs e)

        {

            base.BarItemClick(e);

            if (e.BarItemKey.Equals("tbShowItems", StringComparison.OrdinalIgnoreCase))

            {

                // 显示私有下拉列表的所有下拉项

                var comboField = this.View.BillBusinessInfo.GetField("F_Jac_PrivateCombo") as PrivateComboField;

                if (comboField == null)

                {

                    return;

                }

                var enumItems = comboField.EnumObject["Items"] as DynamicObjectCollection;

                if (enumItems == null)

                {

                    return;

                }

                var msg = string.Join(",", enumItems.Select(o => string.Format("{0}:{1}", o["Caption"], o["Value"])));

                this.View.ShowMessage(msg);

            }

            if (e.BarItemKey.Equals("tbGetValue", StringComparison.OrdinalIgnoreCase))

            {

                // 获取下拉项

                var val = this.Model.GetValue("F_Jac_PrivateCombo").ToString();

                this.View.ShowMessage(val);

            }

            if (e.BarItemKey.Equals("tbSetValue", StringComparison.OrdinalIgnoreCase))

            {

                // 设置下拉项，将当前下拉列表的选中项设置为【自定义】

                this.Model.SetValue("F_Jac_PrivateCombo", "5");

                this.View.ShowMessage("下拉项已设置为【自定义】");

            }

        }

    }

}

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

<3>BOSIDE扩展采购订单，添加一个私有下拉列表字段，添加菜单子项，注册表单插件，保存元数据，开发完毕。

【功能验证】

现在可以登录业务站点，打开采购订单编辑界面，尝试使用一下私有下拉列表控件啦。

下拉列表和私有下拉列表的枚举项是隔离的，如下图所示，虽然两个下拉字段的枚举类型都是绑定的【发货状态】，但是私有下拉列表字段里新增的枚举项只有私有下拉列表字段自己可见，不会影响到下拉列表字段的枚举项。

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

【金蝶云星空BOS二次开发案例演示】https://vip.kingdee.com/article/94751030918525696