MACROMEDIA FLASH MX 2004-ACTIONSCRIPT LANGUAGE, Reference

Page: 476 / 1104

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);