Layer.releaseEvents() (Function)

Part of the Netscape 4 event propagation complex.


JavaScript - 1.2
Netscape - 4.0
Property/method value type:undefined
JavaScript syntax:NmyLayer.releaseEvents(anEventMask)
Argument list:anEventMaskA mask defined with the manifest event constants

This is part of the event management suite which allows events to be routed to handlers other than just the one that defaults to being associated with an event.

The events to be captured are signified by setting bits in a mask.

This method provides a means of indicating which events are no longer needing to be captured by the receiving Layer object.

The events are specified by using the bitwise OR operator (|) to combine the required event mask constants into a mask that defines the events you want to capture. Refer to the Event Type Constants topic for a list of the event mask values.

Since this is only supported by Netscape, the functionality is likely to be deprecated when the standards bodies agree on a standard way of handling events. In the meantime, we shall have to implement scripts using this capability if we need to build complex event handling systems. A different script will be required for MSIE.

You may be able to factor your event handler so that you only have to make platform specific event dispatchers, and can call common handling routines that can be shared between MSIE and Netscape.


See also:captureEvents(), Document.captureEvents(), Document.releaseEvents(), Element.onevent, Event propagation, Event type constants, Event.modifiers, Frame object, Layer.captureEvents(), onMouseMove, Window object, Window.releaseEvents()