BBjControl::clearCallback

Description

In BBj 2.01 and higher, this method unregisters the callback routine for a specified event of the BBjControl.

Syntax

Return Value	Method
void	clearCallback(int `eventType`)

Parameters

Parameter	Description
eventType	Event type for which the callback is to be unregistered.

Return Value

None.

Remarks

An attempt to unregister a callback that has not been registered either through the CALLBACK verb, or through BBjControl::setCallback results in a runtime error.

When a foreign interpreter invokes this method, an !ERROR=208 Multi Thread results. See Accessing Objects From Different Interpreters.

Example

rem 'Clear a Callback using BBj::clearCallBack

rem 'Obtain the instance of the BBjAPI object
let myAPI! = BBjAPI()

rem 'Open the SysGui device
SYSGUI = UNT
OPEN (SYSGUI) "X0"

rem 'Obtain the instance of the BBjSysGui object
let mySysGui! = myAPI!.getSysGui()

rem 'Set addWindow param values
X = 10
Y = 10
WIDTH = 300
HEIGHT = 200
TITLE$="BBj Window"

rem 'Set the current context
mySysGui!.setContext(0)

rem 'Create a window
myWindow! = mySysGui!.addWindow(X,Y,WIDTH,HEIGHT,TITLE$)

rem 'Add a button on the window
myRedButton! = myWindow!.addButton(101,150,100,90,30,"Red",$0800$)
myDisableButton! = myWindow!.addButton(102,50,100,90,30,"Disable Red",$0800$)

rem 'Register the CALLBACK routines
myRedButton!.setCallback(myRedButton!.ON_BUTTON_PUSH,"RED_BUTTON_PUSHED")
let rn$ = "DISABLE_BUTTON_PUSHED"
myDisableButton!.setCallback(myDisableButton!.ON_BUTTON_PUSH,rn$)
myWindow!.setCallback(myWindow!.ON_CLOSE,"APP_CLOSE")

rem 'Process Events
process_events

rem 'Callback routine called when the red button is pressed
RED_BUTTON_PUSHED:
    rem 'Create the BBjColor Object using colorNum constant
    myColorRed! = mySysGui!.makeColor(mySysGui!.RED)

    rem 'Set the button colors to RED
    myRedButton!.setBackColor(myColorRed!)
return

rem 'Callback routine disables red button callback
DISABLE_BUTTON_PUSHED:
    myRedButton!.clearCallback(myRedButton!.ON_BUTTON_PUSH)
    myRedButton!.setText("Red disabled")
return

rem 'Callback routine called when the user closes the application window
APP_CLOSE:
release