设置组件的触摸测试类型。ArkUI开发框架在处理触屏事件时,会在触屏事件触发前,进行按压点和组件区域的触摸测试来收集需要响应触屏事件的组件,然后基于触摸测试结果分发相应的触屏事件。hitTestBehavior属性可以设置不同的触摸测试响应模式,影响组件的触摸测试收集结果,最终影响后续的触屏事件分发,具体影响参考HitTestMode枚举说明。
说明:
- 从API Version 9开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
- 当Stack组件中有多个节点触摸区域重叠时,如两个节点,默认只会对显示在最上层的节点做触摸测试,若需要显示在下层的节点触发触摸测试,请给显示在上层的节点设置hitTestBehavior为HitTestMode.Transparent。
hitTestBehavior
hitTestBehavior(value: HitTestMode)
设置组件的触摸测试类型。
系统能力: SystemCapability.ArkUI.ArkUI.Full
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
value | HitTestMode | 是 | 设置当前组件的触摸测试类型。 默认值: HitTestMode.Default |
HitTestMode枚举说明
名称 | 枚举值 | 描述 |
---|---|---|
Default | 0 | 默认触摸测试 |