• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# native_interface_focus.h
2
3
4## Overview
5
6Declares the APIs of **NativeFocus**.
7
8**Library**: libace_ndk.z.so
9
10**File to include**: <arkui/native_interface_focus.h>
11
12**System capability**: SystemCapability.ArkUI.ArkUI.Full
13
14**Since**: 15
15
16**Related module**: [ArkUI_NativeModule](_ark_u_i___native_module.md)
17
18
19## Summary
20
21### ArkUI_KeyProcessingMode
22
23```
24enum ArkUI_KeyProcessingMode
25```
26**Description**
27
28Sets the mode for processing key events when a component cannot process them.
29
30**Since**: 15
31
32| Name         | Description       |
33| ----------- | --------- |
34| ARKUI_KEY_PROCESSING_MODE_FOCUS_NAVIGATION | Key events are used for focus navigation. Default value.|
35| ARKUI_KEY_PROCESSING_MODE_FOCUS_ANCESTOR_EVENT |  Key events are propagated upwards to the ancestor components.|
36
37### Functions
38
39| Name| Description|
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); | Requests focus for a specific node.|
42| void OH_ArkUI_FocusClear([ArkUI_ContextHandle](_ark_u_i___native_module.md#arkui_contexthandle-12) uiContext); | Clears the focus to the root container node.|
43| void OH_ArkUI_FocusActivate([ArkUI_ContextHandle](_ark_u_i___native_module.md#arkui_contexthandle-12) uiContext, bool isActive, bool isAutoInactive); | Sets the focus activation state for the current page. When activated, the focused node displays a focus box.|
44| void OH_ArkUI_FocusSetAutoTransfer([ArkUI_ContextHandle](_ark_u_i___native_module.md#arkui_contexthandle-12) uiContext, bool autoTransfer); | Configures the focus transfer behavior when pages are switched.|
45| void OH_ArkUI_FocusSetKeyProcessingMode([ArkUI_ContextHandle](_ark_u_i___native_module.md#arkui_contexthandle-12) uiContext, [ArkUI_KeyProcessingMode](#arkui_keyprocessingmode) mode); | Configures the focus transfer behavior when pages are switched.|
46