【应用场景】

表单界面上可以使用按钮触发点击事件到服务端进行业务逻辑处理。

【案例演示】

采购订单，新增一个按钮，演示按钮点击事件，以及如何插件控制该按钮。

【实现步骤】

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

using Kingdee.BOS.Core.DynamicForm.PlugIn;
using Kingdee.BOS.Core.DynamicForm.PlugIn.Args;
using Kingdee.BOS.Core.DynamicForm.PlugIn.ControlModel;
using Kingdee.BOS.Util;
using System;
using System.ComponentModel;
namespace Jac.XkDemo.BOS.Business.PlugIn
{
    /// <summary>
    /// 【表单插件】按钮
    /// </summary>
    [Description("【表单插件】按钮"), HotUpdate]
    public class ButtonFormPlugIn : AbstractDynamicFormPlugIn
    {
        const string ButtonKey = "F_Jac_Button";
        /// <summary>
        /// 菜单点击事件
        /// </summary>
        /// <param name="e"></param>
        public override void BarItemClick(BarItemClickEventArgs e)
        {
            base.BarItemClick(e);
            if (e.BarItemKey.Equals("tbEnable", StringComparison.OrdinalIgnoreCase))
            {
                // 启用
                this.View.GetControl(ButtonKey).Enabled = true;
                return;
            }
            else if (e.BarItemKey.Equals("tbDisable", StringComparison.OrdinalIgnoreCase))
            {
                //禁用
                this.View.GetControl(ButtonKey).Enabled = false;
                return;
            }
            else if (e.BarItemKey.Equals("tbVisible", StringComparison.OrdinalIgnoreCase))
            {
                // 显示
                this.View.GetControl(ButtonKey).Visible = true;
                return;
            }
            else if (e.BarItemKey.Equals("tbInVisible", StringComparison.OrdinalIgnoreCase))
            {
                // 隐藏
                this.View.GetControl(ButtonKey).Visible = false;
                return;
            }
            else if (e.BarItemKey.Equals("tbSetBackColor", StringComparison.OrdinalIgnoreCase))
            {
                // 设置背景色
                // 目前支持的样式值为2~13，具体效果可自行测试
                this.View.GetControl(ButtonKey).SetCustomPropertyValue("Style", "6");
                // 目前尚未支持自定义背景色，希望未来版本可以支持
                this.View.GetControl(ButtonKey).SetCustomPropertyValue("BackColor", "#80FFFF");
                return;
            }
            else if (e.BarItemKey.Equals("tbSetForeColor", StringComparison.OrdinalIgnoreCase))
            {
                // 设置前景色
                this.View.GetControl(ButtonKey).SetCustomPropertyValue("ForeColor", "#FF0000");
                return;
            }
        }
        /// <summary>
        /// 按钮点击事件
        /// </summary>
        /// <param name="e"></param>
        public override void ButtonClick(ButtonClickEventArgs e)
        {
            base.ButtonClick(e);
            if (e.Key.Equals(ButtonKey, StringComparison.OrdinalIgnoreCase))
            {
                this.View.ShowMessage(string.Format("【{0}[{1}]】被点击啦！", this.View.GetControl<Button>(ButtonKey).Text, e.Key));
                return;
            }
        }
    }
}

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

<3>BOSIDE扩展采购订单，新增一个按钮，菜单集合新增6个菜单项，注册表单插件，保存元数据，开发完毕。

【功能验证】

<1>登录业务站点，打开采购订单新增界面，验证按钮点击事件，设置按钮显示隐藏，禁用启用，前景色和背景色。

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

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