565353b8创建于 2025年6月24日历史提交

native_interface_focus.h

概述

定义焦点管理的相关接口,主要用于主动转移焦点或管理控制焦点转移默认行为,控制焦点激活态。

库: libace_ndk.z.so

引用文件: <arkui/native_interface_focus.h>

系统能力: SystemCapability.ArkUI.ArkUI.Full

起始版本: 15

相关模块:ArkUI_NativeModule

汇总

枚举

名称 描述
ArkUI_KeyProcessingMode { ARKUI_KEY_PROCESSING_MODE_FOCUS_NAVIGATION = 0, ARKUI_KEY_PROCESSING_MODE_FOCUS_ANCESTOR_EVENT } 当组件无法处理按键事件时,确定按键事件处理的优先级。

函数

名称 描述
ArkUI_ErrorCode OH_ArkUI_FocusRequest(ArkUI_NodeHandle node); 请求焦点。
起始版本: 15
void OH_ArkUI_FocusClear(ArkUI_ContextHandle uiContext); 将当前焦点清除到根容器节点。
起始版本: 15
void OH_ArkUI_FocusActivate(ArkUI_ContextHandle uiContext, bool isActive, bool isAutoInactive); 设置当前界面的焦点激活态,获焦节点显示焦点框。
起始版本: 15
void OH_ArkUI_FocusSetAutoTransfer(ArkUI_ContextHandle uiContext, bool autoTransfer); 设置页面切换时,焦点转移行为。
起始版本: 15
void OH_ArkUI_FocusSetKeyProcessingMode(ArkUI_ContextHandle uiContext, ArkUI_KeyProcessingMode mode); 设置按键事件处理的优先级。
起始版本: 15