navigator_invoke_query_result_action_get

Get the label of an action from an invocation query result.

Synopsis:

#include <bps/navigator_invoke.h>

BPS_API const char* navigator_invoke_query_result_action_get_label(const navigator_invoke_query_result_action_t *action)

Since:

BlackBerry 10.0.0

Arguments:

action: The navigator_invoke_query_result_action_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_action_get_label() function extracts the label to an icon of a given navigator_invoke_query_result_action_t structure. The label member allows the action to be identified with a localized label name in UTF-8 format. For example, a suitable label for the "bb.action.SHARE" action would be "Share". This function doesn't copy members and the returned values are released once the bps_get_event() function is called again.

Returns:

The label of the given action, NULL otherwise.