navigator_window_cover_attribute_set_alternate_window()

Set the window cover to use an alternate window.

Synopsis:

#include <bps/navigator.h>
 
BPS_API int navigator_window_cover_attribute_set_alternate_window(navigator_window_cover_attribute_t *attribute)

Since:

BlackBerry 10.0.0

Arguments:

attribute

The window cover attribute handle.

Library:

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

Description:

There are 4 modes for covers. Live, file, capture, or alternate window. If alternate window is set, capture and file path attributes are discarded. The alternate window is specified by using the SCREEN_PROPERTY_ALTERNATE_WINDOW property.

Returns:

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