window.captureEvents
Table of contents
- 1. Summary
- 2. Syntax
- 3. Example
- 4. Notes
- 5. Specification
Syntax
window.captureEvents(eventType)
eventType is a combination of the following values: Event.ABORT, Event.BLUR, Event.CLICK, Event.CHANGE, Event.DBLCLICK, Event.DRAGDDROP, Event.ERROR, Event.FOCUS, Event.KEYDOWN, Event.KEYPRESS, Event.KEYUP, Event.LOAD, Event.MOUSEDOWN, Event.MOUSEMOVE, Event.MOUSEOUT, Event.MOUSEOVER, Event.MOUSEUP, Event.MOVE, Event.RESET, Event.RESIZE, Event.SELECT, Event.SUBMIT, Event.UNLOAD.
Example
<html>
<script>
function reg() {
window.captureEvents(Event.CLICK);
window.onclick = page_click;
}
function page_click() {
alert('page click event detected!');
}
</script>
<body onload="reg();">
<p>click anywhere on this page.</p>
</body>
</html>
Notes
This method is obsolete as of Gecko 1.9, in favor of W3C DOM Events methods (see addEventListener). The support for this method has been removed from Gecko 1.9.
Events raised in the DOM by user activity (such as clicking buttons or shifting focus away from the current document) generally pass through the high-level window and document objects first before arriving at the object that initiated the event.
When you call the captureEvents() method on the window, events of the type you specify (for example, Event.CLICK) no longer pass through to "lower" objects in the hierarchy. In order for events to "bubble up" in the way that they normally do, you must call window.releaseEvents() (Obsolete
) on the window to keep it from trapping events.
Note that you can pass a list of events to this method using the following syntax: window.caputureEvents(Event.KEYPRESS | Event.KEYDOWN | Event.KEYUP).
Page last modified 16:18, 27 Apr 2008 by Potappo