navigator_window_cover_attribute_add_label()

Add a label to the window cover.

Synopsis:

#include <bps/navigator.h>
 
BPS_API int navigator_window_cover_attribute_add_label(navigator_window_cover_attribute_t *attribute,
                                                       const char *text,
                                                       navigator_window_cover_label_t **label)

Since:

BlackBerry 10.0.0

Arguments:

attribute

The window cover attribute handle.

text

The text for the label.

label

The window cover label handle.

Library:

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

Description:

Add a label to the window cover. This function will set a handle to the newly added label. With the label handle, the user can change various label settings.

Returns:

On success, BPS_SUCCESS. Otherwise, BPS_FAILURE with errno set, the attribute will be unchanged, and the label will be invalid.