BBjToolButton::setBeep

Description

In BBj 15.0 and higher, this method sets a boolean value indicating whether to beep on the client when the user clicks this BBjToolButton.

Syntax

Return Value

Method

void

setBeep(boolean beep)

Parameters

Variable

Description

beep

Specifies whether clicking this tool button should generate a beep on the client.

0 = Don't beep (default).

1 = Beep when the user clicks this tool button.  

Return Value

None.

Remarks

Mobile browsers only allow application programs to generate sounds as a direct result of user action, like clicking a button. Because of this restriction, mobile browsers ignore BBjSysGui::beep when running in BUI.

Example

rem ' BBjToolButton::setBeep

fast_touch_click$ = "FALSE"
if msgbox("FAST_TOUCH_CLICK?",4+32+256) = 6 then fast_touch_click$ = "TRUE"
print stbl("!OPTIONS","FAST_TOUCH_CLICK = "+fast_touch_click$)
sysgui = unt
open (sysgui)"X0"
sysgui! = bbjapi().getSysGui()
window! = sysgui!.addWindow(100,100,300,200,"setBeep",$00090003$)
window!.setCallback(window!.ON_CLOSE,"eoj")
button! = window!.addButton(101,25,25,125,25,"Button",$$)
button_beep! = window!.addCheckBox(102,175,25,100,25,"Beep",$$)
button_beep!.setCallback(button_beep!.ON_CHECK_ON,"button_beep_on")
button_beep!.setCallback(button_beep!.ON_CHECK_OFF,"button_beep_off")
menubutton! = window!.addMenuButton(103,25,75,125,25,"Menu Button",$$)
menubutton_beep! = window!.addCheckBox(104,175,75,100,25,"Beep",$$)
menubutton_beep!.setCallback(menubutton_beep!.ON_CHECK_ON,"menubutton_beep_on")
menubutton_beep!.setCallback(menubutton_beep!.ON_CHECK_OFF,"menubutton_beep_off")
toolbutton! = window!.addToolButton(105,25,125,125,25,"Tool Button",$$)
toolbutton_beep! = window!.addCheckBox(106,175,125,100,25,"Beep",$$)
toolbutton_beep!.setCallback(toolbutton_beep!.ON_CHECK_ON,"toolbutton_beep_on")
toolbutton_beep!.setCallback(toolbutton_beep!.ON_CHECK_OFF,"toolbutton_beep_off")
process_events
eoj: release
button_beep_on: button!.setBeep(1); print button!.getBeep(); return
button_beep_off: button!.setBeep(0); print button!.getBeep(); return
menubutton_beep_on: menubutton!.setBeep(1); print menubutton!.getBeep(); return
menubutton_beep_off: menubutton!.setBeep(0); print menubutton!.getBeep(); return
toolbutton_beep_on: toolbutton!.setBeep(1); print toolbutton!.getBeep(); return
toolbutton_beep_off: toolbutton!.setBeep(0); print toolbutton!.getBeep(); return

See Also

BBjAPI

BBjSysGui

BBjControl

BBjWindow

See the BBj Object Diagram for an illustration of the relationship between BBj Objects.