觸摸測試控制

設置組件的觸摸測試類型。ArkUI開發框架在處理觸屏事件時，會在觸屏事件觸發前，進行按壓點和組件區域的觸摸測試來收集需要響應觸屏事件的組件，然后基于觸摸測試結果分發相應的觸屏事件。hitTestBehavior屬性可以設置不同的觸摸測試響應模式，影響組件的觸摸測試收集結果，最終影響后續的觸屏事件分發，具體影響參考[HitTestMode]枚舉說明。

說明：

• 從API Version 9開始支持。后續版本如有新增內容，則采用上角標單獨標記該內容的起始版本。
• 當Stack組件中有多個節點觸摸區域重疊時，如兩個節點，默認只會對顯示在最上層的節點做觸摸測試，若需要顯示在下層的節點觸發觸摸測試，請給顯示在上層的節點設置hitTestBehavior為HitTestMode.Transparent。

屬性

HitTestMode枚舉說明

示例

Text組件設置hitTestBehavior為HitTestMode.Transparent，不會阻塞內層Stack的觸摸測試，因此Text和內層Stack的onTouch事件都會觸發。
內層Stack設置hitTestBehavior為HitTestMode.Block，會阻塞子節點和外層Button進行觸摸測試，因此內層Button和外層Button組件不會響應onTouch事件。

// xxx.ets
@Entry
@Component
struct HitTestBehaviorExample {
  build() {
    // outer stack
    Stack() {
      Button('outer button')
        .onTouch((event) = > {
          console.info('outer button touched type: ' + event.type)
        })
      // inner stack
      Stack() {
        Button('inner button')
          .onTouch((event) = > {
            console.info('inner button touched type: ' + event.type)
          })
      }
      .width("100%").height("100%")
      .hitTestBehavior(HitTestMode.Block)
      .onTouch((event) = > {
        console.info('stack touched type: ' + event.type)
      })

      Text('Transparent')
        .hitTestBehavior(HitTestMode.Transparent)
        .width("100%").height("100%")
        .onTouch((event) = > {
          console.info('text touched type: ' + event.type)
        })
    }.width(300).height(300)
  }
}

審核編輯 黃宇