navigator_invoke_query_result_target_get_splash()

#include <bps/navigator_invoke.h>
 

BPS_API const char* navigator_invoke_query_result_target_get_splash(const navigator_invoke_query_result_target_t *target) BPS_DEPRECATED

Since:

BlackBerry 10.0.0

Arguments:

target

The navigator_invoke_query_result_target_t structure whose splash member you want to retrieve.

Library:

libbps (For the qcc command, use the -l bps option to link against this library)

Description:

Deprecated:

The use of viewers has been deprecated - use applications or cards as invocation targets instead.

The navigator_invoke_query_result_target_get_splash() function extracts the URI to a splash icon of a given navigator_invoke_query_result_target_t structure. The splash member is a path to an icon to be displayed to represent the given target while loading. This function doesn't copy members and the returned values are released once the bps_get_event() function is called again.

You must call this function if the target type is a viewer. To test this, call the navigator_invoke_query_result_target_get_type() function. If the function returns NAVIGATOR_INVOKE_TARGET_TYPE_VIEWER, the given target is a viewer).

Returns:

The splash icon URI of the given target, NULL otherwise.