• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# native_interface_focus.h
2
3
4## 概述
5
6定义焦点管理的相关接口,主要用于主动转移焦点或管理控制焦点转移默认行为,控制焦点激活态。
7
8**库:** libace_ndk.z.so
9
10**引用文件:** <arkui/native_interface_focus.h>
11
12**系统能力:** SystemCapability.ArkUI.ArkUI.Full
13
14**起始版本:** 15
15
16**相关模块:**[ArkUI_NativeModule](_ark_u_i___native_module.md)
17
18
19## 汇总
20
21### ArkUI_KeyProcessingMode
22
23```
24enum ArkUI_KeyProcessingMode
25```
26**描述:**
27
28当组件无法处理按键事件时,确定按键事件处理的优先级。
29
30**起始版本:** 15
31
32| 名称          | 描述        |
33| ----------- | --------- |
34| ARKUI_KEY_PROCESSING_MODE_FOCUS_NAVIGATION | 默认值,按键事件用于移动焦点。|
35| ARKUI_KEY_PROCESSING_MODE_FOCUS_ANCESTOR_EVENT |  按键事件向上传递给祖先组件。 |
36
37### 函数
38
39| 名称 | 描述 |
40| -------- | -------- |
41|[ArkUI_ErrorCode](_ark_u_i___native_module.md#arkui_errorcode)  OH_ArkUI_FocusRequest([ArkUI_NodeHandle](_ark_u_i___native_module.md#arkui_nodehandle) node); | 请求焦点。|
42| void OH_ArkUI_FocusClear([ArkUI_ContextHandle](_ark_u_i___native_module.md#arkui_contexthandle-12) uiContext); | 将当前焦点清除到根容器节点。 |
43| void OH_ArkUI_FocusActivate([ArkUI_ContextHandle](_ark_u_i___native_module.md#arkui_contexthandle-12) uiContext, bool isActive, bool isAutoInactive); | 设置当前界面的焦点激活态,获焦节点显示焦点框。|
44| void OH_ArkUI_FocusSetAutoTransfer([ArkUI_ContextHandle](_ark_u_i___native_module.md#arkui_contexthandle-12) uiContext, bool autoTransfer); | 设置页面切换时,焦点转移行为。 |
45| void OH_ArkUI_FocusSetKeyProcessingMode([ArkUI_ContextHandle](_ark_u_i___native_module.md#arkui_contexthandle-12) uiContext, [ArkUI_KeyProcessingMode](#arkui_keyprocessingmode) mode); | 设置按键事件处理的优先级。 |
46