1# ArkUI_NodeTouchEvent 2 3 4## 概述 5 6定义Touch事件的结构类型。 7 8**起始版本:** 12 9 10**相关模块:**[ArkUI_NativeModule](_ark_u_i___native_module.md) 11 12 13## 汇总 14 15 16### 成员变量 17 18| 名称 | 描述 | 19| -------- | -------- | 20| [ArkUI_NodeTouchEventAction](_ark_u_i___native_module.md#arkui_nodetoucheventaction)[action](#action) | 触屏事件的类型。 | 21| int64_t [timeStamp](#timestamp) | 触屏事件时间戳,单位为微秒(us)。 | 22| [ArkUI_NodeTouchPoint](_ark_u_i___node_touch_point.md)[actionTouch](#actiontouch) | 当前触屏事件的触控点信息。 | 23| int32_t(\* [getTouches](#gettouches) )([ArkUI_NodeTouchPoint](_ark_u_i___node_touch_point.md) \*\*points) | 返回此事件发生时所有屏幕接触点信息。 | 24| int32_t(\* [getHistoricalPoints](#gethistoricalpoints) )([ArkUI_NodeHistoricalTouchPoint](_ark_u_i___node_historical_touch_point.md) \*\*historicalPoints) | 返回此事件中的历史点信息。这些是在此事件和上一个事件之间发生的运动。 | 25| [ArkUI_NodeSourceType](_ark_u_i___native_module.md#arkui_nodesourcetype)[sourceType](#sourcetype) | 触发事件来源的类型。 | 26| bool [stopPropagation](#stoppropagation) | 阻止事件进一步向父节点冒泡处理。 | 27| bool [preventDefault](#preventdefault) | 阻止当前节点的默认事件处理行为,允许事件进一步向上冒泡。 | 28 29 30## 结构体成员变量说明 31 32 33### action 34 35``` 36ArkUI_NodeTouchEventAction ArkUI_NodeTouchEvent::action 37``` 38**描述:** 39 40触屏事件的类型。 41 42 43### actionTouch 44 45``` 46ArkUI_NodeTouchPoint ArkUI_NodeTouchEvent::actionTouch 47``` 48**描述:** 49 50当前触屏事件的触控点信息。 51 52 53### getHistoricalPoints 54 55``` 56int32_t(* ArkUI_NodeTouchEvent::getHistoricalPoints) (ArkUI_NodeHistoricalTouchPoint **historicalPoints) 57``` 58**描述:** 59 60返回此事件中的历史点信息。这些是在此事件和上一个事件之间发生的运动。 61 62**参数:** 63 64| 名称 | 描述 | 65| -------- | -------- | 66| historicalPoints | 用来接受数据的指针对象。 | 67 68**返回:** 69 70历史点数据数组元素数量。 71 72**注解:** 73 74框架会在该函数调用时创建历史点数据数组的堆内存对象并返回指针,开发者需要在使用完成后调用delete[]手动释放内存。 75 76 77### getTouches 78 79``` 80int32_t(* ArkUI_NodeTouchEvent::getTouches) (ArkUI_NodeTouchPoint **points) 81``` 82**描述:** 83 84返回此事件发生时所有屏幕接触点信息。 85 86**参数:** 87 88| 名称 | 描述 | 89| -------- | -------- | 90| points | 用来接受数据的指针对象。 | 91 92**返回:** 93 94屏幕接触点数据数组元素数量。 95 96**注解:** 97 98ArkUI会在该函数调用时创建触控点信息数组的堆内存对象并返回指针,开发者需要在使用完成后调用delete[]手动释放内存。 99 100 101### preventDefault 102 103``` 104bool ArkUI_NodeTouchEvent::preventDefault 105``` 106**描述:** 107 108阻止当前节点的默认事件处理行为,允许事件进一步向上冒泡。 109 110 111### sourceType 112 113``` 114ArkUI_NodeSourceType ArkUI_NodeTouchEvent::sourceType 115``` 116**描述:** 117 118触发事件来源的类型。 119 120 121### stopPropagation 122 123``` 124bool ArkUI_NodeTouchEvent::stopPropagation 125``` 126**描述:** 127 128阻止事件进一步向父节点冒泡处理。 129 130 131### timeStamp 132 133``` 134int64_t ArkUI_NodeTouchEvent::timeStamp 135``` 136**描述:** 137 138触屏事件时间戳,单位为微秒(us)。 139