navigator_set_wallpaper()

Change the device's wallpaper.

Synopsis:

#include <bps/navigator.h>
 
BPS_API int navigator_set_wallpaper(const char *filepath)

Since:

BlackBerry 10.0.0

Arguments:

filepath

Path to an image file that will be used as the wallpaper.

Library:

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

Description:

Set the device's wallpaper using the image file provided in filepath.

Returns:

On success return BPS_SUCCESS. Otherwise, return BPS_FAILURE with errno set, the wallpaper will not be changed.