/// <summary>
    /// 掃描槍鍵盤輸入檢測類
    /// </summary>
    public class ScanningGunMonitor
    {
        #region 內部成員
        Timer _Timer = new Timer();//計時器
        DateTime _TickTime=DateTime.MinValue;//記錄前一次按鍵周期的時間
        string _TempText=string.Empty;//控件文本副本
        object _Sender;//保存外部控件源，用于發送事件時傳回
        #endregion

        #region 事件
        /// <summary>
        /// 輸入超時委托
        /// </summary>
        /// <param name="Sender">來源</param>
        public delegate void InputTimeOut(object Sender);
        /// <summary>
        /// 輸入超時事件委托對象
        /// </summary>
        public event InputTimeOut OnInputTimeOut;
        /// <summary>
        /// 發送輸入超時事件
        /// </summary>
        private void SendInputTimeOutEvent()
        {
            if (OnInputTimeOut != null)
                OnInputTimeOut(_Sender);
        }
        #endregion

        #region 構造函數
        /// <summary>
        /// 構造函數
        /// </summary>
        public ScanningGunMonitor()
        {
            _Timer.Elapsed+=Timer_Elapsed;//內置事件對象綁定觸發事件方法
        }
        #endregion

        #region 屬性

        #region 條碼最小長度
        int _MiniLength = 20;
        /// <summary>
        /// 讀取或設置條碼最小長度值，當超過一個時鐘周期后，如果條碼文本不符合最小長度則被丟棄。
        /// </summary>
        public int MiniLength
        {
            get { return _MiniLength; }
            set { _MiniLength = value; }
        } 
        #endregion

        #region 按鍵間隔超時限定值
        int _TimeOut=100;
        /// <summary>
        /// 讀取或設置按鍵間隔超時限定值
        /// </summary>
        public int TimeOut
        {
            get { return _TimeOut; }
            set { _TimeOut = value; }
        }
        #endregion

        #region 時鐘周期
        int _ClockTick = 100;
        /// <summary>
        /// 讀取或設置內置時鐘周期
        /// </summary>
        public int ClockTick
        {
            get { return _ClockTick; }
            set { _ClockTick = value; }
        }
        #endregion

        #endregion
        
        #region 方法
        /// <summary>
        /// 當發生按鍵時檢查條碼文本是否超時(開啟內置時鐘)
        /// </summary>
        /// <param name="sender">發送控件</param>
        /// <param name="inputText">條碼文本</param>
        /// <returns>有效按鍵標志</returns>
        public bool CheckKeyPress(object sender,string inputText)
        {
            int gap;
            _Sender = sender;
            DateTime thisTime = DateTime.Now;
            gap = thisTime.Subtract(_TickTime).Milliseconds;
            if (_TickTime == DateTime.MinValue)//第一次
            {
                _Timer.Interval = _ClockTick;
                _Timer.Enabled = true;//開啟時鐘
                SendInputTimeOutEvent();//發送輸入超時事件
                return true;//保留當前輸入字符
            }
            else
            {
                if (gap > _TimeOut) 
                {
                    StopCheckGap();//停止檢查輸入間隔
                    _TempText = "";//清空本地文本
                    SendInputTimeOutEvent();//發送輸入超時事件
                    return false; //通知取消當前輸入
                }
            }
            _TickTime = thisTime;//保存時間現場，用于下一周期判斷依據
            _TempText = inputText;//保存文本，提供時鐘事件判斷依據
            return true;//保留當前輸入
        }
        /// <summary>
        /// 停止檢測時間間隔，重置狀態，停止內置時鐘
        /// </summary>
        private void StopCheckGap()
        {
            _TickTime= DateTime.MinValue;
            _Timer.Enabled = false;
        }
        /// <summary>
        /// 時鐘事件方法
        /// </summary>
        /// <param name="sender">發送者</param>
        /// <param name="e">事件對象</param>
        private void Timer_Elapsed(object sender,ElapsedEventArgs e)
        {
            int gap = e.SignalTime.Subtract(_TickTime).Milliseconds;
            if (gap > _TimeOut)
            {
                StopCheckGap();//停止檢測,可能是掃描槍掃描結束，也可能是手工輸入間隔
                if (_TempText.Length < _MiniLength)//進一步檢查長度，如果較短，說明為手工輸入
                {
                    _TempText = "";//清空本地文本
                    SendInputTimeOutEvent();//發送輸入超時事件
                }
            }
            
        }
        #endregion
    }