navigator_invoke_query_result_target_get_label()

#include <bps/navigator_invoke.h>
 

BPS_API const char* navigator_invoke_query_result_target_get_label(const navigator_invoke_query_result_target_t *target)

Since:

BlackBerry 10.0.0

Arguments:

target

The navigator_invoke_query_result_target_t structure whose label member you want to retrieve.

Library:

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

Description:

The navigator_invoke_query_result_target_get_label() function extracts the label to an icon of a given navigator_invoke_query_result_target_t structure. The label member allows the target to be identified with a localized label name in UTF-8 format. For example, "Example Target" would be a suitable label for a target. 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 to display returned target value(s).

Returns:

The label of the given target, NULL otherwise.