【应用场景】

单据录入时，当检测到字段数据非法时，即时提醒用户，禁止切换输入焦点，直到用户录入正确的数据后，才允许将输入焦点移开。

【案例演示】

采购订单，新增单据头文本字段和单据体文本字段，并进行数据合法性的即时校验，如果输入的数据不是英文字母，禁止切换输入焦点，即使强行切换到别的字段，焦点也会跳回来。

【实现步骤】

<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.Collections.Generic;
using System.ComponentModel;
using System.Text.RegularExpressions;
namespace Jac.XkDemo.BOS.Business.PlugIn
{
    /// <summary>
    /// 【表单插件】字段数据非法时禁止切换输入焦点
    /// </summary>
    [Description("【表单插件】字段数据非法时禁止切换输入焦点"), HotUpdate]
    public class FieldSetFocusFormPlugIn : AbstractDynamicFormPlugIn
    {
        /// <summary>
        /// 需要做数据合法性即时校验的字段的标识集合
        /// </summary>
        private HashSet<string> needCheckFieldKeys = new HashSet<string>(new[] { "F_Jac_Text", "F_Jac_Text1" }, StringComparer.OrdinalIgnoreCase);
        /// <summary>
        /// 字典变量，用于存储字段的数据合法性的校验结果
        /// </summary>
        private Dictionary<string, bool> fieldValueValidate = new Dictionary<string, bool>(StringComparer.OrdinalIgnoreCase);
        public override void DataChanged(DataChangedEventArgs e)
        {
            base.DataChanged(e);
            if (e.Field.Key.EqualsIgnoreCase("F_Jac_Text") || e.Field.Key.EqualsIgnoreCase("F_Jac_Text1"))
            {
                var isValidate = IsCharacter(e.NewValue as string);
                fieldValueValidate[e.Field.Key + "_" + e.Row] = isValidate;
            }
        }
        public override void FieldEditorFocued(FieldEditorFocuedEventArgs e)
        {
            base.FieldEditorFocued(e);
            if (needCheckFieldKeys.Contains(e.OldFieldKey) || !needCheckFieldKeys.Contains(e.NewFieldKey))
            {
                var key = e.OldFieldKey + "_0";
                if (fieldValueValidate.ContainsKey(key) && !fieldValueValidate[key])
                {
                    // 焦点切换前的字段的数据校验未通过，焦点退回去
                    var field = this.View.BillBusinessInfo.GetField(e.OldFieldKey);
                    this.View.ShowMessage(string.Format("字段{0}输入的数据非法，请重新输入！", field.Name));
                    //this.View.ShowErrMessage(string.Format("字段{0}输入的数据非法，请重新输入！", field.Name));// 无法搭配SetFocus使用
                    //this.View.ShowWarnningMessage(string.Format("字段{0}输入的数据非法，请重新输入！", field.Name));// 无法搭配SetFocus使用
                    this.View.GetControl(e.OldFieldKey).SetFocus();
                }
            }
        }
        public override void EntryCellFocued(EntryCellFocuedEventArgs e)
        {
            base.EntryCellFocued(e);
            if (needCheckFieldKeys.Contains(e.OldFieldKey) || !needCheckFieldKeys.Contains(e.NewFieldKey))
            {
                var key = e.OldFieldKey + "_" + e.OldRow;
                if (fieldValueValidate.ContainsKey(key) && !fieldValueValidate[key])
                {
                    // 焦点切换前的字段的数据校验未通过，焦点退回去
                    var field = this.View.BillBusinessInfo.GetField(e.OldFieldKey);
                    this.View.ShowMessage(string.Format("字段{0}输入的数据非法，请重新输入！", field.Name));// 可以搭配SetFocus使用
                    //this.View.ShowErrMessage(string.Format("字段{0}输入的数据非法，请重新输入！", field.Name));// 无法搭配SetFocus使用
                    //this.View.ShowWarnningMessage(string.Format("字段{0}输入的数据非法，请重新输入！", field.Name));// 无法搭配SetFocus使用
                    if (e.OldRow != e.NewRow)
                    {
                        this.View.GetControl<EntryGrid>(field.EntityKey).SetFocusRowIndex(e.OldRow);
                    }
                    this.View.GetControl(e.OldFieldKey).SetFocus();
                }
            }
        }
        /// <summary>
        /// 判断输入内容是否是英文字母
        /// </summary>
        /// <param name="input"></param>
        /// <returns></returns>
        private bool IsCharacter(string input)
        {
            if (string.IsNullOrWhiteSpace(input))
            {
                return false;
            }
            var pattern = "^[A-Za-z]*$";
            var isMatch = Regex.IsMatch(input, pattern, RegexOptions.Compiled);
            return isMatch;
        }
    }
}

【注意】

从测试结果看，ShowErrMessage和ShowWarnningMessage都是模式窗体，锁住了主界面，消息界面关闭后，并不能按插件发送的指令正常切换焦点，因此其无法和SetFocus搭配使用，如果您想要向界面输出信息，目前只能用ShowMessage。

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

<3>BOSIDE扩展采购订单，新增单据头文本字段和单据体文本字段，都开启即时触发更新事件属性，注册表单插件，保存元数据，开发完毕。

【功能验证】

<1>登录业务站点，打开采购订单编辑界面，在文本字段上录入数字，此时不管用户怎么切换输入焦点，都会被强制切换回来。

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

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