Button Pad

This feature displays 1 to 6 buttons in a floating/movable button pad on the main phone book screen. The typical use is to have a user select a contact and click OK on the button pad, or Cancel to cancel the operation.

PB_BUTTONPAD_RESET

Resets all settings for the button pad.

PB_BUTTONPAD_TITLE title

Sets the title bar text for the button pad.

PB_BUTTONPAD_TEXT index, ButtonText

Sets the button text for button index where is from 0 to 5. The highest value for index will dictate how many buttons are shown on the button pad.

PB_BUTTONPAD_CANCEL index

The button given by index responds to the ‘Esc’ key to cancel.

PB_BUTTONPAD_DEFAULT index

The button given by index responds to the ‘Enter’ key to select.

PB_BUTTONPAD_TIMEOUT Seconds

Sets the timeout for the user to make a selection to Seconds (integer).

PB_BUTTONPAD_START Clicked

This command activates the phone book, then shows the button pad and waits for the user to click one of the buttons. It sets Clicked to the integer value of the clicked on button, with 0 being the first button.

Sets Clicked to -1 if there was an error, -2 if the timeout expired.