User Guide

432 ActionScript classes
addListener (Mouse.addListener method)
public static addListener(listener:Object) : Void
Registers an object to receive notifications of the onMouseDown, onMouseMove, and
onMouseUp listeners.
The
listener parameter should contain an object that has a defined method for at least one
of the listeners.
When the mouse button 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, or onMouseUp method invoked. Multiple objects can listen for mouse
notifications. If the listener is already registered, no change occurs.
Note: This method is supported in Flash Lite only if
System.capabilities.hasMouse is
true or System.capabilities.hasStylus is true.
Availability: ActionScript 1.0; Flash Lite 2.0
Parameters
listener:Object - An object.
Example
This example is excerpted from the animation.fla file in the ActionScript Samples 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 press the mouse button, 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);