dialog_remove_button()

Remove a button from a dialog.

Synopsis:

#include <bps/dialog.h>
 
BPS_API int dialog_remove_button(dialog_instance_t dialog,
                                 int index)

Since:

BlackBerry 10.0.0

Arguments:

dialog

The dialog to remove the button from.

index

The index of the button to remove. Buttons are indexed in the order that they are added with dialog_add_button() starting at 0.

Library:

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

Description:

The dialog_remove_button() function removes a button from the specified dialog. If the dialog is currently displayed when the request to remove the button is made, the update is not reflected until dialog_update() is called.

Returns:

BPS_SUCCESS upon success, BPS_FAILURE with errno set otherwise.