openharmony 鸿蒙 capi-arkui-accessibility-arkui-accessibilityprovidercallbacks

2026-08-25 浏览 (1)

ArkUI_AccessibilityProviderCallbacks

typedef struct {...} ArkUI_AccessibilityProviderCallbacks

概述

第三方操作provider回调函数结构定义，需要第三方平台实现的相关函数，通过OH_ArkUI_AccessibilityProviderRegisterCallback注册到系统侧。

起始版本： 13

相关模块： ArkUI_Accessibility

所在头文件： native_interface_accessibility.h

汇总

成员函数

名称描述
int32_t (*findAccessibilityNodeInfosById)(int64_t elementId, ArkUI_AccessibilitySearchMode mode, int32_t requestId, ArkUI_AccessibilityElementInfoList* elementList)查询指定节点的节点信息。由接入方平台实现的回调函数，注册给系统侧调用。
int32_t (*findAccessibilityNodeInfosByText)(int64_t elementId, const char* text, int32_t requestId,ArkUI_AccessibilityElementInfoList* elementList)基于指定的节点，查询满足指定text内容的节点信息。由接入方平台实现的回调函数，注册给系统侧调用。
int32_t (*findFocusedAccessibilityNode)(int64_t elementId, ArkUI_AccessibilityFocusType focusType, int32_t requestId, ArkUI_AccessibilityElementInfo* elementInfo)从指定节点出发，根据焦点类型查找当前已获得焦点的节点，并将该节点元素信息返回。由接入方平台实现的回调函数，注册给系统侧调用。
int32_t (*findNextFocusAccessibilityNode)(int64_t elementId, ArkUI_AccessibilityFocusMoveDirection direction, int32_t requestId, ArkUI_AccessibilityElementInfo* elementInfo)根据参考节点查询可以聚焦的节点，根据模式和方向查询下一个可以聚焦的节点。
int32_t (*executeAccessibilityAction)(int64_t elementId, ArkUI_Accessibility_ActionType action,ArkUI_AccessibilityActionArguments *actionArguments, int32_t requestId)在指定节点上执行Action操作。
int32_t (*clearFocusedFocusAccessibilityNode)()清除当前焦点节点的焦点状态。
int32_t (*getAccessibilityNodeCursorPosition)(int64_t elementId, int32_t requestId, int32_t* index)查询指定节点的当前光标位置。

成员函数说明

findAccessibilityNodeInfosById()

int32_t (*findAccessibilityNodeInfosById)(int64_t elementId, ArkUI_AccessibilitySearchMode mode,int32_t requestId, ArkUI_AccessibilityElementInfoList* elementList)

描述：

查询指定节点的节点信息。由接入方平台实现的回调函数，注册给系统侧调用。

起始版本： 13

参数：

参数项描述
int64_t elementId无障碍元素的唯一编号。
ArkUI_AccessibilitySearchMode mode表示无障碍搜索模式。
int32_t requestId表示请求ID。
ArkUI_AccessibilityElementInfoList* elementList表示无障碍元素信息列表。

返回：

类型说明
int32_tARKUI_ACCESSIBILITY_NATIVE_RESULT_SUCCESSFUL，表示操作成功。
ARKUI_ACCESSIBILITY_NATIVE_RESULT_BAD_PARAMETER，表示参数错误。

findAccessibilityNodeInfosByText()

int32_t (*findAccessibilityNodeInfosByText)(int64_t elementId, const char* text, int32_t requestId,ArkUI_AccessibilityElementInfoList* elementList)

描述：

基于指定的节点，查询满足指定text内容的节点信息。由接入方平台实现的回调函数，注册给系统侧调用。

起始版本： 13

参数：

参数项描述
int64_t elementId无障碍元素的唯一编号。
const char* text表示无障碍文本。
int32_t requestId表示请求ID。
ArkUI_AccessibilityElementInfoList* elementList表示无障碍元素信息列表。

返回：

类型说明
int32_tARKUI_ACCESSIBILITY_NATIVE_RESULT_SUCCESSFUL，表示操作成功。
ARKUI_ACCESSIBILITY_NATIVE_RESULT_BAD_PARAMETER，表示参数错误。

findFocusedAccessibilityNode()

int32_t (*findFocusedAccessibilityNode)(int64_t elementId, ArkUI_AccessibilityFocusType focusType, int32_t requestId, ArkUI_AccessibilityElementInfo* elementInfo)

描述：

