1# 触摸测试控制
2
3设置组件的触摸测试类型。ArkUI开发框架在处理触屏事件时，会在触屏事件触发前，进行按压点和组件区域的触摸测试来收集需要响应触屏事件的组件，然后基于触摸测试结果分发相应的触屏事件。hitTestBehavior属性可以设置不同的触摸测试响应模式，影响组件的触摸测试收集结果，最终影响后续的触屏事件分发，具体影响参考[HitTestMode](#hittestmode枚举说明)枚举说明。
4
5>  **说明：**
6>  - 从API Version 9开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
7>  - 当Stack组件中有多个节点触摸区域重叠时，如两个节点，默认只会对显示在最上层的节点做触摸测试，若需要显示在下层的节点触发触摸测试，请给显示在上层的节点设置hitTestBehavior为HitTestMode.Transparent。
8
9## hitTestBehavior
10
11hitTestBehavior(value: HitTestMode)
12
13设置组件的触摸测试类型。
14
15**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。
16
17**系统能力：** SystemCapability.ArkUI.ArkUI.Full
18
19**参数：**
20
21| 参数名            | 类型     | 必填                             | 说明                               |
22| -------------------- | -------- | ---------------------------------------- | ---------------------------------------- |
23| value | [HitTestMode](#hittestmode枚举说明) | 是 | 设置当前组件的触摸测试类型。<br>默认值： HitTestMode.Default |
24
25## HitTestMode枚举说明
26
27| 名称          | 枚举值    | 描述                                       |
28| ------------| ---------|----------------------------------- |
29| Default     | 0 |默认触摸测试效果，自身和子节点都响应触摸测试，但会阻塞兄弟节点的触摸测试。不会影响祖先节点的触摸测试。 |
30| Block       | 1 |自身响应触摸测试，阻塞子节点和兄弟节点的触摸测试。会阻塞祖先节点的触摸测试。 |
31| Transparent | 2 |自身和子节点都响应触摸测试，不会阻塞兄弟节点的触摸测试。不会影响祖先节点的触摸测试。 |
32| None        | 3 |自身不响应触摸测试，不会阻塞子节点和兄弟节点的触摸测试。不会影响祖先节点的触摸测试。 |
33
34
35## 示例
36
37该示例通过设置不同的HitTestMode值演示了Block和Transparent的触摸类型效果。
38
39```ts
40// xxx.ets
41@Entry
42@Component
43struct HitTestBehaviorExample {
44  build() {
45    // outer stack
46    Stack() {
47      Button('outer button')
48        .onTouch((event) => {
49          console.info('outer button touched type: ' + (event as TouchEvent).type)
50        })
51      // inner stack
52      Stack() {
53        Button('inner button')
54          .onTouch((event) => {
55            console.info('inner button touched type: ' + (event as TouchEvent).type)
56          })
57      }
58      .width("100%").height("100%")
59      .hitTestBehavior(HitTestMode.Block)
60      .onTouch((event) => {
61        console.info('stack touched type: ' + (event as TouchEvent).type)
62      })
63
64      Text('Transparent')
65        .hitTestBehavior(HitTestMode.Transparent)
66        .width("100%").height("100%")
67        .onTouch((event) => {
68          console.info('text touched type: ' + (event as TouchEvent).type)
69        })
70    }.width(300).height(300)
71  }
72}
73```