User Guide

476 Chapter 2: ActionScript Language Reference
Mouse.addListener()
Availability
Flash Player 6.
Usage
Mouse.addListener (newListener:Object)
Parameters
newListener
An object.
Returns
Nothing.
Description
Method; registers an object to receive notifications of the onMouseDown, onMouseMove,
onMouseUp, and onMouseWheel listeners. (The onMouseWheel listener is supported only in
Windows.)
The
newListener parameter should contain an object that has a defined method for at least one
of the listeners.
When the mouse is pressed, moved, released, or used to scroll, regardless of the input focus, all
listening objects that are registered with this method have their
onMouseDown, onMouseMove,
onMouseUp, or onMouseWheel method invoked. Multiple objects can listen for mouse
notifications. If the listener
newListener is already registered, no change occurs.
See also
Mouse.onMouseDown, Mouse.onMouseMove, Mouse.onMouseUp, Mouse.onMouseWheel
Example
This example is excerpted from the animation.fla file in the HelpExamples Folder.
// Create a mouse listener object
var mouseListener:Object = new Object();
/* Every time the mouse cursor moves within the SWF file,
update the position of the crosshair movie clip
instance on the Stage.*/
mouseListener.onMouseMove = function() {
crosshair_mc._x = _xmouse;
crosshair_mc._y = _ymouse;
};
/* When you click the mouse, check to see if the cursor is within the
boundaries of the Stage. If so, increment the number of shots. */
mouseListener.onMouseDown = function() {
if (bg_mc.hitTest(_xmouse, _ymouse, false)) {
_global.shots++;
}
};
Mouse.addListener(mouseListener);