dialog_set_popuplist_show_basic_selection()

Specify whether to show a basic selection list in the popup list dialog.

Synopsis:

#include <bps/dialog.h>
 
BPS_API int dialog_set_popuplist_show_basic_selection(dialog_instance_t dialog,
                                                      bool show_basic_selection)

Since:

BlackBerry 10.2.0

Arguments:

dialog

The dialog to update.

show_basic_selection

If true, a basic selection list is used in the popup list dialog; if false, a basic selection list is not used in the popup list dialog.

Library:

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

Description:

The dialog_set_popuplist_show_basic_selection() function specifies whether to show a basic selection list in the popup list dialog. By default the basic selection list is not used.

A basic selection list shows a list of items (as text), and selecting an item highlights the entire item.

A non-basic selection list includes a radio button or checkbox on each item in addition to the displayed text. (radio button in the single-select case, checkboxes in the multi-select case). Selecting an item checks the checkbox or radio button.

Returns:

BPS_SUCCESS upon success, BPS_FAILURE with errno set otherwise.