Availability
Netscape 4
Synopsis
window.routeEvent(event)document.routeEvent(event)
layer.routeEvent(event)
Arguments
event
The captured Event object to be routed to the next event handler.
Returns
Whatever value was returned by the handler to which the
event was routed.
Description
routeEvent( ) is a method of the Window, Document,
and Layer classes, and it behaves the same for all three. When a
captured Event object, event, is passed to
an event handler of window,
document, or
layer, that handler may choose to pass the
event on to the next interested event handler, if any. If the window,
document, or layer contains some other window (frame), document, or
layer that has also used captureEvents( ) to
register interest in events of that type, the event is routed to the
appropriate handler on that window, document, or layer object.
On the other hand, if there is no containing window, document, or
layer object that has expressed interest in the event,
routeEvent( ) passes the
event object to the appropriate event
handler of the object on which the event originated. The combination
of captureEvents( ) and routeEvent(
) forms the basis of the "trickle-down" event
model of Netscape 4.
See Also
Window.captureEvents( ), Window.handleEvent( ), Window.releaseEvents( ); Chapter 19