西蒙少 发表于 2024-8-23 16:23:17

WPF 设备输入事件封装

本文主要介绍WPF应用对鼠标输入、触摸屏触笔以及触摸事件的封装
之前有简单说明设备输入类型 WPF 屏幕点击的设备类型 - 唐宋元明清2188 - 博客园 (cnblogs.com)
1、鼠标 - 通过Mouse相关的事件参数MouseButtonEventArgs中的数据,e.StylusDecice==null表示没有触摸设备,所以设备为鼠标
 2、触笔 or 触摸 - 根据StylusDown事件参数StylusDownEventArgs,e.StylusDevice.TabletDevice.Type == TabletDeviceType.Stylus,True表示触摸设备为触笔,False则为触摸。
通过上面设备类型的判断,就可以封装一套设备点击事件,DeviceDown、DeviceUp、DeviceMove。事件参数中添加设备类型DeviceType(鼠标、触笔、触摸),然后具体业务中可以通过设备类型区分相关的交互操作。
博客园有个小伙伴问我设备类型具体是如何封装的,那本文就补充下设备输入事件的封装使用,希望给大家提供一点帮助、省去你们磨代码的时间。
除了设备输入类型,输入事件也有多种状态。简单介绍下事件区分,具体以鼠标事件为例:
1   private void RegisterMouse()
2   {
3         //鼠标-冒泡
4         if (_element is Button button)
5         {
6             //Button类型的冒泡事件,被内部消化处理了,所以需要重新添加路由事件订阅
7             button.AddHandler(UIElement.MouseLeftButtonDownEvent, new MouseButtonEventHandler(Button_MouseLeftButtonDown), true);
8             button.AddHandler(UIElement.MouseRightButtonDownEvent, new MouseButtonEventHandler(Button_MouseRightButtonDown), true);
9             button.AddHandler(UIElement.MouseLeftButtonUpEvent, new MouseButtonEventHandler(Button_MouseLeftButtonUp), true);
10             button.AddHandler(UIElement.MouseRightButtonUpEvent, new MouseButtonEventHandler(Button_MouseRightButtonUp), true);
11         }
12         else
13         {
14             _element.MouseLeftButtonDown += Button_MouseLeftButtonDown;
15             _element.MouseRightButtonDown += Button_MouseRightButtonDown;
16             _element.MouseLeftButtonUp += Button_MouseLeftButtonUp;
17             _element.MouseRightButtonUp += Button_MouseRightButtonUp;
18         }
19         _element.MouseMove += Element_MouseMove;
20
21         //鼠标-隧道事件
22         _element.PreviewMouseLeftButtonDown += Button_PreviewMouseLeftButtonDown;
23         _element.PreviewMouseRightButtonDown += Button_PreviewMouseRightButtonDown;
24         _element.PreviewMouseLeftButtonUp += Button_PreviewMouseLeftButtonUp;
25         _element.PreviewMouseRightButtonUp += Button_PreviewMouseRightButtonUp;
26         _element.PreviewMouseMove += Element_PreviewMouseMove;
27   }上面区分了按钮与其它的FrameworkElement的鼠标事件,因为Button对冒泡事件是做了拦截再暴露Click事件,需要订阅路由事件来完成鼠标的监听。
如上方代码,对鼠标的左右键、按下抬起、移动以及冒泡隧道都做了完整的封装。
鼠标事件:
1   private void Element_MouseDown(MouseEventArgs e, int deviceId)
2   {
3         if (e.StylusDevice != null) return;
4         var positionLazy = new Lazy<Point>(() => e.GetPosition(_element));
5         var deviceInputArgs= new DeviceInputArgs()
6         {
7             DeviceId = deviceId,
8             DeviceType = DeviceType.Mouse,
9             PositionLazy = positionLazy,
10             PointsLazy = new Lazy<StylusPointCollection>(() =>
11             {
12               var point = positionLazy.Value;
13               return new StylusPointCollection(new List<StylusPoint>() { new StylusPoint(point.X, point.Y) });
14             }),
15             GetPositionFunc = (element, args) => e.GetPosition(element),
16             SourceArgs = e
17         };
18         _deviceDown?.Invoke(_element, deviceInputArgs);
19   }触摸面积获取:
1   /// <summary>
2   /// 获取含面积的触摸点集合
3   /// </summary>
4   /// <param name="stylusEventArgs"></param>
5   /// <param name="uiElement"></param>
6   /// <returns></returns>
7   public static Rect GetTouchPointArea(TouchEventArgs stylusEventArgs, UIElement uiElement)
8   {
9         Rect touchArea = Rect.Empty;
10         var touchPoints = stylusEventArgs.GetIntermediateTouchPoints(uiElement);
11         foreach (var stylusPoint in touchPoints)
12         {
13             var stylusPointArea = stylusPoint.Bounds;
14             touchArea.Union(stylusPointArea);
15         }
16         return touchArea;
17   }返回新的触笔输入点集:
1   /// <summary>
2   /// 获取触摸点集
3   /// </summary>
4   /// <param name="stylusEventArgs"></param>
5   /// <param name="element"></param>
6   /// <returns></returns>
7   private StylusPointCollection GetStylusPoints(StylusEventArgs stylusEventArgs, FrameworkElement element)
8   {
9         // 临时去除description
10         var pointCollection = new StylusPointCollection();
11         var stylusPointCollection = stylusEventArgs.GetStylusPoints(element);
12         foreach (var stylusPoint in stylusPointCollection)
13         {
14             pointCollection.Add(new StylusPoint(stylusPoint.X, stylusPoint.Y, stylusPoint.PressureFactor));
15         }
16         return pointCollection;
17   }这里是直接把StylusPoint.Description舍弃,防止在应用层未能统一好这个设备描述、导致异常。
当然这些获取信息根据业务需要来获取、此处设备事件封装不损耗处理延时,所以需要添加Lazy函数如:
PositionLazy = new Lazy(() => e.GetPosition(_element)),
PointsLazy = new Lazy(() => GetStylusPoints(e, _element)),
暴露的通用设备按下事件,可以看如下定义:
1   /// <summary>
2   /// 设备按下
3   /// </summary>
4   public event EventHandler<DeviceInputArgs> DeviceDown
5   {
6         add => _deviceDown.Add(value, value.Invoke);
7         remove => _deviceDown.Remove(value);
8   }UI控件订阅DeviceDown、DeviceMove、DeviceUp事件,从事件参数DeviceInputArgs获取详细数据:
1         /// <summary>
2         /// 设备ID
3         /// <para>默认为鼠标设备,鼠标左键-1,鼠标右键-2 </para>
4         /// </summary>
5         public int DeviceId { get; set; }
6         /// <summary>
7         /// 设备类型
8         /// </summary>
9         public DeviceType DeviceType { get; set; }
10
11         /// <summary>
12         /// 位置
13         /// </summary>
14         public Point Position
15         {
16             get => PositionLazy?.Value ?? default;
17             set => PositionLazy = new Lazy<Point>(() => value);
18         }
19
20         /// <summary>
21         /// 触笔点集
22         /// </summary>
23         public StylusPointCollection Points
24         {
25             get => PointsLazy?.Value;
26             set => PointsLazy = new Lazy<StylusPointCollection>(() => value);
27         }
28
29         /// <summary>
30         /// 获取相对元素的位置
31         /// </summary>
32         public Func<FrameworkElement, Point> GetPosition
33         {
34             get => relativeElement => GetPositionFunc(relativeElement, SourceArgs);
35             set => GetPositionFunc = (relativeElement, args) => value(relativeElement);
36         }
37
38         /// <summary>
39         /// 事件触发源数据
40         /// </summary>
41         public InputEventArgs SourceArgs { get; set; }
42
43         /// <summary>
44         /// 触摸面积
45         /// </summary>
46         public Rect TouchArea => TouchAreaLazy?.Value ?? Rect.Empty;DeviceInputArgs继承Windows路由事件参数类RoutedEventArgs
为何要封装通用事件?因为2点原因:
1. 大部分业务并不需要区分鼠标、触笔、触摸类型
2. 有些业务如白板书写、多指操作需要区分鼠标、触笔、触摸类型,这类场景因为操作事件订阅太多,业务逻辑搞复杂了
通过将鼠标、触笔、触摸事件封装为通用输入事件,下游应用业务对设备输入事件处理逻辑就简单化了。
封装Demo可详见:kybs00/DeviceInputEventDemo (github.com)
 
关键字:鼠标、触笔、触摸
出处:http://www.cnblogs.com/kybs0/本文版权归作者和博客园共有,欢迎转载,但未经作者同意必须在文章页面给出原文连接,否则保留追究法律责任的权利。
来源:https://www.cnblogs.com/kybs0/p/18325065
免责声明:由于采集信息均来自互联网,如果侵犯了您的权益,请联系我们【E-Mail:cb@itdo.tech】 我们会及时删除侵权内容,谢谢合作!
页: [1]
查看完整版本: WPF 设备输入事件封装