Adobe Extending Flash Professional CS5 - Manual (Page 528)

506
Last updated 5/2/2011
Chapter 47: Tools object
Availability
Flash MX 2004.
Description
The Tools object is accessible from the flash object (
fl.tools ). The tools.toolObjs property contains an array of
ToolObj objects, and the tools.activeTool property returns the ToolObj object for the currently active tool. (See
also ToolObj object and the list of Extensible tools in “ Top-Level Functions and Methods ” on page 14.)
Note: The following methods and properties are used only when creating extensible tools.
Method summary
The following methods are available for the Tools object:
Property summary
The following properties are available for the Tools object:
tools.activeTool
Availability
Flash MX 2004.
Method Description
tools.constrainPoint() Takes two points and returns a new adjusted or constrained point.
tools.getKeyDown() Returns the most recently pressed key.
“ tools.setCreatingBbox() ” on
page 510
PLACEHOLDER
tools.setCursor() Sets the pointer to a specified appearance.
tools.snapPoint() Takes a point as input and returns a new point that may be adjusted or snapped to the
nearest geometric object.
Property Description
tools.activeTool Read-only; returns the ToolObj object for the currently active tool.
tools.altIsDown Read-only; a Boolean value that identifies if the Alt key is being pressed.
tools.ctlIsDown Read-only; a Boolean value that identifies if the Control key is being pressed.
tools.mouseIsDown Read-only; a Boolean value that identifies if the left mouse button is currently pressed.
tools.penDownLoc Read-only; a point that represents the position of the last mouse-down event on the Stage.
tools.penLoc Read-only; a point that represents the current location of the mouse.
tools.shiftIsDown Read-only; a Boolean value that identifies if the Shift key is being pressed.
tools.toolObjs Read-only; an array of ToolObj objects.