支持触控板输入事件
=========

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/c0/v3/OILiewVzSimTVHvzALWLGg/zh-cn_image_0000002625187511.png?HW-CC-KV=V1&HW-CC-Date=20260612T073309Z&HW-CC-Expire=86400&HW-CC-Sign=3615B0131EDF8B6E4836A17A7D34D8FCD5F1025F98E20C5297C895AEFA2727CB)

当用户使用触控板时，会根据不同的操作方式生成相应的事件。单指点触会产生鼠标左键点击事件，单指轻触移动会产生不按键的鼠标移动事件；双指点触会产生鼠标右键点击事件，双指轻触移动会产生轴事件。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/36/v3/I1qEJ6XWRnu8isO__WFUBQ/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073309Z&HW-CC-Expire=86400&HW-CC-Sign=D461EE366569E00C7CB0DF9AF833BC8B47A72C1B6C27B3E658C0DB540E9F99F1)

需要注意的是，与触屏不同，触控板上的多指操作并不会体现在上报的事件中，应用无法获取手指信息。

#### 单指操作

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/17/v3/TeddQkilRz2doleomDcLOw/zh-cn_image_0000002625107655.png?HW-CC-KV=V1&HW-CC-Date=20260612T073309Z&HW-CC-Expire=86400&HW-CC-Sign=A34C5179D9CBA76215C997AF83007047252EB3758D6F01C497B81CDF298DEABB)

单指操作触控板与操作鼠标的方式相同。例如，轻触后滑动会产生鼠标移动事件，而重按则会产生鼠标左键按下事件。若需判断鼠标事件是来自触控板还是鼠标设备，可以通过[sourceType](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-gesture-settings#sourcetype枚举说明8)和[sourceTool](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-gesture-settings#sourcetool枚举说明9)信息进行区分。

对该种操作产生的事件的处理，请参考[处理鼠标移动](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkts-interaction-development-guide-mouse#处理鼠标移动)章节。

#### 双指滑动

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/6a/v3/YpT8ckIeTZaG69zjTVpv3w/zh-cn_image_0000002594668138.png?HW-CC-KV=V1&HW-CC-Date=20260612T073309Z&HW-CC-Expire=86400&HW-CC-Sign=3B9B4BD2CF2AB3F8ECC3C65A2473C8E26069C4B4D2E1294C7330945EC3D84EE7)

与鼠标滚轮不同，触控板上双指滑动产生的轴事件上报的数值单位并非角度，而是位移像素，为了区分该点，在处理轴值之前，可以通过sourceType及sourceTool来区分。

当用户使用双指横滑时，可从[axisHorizontal](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-gesture-customize-judge#属性)中获取横向轴值（位移像素），向右滑动时，上报数值为负，向左滑动时，上报数值为正。使用双指竖滑时，可从[axisVertical](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-gesture-customize-judge#属性)获取到纵向轴值（位移像素），向上滑动时，上报数值为正，向下滑动时，上报数值为负。

同滚轮一样，产生的轴事件可以驱动滑动手势的触发。向右滑动时，上报offsetX数值为正，向左滑动时，上报offsetX数值为负。向上滑动时，上报offsetY数值为负，向下滑动时，上报offsetY数值为正。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/10/v3/BJQOxymeQCSGhX9zF_9hoA/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073309Z&HW-CC-Expire=86400&HW-CC-Sign=8686D8F6CB1217EEA3097F89F2A18CB165264EB2863DC2F213A58C818B2371D2)

只有在开始滚动操作的那一刻光标所在位置下的组件上的手势会被收集。

#### 双指捏合

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/28/v3/TcibEgzbSB6Pzm3G25hpVQ/zh-cn_image_0000002594828066.png?HW-CC-KV=V1&HW-CC-Date=20260612T073309Z&HW-CC-Expire=86400&HW-CC-Sign=8C8705128048037C00586E7E2D808AF9CA6CFE9D27B9386B538377583E72387E)

在触控板上通过双指捏合，可以产生捏合缩放值上报。该值表示一个相对缩放比例，可用于实现UI缩放效果。系统上报的数值为一个scale比例，其以双指开始捏合的那一刻（此时为1.0）为基准参考。当双指往外扩张时，scale逐渐从1.0增大；当双指往内合并时，scale逐渐减小。