使用导航类组件

NDK提供一系列Navigation和页面路由状态查询接口，开发者可以通过OH_ArkUI_GetNavDestinationName、OH_ArkUI_GetNavDestinationParam、OH_ArkUI_GetNavDestinationState、OH_ArkUI_GetNavigationId、OH_ArkUI_GetNavDestinationIndex等查询页面的状态、索引、名称等信息，并根据查询结果进行对应的操作，如显示不同的页面信息。

本文提供页面状态查询开发指导，查询之前需要先接入ArkTS页面，具体请参考接入ArkTS页面。

查询页面信息

查询页面信息，需要先确保目标节点已作为子节点挂载到页面中，若节点未挂载则操作会失败，例如在aboutToAppear生命周期中查询不到对应信息。页面详细生命周期以及组件挂载生命周期参考页面生命周期。开发者可以根据查询到的页面信息加载不同的页面组件。

本示例仅展示核心功能代码，完整示例请参考NDK使用页面查询接口示例。

查询当前页面名称。

使用OH_ArkUI_GetNavDestinationName可以查询NavDestination页面名称。router页面名称可以通过OH_ArkUI_GetRouterPageName接口查询。
```
// 获取页面名称
char pageName[NUM_50];
int32_t bufferLen = 0;
OH_ArkUI_GetNavDestinationName(node, pageName, NUM_50, &bufferLen);
```
QueryNavigation.h

查询页面跳转参数。

使用OH_ArkUI_GetNavDestinationParam可以查询NavDestination页面跳转参数。

// 获取页面跳转参数
napi_value param = OH_ArkUI_GetNavDestinationParam(node);
napi_value nameVal = nullptr;
napi_get_named_property(env, param, "name", &nameVal);
size_t len = 0;
napi_get_value_string_utf8(env, nameVal, nullptr, 0, &len);
std::unique_ptr<char[]> viewName = std::make_unique<char[]>(len + 1);
napi_get_value_string_utf8(env, nameVal, viewName.get(), len + 1, &len);
ArkUI_NodeHandle targetNode = nullptr;
std::string view = viewName.get();
if (view == "QueryNavigation") {
    InitNavigationNode(column, pageName);
} else if (view == "QueryRouter") {
    InitRouterNode(column);
}
nativeApi->addChild(node, column);

QueryNavigation.h

查询页面状态

使用OH_ArkUI_GetNavDestinationState可以查询当前占位组件所属的NavDestination页面状态。router页面可以通过OH_ArkUI_GetRouterPageState接口查询，根据查询结果进行对应的适配，如设置组件visible属性、视频播放状态。

本示例仅展示核心功能代码，完整示例请参考NDK使用页面查询接口示例。

ArkUI_NodeHandle targetNode = nullptr;
OH_ArkUI_NodeUtils_GetAttachedNodeHandleById("navDestinationState", &targetNode);
auto entry = NativeEntry::GetInstance();
entry->ReportError(targetNode, "event clicked");
ArkUI_NavDestinationState state;
OH_ArkUI_GetNavDestinationState(targetNode, &state);
if (state == NUM_8) {
    entry->SetColor(targetNode, 0x80808080);
} else if (state == NUM_9) {
    entry->SetColor(targetNode, 0xFF000000);
}

EntryModule.cpp

查询页面栈信息

使用OH_ArkUI_GetNavDestinationIndex可以查询当前占位组件所属NavDestination在栈中的位置。router页面状态可以通过OH_ArkUI_GetRouterPageIndex接口查询。根据返回的页面栈信息，可在应用开发中实现DFX功能，例如性能监控与用户行为分析等参数的收集，用于数据上报和分析。

本示例仅展示核心功能代码，完整示例请参考NDK使用页面查询接口示例。

char navigationId[NUM_50];
int32_t bufferLen = 0;
OH_ArkUI_GetNavigationId(handle, navigationId, NUM_50, &bufferLen);
    
char name[NUM_50];
int32_t nameLen = OH_ArkUI_GetNavDestinationName(handle, name, NUM_50, &nameLen);
    
int32_t index = -1;
OH_ArkUI_GetNavDestinationIndex(handle, &index);
OH_LOG_Print(LOG_APP, LOG_ERROR, 0xFF00, "NAPI",
             "navigation id: %{public}s, name: %{public}s, index: %{public}d, error: %{public}s",
             navigationId, name, index, info.c_str());

EntryModule.cpp