BBjToolButton::getBeep

Description

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

Syntax

Return Value	Method
boolean	getBeep()

Parameters

None.

Return Value

Returns a boolean value indicating whether to beep on the client when the user clicks this BBjToolButton; 0 = false, 1 = true.

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::getBeep

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,"getBeep",$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