本文主要介绍WPF应用对鼠标输入、触摸屏触笔以及触摸事件的封装
之前有简单说明设备输入类型 WPF 屏幕点击的设备类型 - 唐宋元明清2188
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<Point>(() => e.GetPosition(_element)),
PointsLazy = new Lazy<StylusPointCollection>(() => 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)
关键字:鼠标、触笔、触摸
作者:唐宋元明清2188