JavaScript Examples Bible - UserWorks Technologies

154
JavaScript Examples Bible: The Essential Companion to JavaScript Bible
captureEvents(eventTypeList)
Compatibility ✓
NN2 NN3 NN4 NN6 IE3/J1 IE3/J2 IE4 IE5 IE5.5
Example
The page in Listing 16-21 is an exercise in capturing and releasing click events in
the window object. Whenever the window is capturing click events, the flash()
function runs. In that function, the event is examined so that only if the Control key
is also being held down and the name of the button starts with “button” does the
document background color flash red. For all click events (that is, those directed at
objects on the page capable of their own onClick event handlers), the click is processed
with the routeEvent() method to make sure the target buttons execute
their own onClick event handlers.
Listing 16-21: Capturing Click Events in the Window
Window Event Capture
// function to run when window captures a click event
function flash(e) {
if (e.modifiers = Event.CONTROL_MASK &&
e.target.name.indexOf(“button”) == 0) {
document.bgColor = “red”
setTimeout(“document.bgColor = ‘white’”, 500)
}
// let event continue to target
routeEvent(e)
}
// default setting to capture click events
window.captureEvents(Event.CLICK)
// assign flash() function to click events captured by window
window.onclick = flash
Turn window click event capture on or off (Default is “On”)
 
Ctrl+Click on a button to see if clicks are being captured by the window
(background color will flash red):
windowObject.captureEvents()