gui.disconnect

Terminates a GUI listening binding.

Prototype

  1. bOk = gui.disconnect ( hSender, sEvent, hReceiver|nil, sHandler|nil )

Description

This function allows you the remove a gui.connect binding when you no longer need to listen to the event or when you are about to change the handler function.


Parameters

hSender - sender component handle
sEvent - event name string
hReceiver|nil - receiver component handle, or nil
sHandler|nil - handler function name string, or nil


Return values

bOk - true on success


Sample

  1. gui.disconnect ( hItem, gui.kEventMenuActionTriggered, nil, nil )
  2. gui.connect ( hItem, gui.kEventMenuActionTriggered, nil, sTriggerMenuActionOpenWithCallback or "commonAPITriggerMenuActionOpenWith" )

Available since ShiVa 2.0