bbads_banner_set_border_width()

Modify the width of the banner's border.

Synopsis:

#include <bbads/bbads.h>

bbads_error_t bbads_banner_set_border_width(bbads_banner_t *banner, unsigned int width)

Since:

BlackBerry 10.0.0

Arguments:

banner: The bbads_banner_t* as created in the call to bbads_banner_create().

width: The width of the border when the ad is clicked. This must be an integer value between 0 and 10, inclusive.

Library:

libbbads

Description:

This is the width of the banner's border that appears when the user clicks/touches the banner.

Modifying the width of the banner's border can only be performed before the banner has been loaded. See bbads_banner_is_loaded().

The border width contributes to the banner's width and height. You can use these calculations to determine the final width and height of the banner.

full banner width = (set banner width) + 2*(border width)
full banner height = (set banner height) + 2*(border width)

See bbads_banner_set_size() for more information on setting the banner's size.

Returns:

BBADS_EOK on success.
BBADS_EBANNER if the bbads_banner_t* provided is invalid.
BBADS_EINVAL if the width provided is invalid.
BBADS_ESTATE if the banner has already been loaded.