• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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