diff --git a/zh-cn/native_sdk/ace/native_node.h b/zh-cn/native_sdk/ace/native_node.h index ee621a30c5312d423cff7b20fd4431a93c68550a..fe64d6f29d586e3ff9a5df22fcf705da1142d279 100644 --- a/zh-cn/native_sdk/ace/native_node.h +++ b/zh-cn/native_sdk/ace/native_node.h @@ -1394,6 +1394,74 @@ typedef enum { */ NODE_FOREGROUND_BLUR_STYLE, + /** + * @brief 无障碍自定义标识ID,支持属性获取。 + * + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式: \n + * .value[0].i32:无障碍自定义标识ID。\n + * + */ + NODE_ACCESSIBILITY_ID, + + /** + * @brief 定义无障碍支持操作类型属性,支持属性设置,属性重置和属性获取。 + * + * 属性设置方法{@link ArkUI_AttributeItem}参数格式: \n + * .value[0].u32:配置无障碍操作类型,参数类型{@link ArkUI_AccessibilityActionType}。 + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式: \n + * .value[0].u32:配置无障碍操作类型,参数类型{@link ArkUI_AccessibilityActionType}。 + * + */ + NODE_ACCESSIBILITY_ACTIONS, + + /** + * @brief 定义无障碍组件类型属性,支持属性设置,属性重置和属性获取。 + * + * 属性设置方法{@link ArkUI_AttributeItem}参数格式: \n + * .value[0].u32:无障碍组件类型,参数类型{@link ArkUI_NodeType}。 + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式: \n + * .value[0].u32:无障碍组件类型,参数类型{@link ArkUI_NodeType}。 + * + */ + NODE_ACCESSIBILITY_ROLE, + + /** + * @brief 定义无障碍状态属性,支持属性设置,属性重置和属性获取。 + * + * 属性设置方法{@link ArkUI_AttributeItem}参数格式: \n + * .object:参数类型{@Link ARKUI_AccessibilityState}。 + * .value[0]?.i32:是否启用, 1表示启动,0表示不启动, 默认值0; \n + * .value[1]?.i32: 是否被选中, 1表示选中,0表示未被选中,默认值0。 \n + * .value[2]?.i32: 复选框状态,参数类型{@link ArkUI_AccessibilityCheckedType}, 默认值:ARKUI_ACCESSIBILITY_UNCHECKED。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式: \n + * .value[0].i32:是否启用, 1表示启动,0表示不启动; \n + * .value[1].i32: 是否被选中, 1表示选中,0表示未被选中。 \n + * .value[2].i32: 复选框状态,参数类型{@link ArkUI_AccessibilityCheckedType}。\n + * + */ + NODE_ACCESSIBILITY_STATE, + + /** + * @brief 定义无障碍信息属性,支持属性设置,属性重置和属性获取。 + * + * 属性设置方法{@link ArkUI_AttributeItem}参数格式: \n + * .value[0]?.i32:基于范围组件的最小值, 默认值为-1; \n + * .value[1]?.i32: 基于范围组件的最大值,默认值为-1。 \n + * .value[2]?.i32: 基于范围组件的当前值,默认值为-1。 \n + * ?.string: 组件的文本描述信息,默认为空。\n + * \n + * 属性获取方法返回值{@link ArkUI_AttributeItem}格式: \n + * .value[0].i32:基于范围组件的最小值, 默认值为-1; \n + * .value[1].i32: 基于范围组件的最大值,默认值为-1。 \n + * .value[2].i32: 基于范围组件的当前值,默认值为-1。 \n + * .string: 组件的文本描述信息,默认为空。\n + * + */ + NODE_ACCESSIBILITY_VALUE, + /** * @brief 组件内隐式共享元素转场,支持属性设置,属性重置,属性获取接口。 * @@ -4561,6 +4629,16 @@ typedef enum { * 事件回调发生时,事件参数{@link ArkUI_NodeEvent}对象中的联合体类型为{@link ArkUI_UIInputEvent}。\n */ NODE_ON_MOUSE, + /** + * @brief 无障碍支持操作事件触发。 + * + * 触发该事件的条件:已设置无障碍操作类型,并进行相应操作。\n + * 事件回调发生时,事件参数{@link ArkUI_NodeEvent}对象中的联合体类型为{@link ArkUI_NodeComponentEvent}。\n + * {@link ArkUI_NodeComponentEvent}中包含1个参数: \n + * ArkUI_NodeComponentEvent.data[0].u32: 触发回调的操作类型,参数类型{@link ArkUI_AccessibilityActionType} \n + * + */ + NODE_ON_ACCESSIBILITY_ACTIONS, /** * @brief 文本设置TextDataDetectorConfig且识别成功时,触发onDetectResultUpdate回调。 * diff --git a/zh-cn/native_sdk/ace/native_type.h b/zh-cn/native_sdk/ace/native_type.h index d42c0b4005c7c6e50b5f6e218ad62ed164b177d0..caab932be0b991ecb8acac6a0982bb975ee3cc41 100644 --- a/zh-cn/native_sdk/ace/native_type.h +++ b/zh-cn/native_sdk/ace/native_type.h @@ -487,6 +487,36 @@ typedef struct { int32_t size; } ARKUI_TextPickerCascadeRangeContent; +/** + * @brief 定义无障碍复选框状态类型枚举值。 + * + * @since 12 + */ +typedef enum { + /** 复选框被选中。*/ + ARKUI_ACCESSIBILITY_CHECKED = 0, + /** 复选框未被选中。*/ + ARKUI_ACCESSIBILITY_UNCHECKED, +} ArkUI_AccessibilityCheckedType; + +/** + * @brief 定义无障碍操作类型。 + * + * @since 12 + */ +typedef enum { + /** 点击操作。*/ + ARKUI_ACCESSIBILITY_ACTION_CLICK = 1 << 0, + /** 长按操作。*/ + ARKUI_ACCESSIBILITY_ACTION_LONG_CLICK = 1 << 1, + /** 剪切操作。*/ + ARKUI_ACCESSIBILITY_ACTION_CUT = 1 << 2, + /** 复制操作。*/ + ARKUI_ACCESSIBILITY_ACTION_COPY = 1 << 3, + /** 粘贴操作。*/ + ARKUI_ACCESSIBILITY_ACTION_PASTE = 1 << 4, +} ArkUI_AccessibilityActionType; + /** * @brief 定义边缘滑动效果枚举值。 *