从指定节点出发，根据焦点类型查找当前已获得焦点的节点，并将该节点元素信息返回。由接入方平台实现的回调函数，注册给系统侧调用。

起始版本： 13

参数：

参数项描述
int64_t elementId无障碍元素的唯一编号。
ArkUI_AccessibilityFocusType focusType表示焦点的类型。
int32_t requestId表示请求ID。
ArkUI_AccessibilityElementInfo* elementInfo表示无障碍元素信息。

返回：

类型说明
int32_tARKUI_ACCESSIBILITY_NATIVE_RESULT_SUCCESSFUL，表示操作成功。
ARKUI_ACCESSIBILITY_NATIVE_RESULT_BAD_PARAMETER，表示参数错误。

findNextFocusAccessibilityNode()

int32_t (*findNextFocusAccessibilityNode)(int64_t elementId, ArkUI_AccessibilityFocusMoveDirection direction, int32_t requestId, ArkUI_AccessibilityElementInfo* elementInfo)

描述：

根据参考节点的模式和查找方向查询下一个可以聚焦的节点。

起始版本： 13

参数：

参数项描述
int64_t elementId无障碍元素的唯一编号。
ArkUI_AccessibilityFocusMoveDirection direction表示查找方向。
int32_t requestId表示请求ID。
ArkUI_AccessibilityElementInfo* elementInfo查询到的无障碍元素信息。

返回：

类型说明
int32_tARKUI_ACCESSIBILITY_NATIVE_RESULT_SUCCESSFUL，表示操作成功。
ARKUI_ACCESSIBILITY_NATIVE_RESULT_BAD_PARAMETER，表示参数错误。

executeAccessibilityAction()

int32_t (*executeAccessibilityAction)(int64_t elementId, ArkUI_Accessibility_ActionType action,ArkUI_AccessibilityActionArguments *actionArguments, int32_t requestId)

描述：

在指定的无障碍节点上执行无障碍Action操作。

起始版本： 13

参数：

参数项描述
int64_t elementId无障碍元素的唯一编号。
ArkUI_Accessibility_ActionType action表示要执行的动作。
ArkUI_AccessibilityActionArguments *actionArguments表示动作的参数。
int32_t requestId表示请求的ID。

返回：

类型说明
int32_tARKUI_ACCESSIBILITY_NATIVE_RESULT_SUCCESSFUL，表示操作成功。
ARKUI_ACCESSIBILITY_NATIVE_RESULT_BAD_PARAMETER，表示参数错误。

clearFocusedFocusAccessibilityNode()

int32_t (*clearFocusedFocusAccessibilityNode)()

描述：

清除当前焦点节点的焦点状态。

起始版本： 13

返回：

类型说明
int32_tARKUI_ACCESSIBILITY_NATIVE_RESULT_SUCCESSFUL，表示操作成功。
ARKUI_ACCESSIBILITY_NATIVE_RESULT_BAD_PARAMETER，表示参数错误。

getAccessibilityNodeCursorPosition()

int32_t (*getAccessibilityNodeCursorPosition)(int64_t elementId, int32_t requestId, int32_t* index)

描述：

查询指定节点的当前光标位置。

起始版本： 13

参数：

参数项描述
int64_t elementId无障碍元素的唯一编号。
int32_t requestId表示请求的ID。
int32_t* index表示光标位置的索引。

返回：

类型说明
int32_tARKUI_ACCESSIBILITY_NATIVE_RESULT_SUCCESSFUL，表示操作成功。
ARKUI_ACCESSIBILITY_NATIVE_RESULT_BAD_PARAMETER，表示参数错误。

你可能感兴趣的鸿蒙文章

openharmony 鸿蒙 arkts-apis-uicontext-contextmenucontroller

openharmony 鸿蒙 errorcode-canvas

openharmony 鸿蒙 capi-oh-nativexcomponent-native-xcomponent-oh-nativexcomponent

openharmony 鸿蒙 errorcode-bindSheet

openharmony 鸿蒙 js-apis-arkui-uiExtension-sys

openharmony 鸿蒙 capi-arkui-accessibility-arkui-accessibilityeventinfo

openharmony 鸿蒙 capi-arkui-rendernodeutils

openharmony 鸿蒙 capi-native-node-h-nodeattributetype-layoutcomponent

openharmony 鸿蒙 js-apis-arkui-node

openharmony 鸿蒙 capi-native-node-h

  • 所属分类： 后端技术
  • 本文标签： 软件 鸿蒙
  • 版权声明： 本文链接 https://seaxiang.com/blog/wC2Mz7lK