harmony 鸿蒙native_node_napi.h

2025-06-12
浏览 (4)

native_node_napi.h

概述

提供ArkTS侧的FrameNode转换NodeHandle的方式。

库： libace_ndk.z.so

引用文件：

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

起始版本： 12

相关模块：ArkUI_NativeModule

汇总

函数

名称	描述
int32_t OH_ArkUI_GetNodeHandleFromNapiValue (napi_env env, napi_value frameNode, ArkUI_NodeHandle *handle)	获取ArkTS侧创建的FrameNode节点对象映射到Native侧的ArkUI_NodeHandle。
int32_t OH_ArkUI_GetContextFromNapiValue (napi_env env, napi_value value, ArkUI_ContextHandle *context)	获取ArkTS侧创建的UIContext对象映射到Native侧的ArkUI_ContextHandle。
int32_t OH_ArkUI_GetNodeContentFromNapiValue (napi_env env, napi_value value, ArkUI_NodeContentHandle *content)	获取ArkTS侧创建的NodeContent对象映射到Native侧的ArkUI_NodeContentHandle。
int32_t OH_ArkUI_GetDrawableDescriptorFromNapiValue (napi_env env, napi_value value, ArkUI_DrawableDescriptor **drawableDescriptor)	将ArkTS侧创建的DrawableDescriptor对象映射到Native侧的ArkUI_DrawableDescriptor。
int32_t OH_ArkUI_GetDrawableDescriptorFromResourceNapiValue (napi_env env, napi_value value, ArkUI_DrawableDescriptor **drawableDescriptor)	将ArkTS侧创建的$r资源对象映射到Native侧的ArkUI_DrawableDescriptor。
ArkUI_ErrorCode OH_ArkUI_GetNavigationId (ArkUI_NodeHandle node, char buffer, int32_t bufferSize, int32_t writeLength)	获取当前节点所在的Navigation组件的ID。
ArkUI_ErrorCode OH_ArkUI_GetNavDestinationName (ArkUI_NodeHandle node, char buffer, int32_t bufferSize, int32_t writeLength)	获取当前节点所在的NavDestination组件的名称。
ArkUI_ErrorCode OH_ArkUI_GetNavStackLength (ArkUI_NodeHandle node, int32_t *length)	根据给定索引值，获取当前节点所在的Navigation栈的长度。
ArkUI_ErrorCode OH_ArkUI_GetNavDestinationNameByIndex (ArkUI_NodeHandle node, int32_t index, char buffer, int32_t bufferSize, int32_t writeLength)	根据给定索引值，获取当前节点所在的Navigation栈中对应位置的页面名称。索引值从0开始计数，0为栈底。
ArkUI_ErrorCode OH_ArkUI_GetNavDestinationId (ArkUI_NodeHandle node, char buffer, int32_t bufferSize, int32_t writeLength)	获取当前节点所在的NavDestination组件的ID。
ArkUI_ErrorCode OH_ArkUI_GetNavDestinationState (ArkUI_NodeHandle node, ArkUI_NavDestinationState *state)	获取当前节点所在的NavDestination组件的状态。
ArkUI_ErrorCode OH_ArkUI_GetNavDestinationIndex (ArkUI_NodeHandle node, int32_t *index)	获取当前节点所在的NavDestination组件在页面栈的索引。
napi_value OH_ArkUI_GetNavDestinationParam (ArkUI_NodeHandle node)	获取当前节点所在的NavDestination组件的参数。
ArkUI_ErrorCode OH_ArkUI_GetRouterPageIndex (ArkUI_NodeHandle node, int32_t *index)	获取当前节点所在页面在Router页面栈中的索引。
ArkUI_ErrorCode OH_ArkUI_GetRouterPageName (ArkUI_NodeHandle node, char buffer, int32_t bufferSize, int32_t writeLength)	获取当前节点所在页面的名称。
ArkUI_ErrorCode OH_ArkUI_GetRouterPagePath (ArkUI_NodeHandle node, char buffer, int32_t bufferSize, int32_t writeLength)	获取当前节点所在页面的Page组件的路径。
ArkUI_ErrorCode OH_ArkUI_GetRouterPageState (ArkUI_NodeHandle node, ArkUI_RouterPageState *state)	获取当前节点所在页面的Page组件的状态。
ArkUI_ErrorCode OH_ArkUI_GetRouterPageId (ArkUI_NodeHandle node, char buffer, int32_t bufferSize, int32_t writeLength)	获取当前节点所在页面的Page组件的ID。
int32_t OH_ArkUI_PostFrameCallback(ArkUI_ContextHandle uiContext, void* userData, void (callback)(uint64_t nanoTimestamp, uint32_t frameCount, void userData))	注册一个回调函数，以便在下一帧渲染时执行。不允许在非UI线程调用，检查到非UI线程调用程序会主动abort。
int32_t OH_ArkUI_PostIdleCallback(ArkUI_ContextHandle uiContext, void* userData, void (callback)(uint64_t nanoTimeLeft, uint32_t frameCount, void userData))	注册一个回调函数，以便在下一帧渲染完成时执行。如果当前没有下一帧，将自动请求下一帧。