detachEvent method
[This documentation is preliminary and is subject to change.]
Unbinds the specified function from the event, so that the function stops receiving notifications when the event fires.
Syntax
HRESULT retVal = object.detachEvent(event, pDisp);
Standards information
There are no standards that apply here.
Parameters
event [in]
Type: BSTRBSTR that specifies any of the standard DHTML Events.
pDisp [in]
Type: IDispatchPointer to an IDispatch interface that specifies the function previously set using the attachEvent method.
Return value
Type: HRESULT
If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
Remarks
Behaviors that attach to events using the attachEvent method must explicitly call the detachEvent method to stop receiving notifications from the page when the ondetach event fires. Behaviors that attach to events using the PUBLIC:ATTACH element automatically stop receiving notifications when the behavior detaches from the element, and thus do not need to call the detachEvent method.
See also
Reference
Conceptual
Introduction to DHTML Behaviors
Using DHTML Behaviors
Using HTML Components to Implement DHTML Behaviors in Script
Build date: 1/23/2012