From 25b6586b40f46850183bc7f0fa6bce0ae67dda6f Mon Sep 17 00:00:00 2001
From: "ester.zhou" <ester.zhou@huawei.com>
Date: Thu, 26 Jun 2025 20:39:35 +0800
Subject: [PATCH] Update docs (0626) Signed-off-by: ester.zhou
 <ester.zhou@huawei.com>

---
 .../arkui/ace_engine/native/native_type.h     | 28 ++++++++++-----
 .../arkui/ace_engine/native/ui_input_event.h  | 35 ++++++++++++++-----
 2 files changed, 47 insertions(+), 16 deletions(-)

diff --git a/en/native_sdk/arkui/ace_engine/native/native_type.h b/en/native_sdk/arkui/ace_engine/native/native_type.h
index 4ea1890a..6933f86b 100644
--- a/en/native_sdk/arkui/ace_engine/native/native_type.h
+++ b/en/native_sdk/arkui/ace_engine/native/native_type.h
@@ -803,17 +803,29 @@ typedef enum {
  * @since 12
  */
 typedef enum {
-    /** Both the node and its child node respond to the hit test of a touch event, but its sibling node is blocked from
-     *  the hit test. */
+    /** Both the node and its child nodes participate in hit tests, while blocking hit testis for sibling nodes.
+     *  This is the default hit test mode. */
     ARKUI_HIT_TEST_MODE_DEFAULT = 0,
-    /** The node responds to the hit test of a touch event, but its child node and sibling node are blocked from the
-     *  hit test. */
+    /** The node itself participates in hit tests, blocking hit tests for child and sibling nodes. */
     ARKUI_HIT_TEST_MODE_BLOCK,
-    /** Both the node and its child node respond to the hit test of a touch event, and its sibling node is also
-     * considered during the hit test. */
+    /** Both the node and its child nodes participate in hit tests, without blocking hit tests for sibling nodes. */
     ARKUI_HIT_TEST_MODE_TRANSPARENT,
-    /** The node does not respond to the hit test of a touch event. */
-    ARKUI_HIT_TEST_MODE_NONE
+    /** The node does not participate in hit tests, nor does it block hit tests for child or sibling nodes. */
+    ARKUI_HIT_TEST_MODE_NONE,
+    /**
+     * The node and its child nodes participate in hit tests, while blocking hit tests for all sibling nodes and
+     * parent nodes with lower priority.
+     *
+     * @since 20
+     */
+    ARKUI_HIT_TEST_MODE_BLOCK_HIERARCHY,
+    /**
+     * The node does not respond to hit tests, and none of its descendants (including children and grandchildren)
+     * participate in hit tests either.
+     *
+     * @since 20
+     */
+    ARKUI_HIT_TEST_MODE_BLOCK_DESCENDANTS,
 } ArkUI_HitTestMode;
 
 /**
diff --git a/en/native_sdk/arkui/ace_engine/native/ui_input_event.h b/en/native_sdk/arkui/ace_engine/native/ui_input_event.h
index 98720712..04725da1 100644
--- a/en/native_sdk/arkui/ace_engine/native/ui_input_event.h
+++ b/en/native_sdk/arkui/ace_engine/native/ui_input_event.h
@@ -62,6 +62,12 @@ typedef enum {
     ARKUI_UIINPUTEVENT_TYPE_AXIS = 2,
     /** Mouse event. */
     ARKUI_UIINPUTEVENT_TYPE_MOUSE = 3,
+    /**
+     * @brief Defines the key event.
+     *
+     * @since 20
+     */
+    ARKUI_UIINPUTEVENT_TYPE_KEY = 4,
 } ArkUI_UIInputEvent_Type;
 
 /**
@@ -125,21 +131,34 @@ enum {
  * @since 12
  */
 typedef enum {
-    /** Both the node and its child node respond to the hit test of a touch event,
-      * but its sibling node is blocked from the hit test. */
+    /** Both the node and its child nodes participate in hit tests, while blocking hit testis for sibling nodes.
+     *  This is the default hit test mode. */
     HTM_DEFAULT = 0,
 
-    /** The node responds to the hit test of a touch event, but its child node and
-      * sibling node are blocked from the hit test. */
+    /** The node itself participates in hit tests, blocking hit tests for child and sibling nodes. */
     HTM_BLOCK,
 
-    /** Both the node and its child node respond to the hit test of a touch event,
-      * and its sibling node is also considered during the hit test. */
+    /** Both the node and its child nodes participate in hit tests, without blocking hit tests for sibling nodes. */
     HTM_TRANSPARENT,
 
-    /** The node does not respond to the hit test of a touch event, but its child node and
-      * sibling node are considered during the hit test. */
+    /** The node does not participate in hit tests, nor does it block hit tests for child or sibling nodes. */
     HTM_NONE,
+
+    /**
+     * The node and its child nodes participate in hit tests, while blocking hit tests for all sibling nodes and parent
+     * nodes with lower priority.
+     *
+     * @since 20
+     */
+    HTM_BLOCK_HIERARCHY,
+
+    /**
+     * The node does not respond to hit tests, and none of its descendants (including children and grandchildren)
+     * participate in hit tests either.
+     *
+     * @since 20
+     */
+    HTM_BLOCK_DESCENDANTS,
 } HitTestMode;
 
 /**
-- 
Gitee