Package | com.greensock.transform |
Class | public class FlexTransformManager |
Inheritance | FlexTransformManager mx.containers.Canvas |
<?xml version="1.0" encoding="utf-8"?><br />
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml" layout="absolute" xmlns:transform="com.greensock.transform.>
<transform:FlexTransformManager id="myManager" width="500" height="500">
<mx:Image source="../libs/image1.png" id="myImage1" autoLoad="true" x="100" y="100" />
<mx:Image source="../libs/image2.png" id="myImage2" autoLoad="true" x="0" y="300" />
</transform:FlexTransformManager>
</mx:Application>
To make the two Images transformable, constrain their scaling to be proportional (even if the user is not holding
down the shift key), call the onScale function everytime one of the objects is scaled, lock the rotation value of each
Image (preventing rotation), and allow the delete key to appear to delete the selected Image from the stage:
<?xml version="1.0" encoding="utf-8"?>
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml" layout="absolute" xmlns:transform="com.greensock.transform. creationComplete="init()">
<mx:Script>
<![CDATA[
import com.greensock.events.TransformEvent;
private function init():void {
myManager.addEventListener(TransformEvent.SCALE, onScale, false, 0, true);
}
private function onScale($e:TransformEvent):void {
trace("Scaled " + $e.items.length + " items");
}
]]>
</mx:Script>
<transform:FlexTransformManager id="myManager" width="500" height="500" allowDelete="true" constrainScale="true" lockRotation="true">
<mx:Image source="../libs/image1.png" id="image1" autoLoad="true" x="50" y="50" />
<mx:Image source="../libs/image1.png" id="image2" autoLoad="true" x="100" y="200" />
</transform:FlexTransformManager>
</mx:Application>
Copyright 2010, GreenSock. All rights reserved. This work is subject to the terms in http://www.greensock.com/eula.html or for corporate Club GreenSock members, the software agreement that was issued with the corporate membership.
Property | Defined by | ||
---|---|---|---|
allowDelete : Boolean If true, when the user presses the DELETE (or BACKSPACE) key, the selected item(s) will be deleted (except items with
hasSelectableText set to true) [default: false ] | FlexTransformManager | ||
allowMultiSelect : Boolean If true, multiple items can be selected (by holding down the SHIFT or CONTROL keys and clicking) [default:
true ] | FlexTransformManager | ||
arrowKeysMove : Boolean If true, the arrow keys on the keyboard will move the selected items when pressed [default:
false ] | FlexTransformManager | ||
autoDeselect : Boolean When the user clicks anywhere OTHER than on one of the TransformItems, all are deselected [default:
true ] | FlexTransformManager | ||
bounds : Rectangle A Rectangle defining the boundaries for movement/scaling/rotation.
| FlexTransformManager | ||
constrainScale : Boolean To constrain items to only scaling proportionally, set this to true [default:
false ] | FlexTransformManager | ||
enabled : Boolean Enable or disable the entire FlexTransformManager.
| FlexTransformManager | ||
forceSelectionToFront : Boolean When true, new selections are forced to the front of the display list of the container DisplayObjectContainer [default:
true ] | FlexTransformManager | ||
handleFillColor : uint Controls the fill color of the handle [default:
0xFFFFFF ] | FlexTransformManager | ||
handleSize : Number Controls the handle size (in pixels) [default:
8 ] | FlexTransformManager | ||
height : Number [write-only] height
| FlexTransformManager | ||
hideCenterHandle : Boolean To hide the center scale handle, set this to true [default:
false | FlexTransformManager | ||
ignoredObjects : Array Sometimes you want FlexTransformManager to ignore clicks on certain DisplayObjects, like buttons, color pickers, etc.
| FlexTransformManager | ||
items : Array [read-only] All of the TransformItem instances that are managed by this FlexTransformManager (regardless of whether or not they're selected)
| FlexTransformManager | ||
lineColor : uint Controls the line color of the selection box and handles [default:
0x3399FF ] | FlexTransformManager | ||
lockPosition : Boolean Prevents moving [default:
false ] | FlexTransformManager | ||
lockRotation : Boolean Prevents rotating [default:
false ] | FlexTransformManager | ||
lockScale : Boolean Prevents scaling [default:
false ] | FlexTransformManager | ||
manager : TransformManager
[read-only] The TransformManager instance associated with the FlexTransformManager
| FlexTransformManager | ||
paddingForRotation : Number Determines the amount of space outside each of the four corner scale handles that will trigger rotation mode [default:
12 ] | FlexTransformManager | ||
scaleFromCenter : Boolean If true, scaling occurs from the center of the selection instead of the corners.
| FlexTransformManager | ||
selectedItems : Array The currently selected TransformItems (for the associated DisplayObjects, use
selectedTargetObjects ) | FlexTransformManager | ||
selectedTargetObjects : Array The currently selected targetObjects (DisplayObjects).
| FlexTransformManager | ||
selectionRotation : Number The rotation of the overall selection box
| FlexTransformManager | ||
selectionScaleX : Number The scaleX of the overall selection box
| FlexTransformManager | ||
selectionScaleY : Number The scaleY of the overall selection box
| FlexTransformManager | ||
selectionX : Number The x-coordinte of the overall selection box (same as the origin)
| FlexTransformManager | ||
selectionY : Number The y-coordinte of the overall selection box (same as the origin)
| FlexTransformManager | ||
targetObjects : Array [read-only] All of the targetObjects (DisplayObjects) that are managed by this FlexTransformManager (regardless of whether or not they're selected)
| FlexTransformManager | ||
transformManager : TransformManager
[read-only] The TransformManager instances associated with this FlexTransformManager
| FlexTransformManager | ||
width : Number [write-only] width
| FlexTransformManager |
Method | Defined by | ||
---|---|---|---|
FlexTransformManager($vars:Object = null)
Constructor
| FlexTransformManager | ||
addChild($child:DisplayObject):DisplayObject
Adds a child and performs an addItem() so that the new child is managed.
| FlexTransformManager | ||
addChildAt($child:DisplayObject, $index:int):DisplayObject
Adds a child at a particular index and then performs an addItem() to ensure the item is managed
| FlexTransformManager | ||
addEventListener($type:String, $listener:Function, $useCapture:Boolean = false, $priority:int = 0, $useWeakReference:Boolean = false):void
Allows listening for the following events:
| FlexTransformManager | ||
addIgnoredObject($object:DisplayObject):void
Allows you to have FlexTransformManager ignore clicks on a particular DisplayObject (handy for buttons, color pickers, etc.).
| FlexTransformManager | ||
addItem($targetObject:DisplayObject, $scaleMode:String = "scaleNormal", $hasSelectableText:Boolean = false):TransformItem
In order for a DisplayObject to be managed by FlexTransformManger, it must first be added via
addItem() . | FlexTransformManager | ||
addItems($targetObjects:Array, $scaleMode:String = "scaleNormal", $hasSelectableText:Boolean = false):Array
Same as addItem() but accepts an Array containing multiple DisplayObjects.
| FlexTransformManager | ||
applyFullXML(xml:XML, defaultParent:DisplayObjectContainer, placeholderColor:uint = 0xCCCCCC):Array
Applies XML generated by
exportFullXML() to the TransformManager instance including all settings
and each item's scale/rotation/position. | FlexTransformManager | ||
applyItemXML(xml:XML, defaultParent:DisplayObjectContainer = null, placeholderColor:uint = 0xCCCCCC):DisplayObject
Applies XML generated by
exportItemXML() to the TransformManager instance including all transform
data like scale/rotation/position. | FlexTransformManager | ||
applySettingsXML(xml:XML):void
Applies settings XML generated by
exportSettingsXML() to the TransformManager instance. | FlexTransformManager | ||
deleteSelection($e:Event = null):void
Deletes all selected items.
| FlexTransformManager | ||
deselectAll():void
Deselects all items
| FlexTransformManager | ||
deselectItem($item:*):void
Deselects a TransformItem or DisplayObject.
| FlexTransformManager | ||
destroy():void
Destroys the FlexTransformManager instance, removing all items and preparing it for garbage collection
| FlexTransformManager | ||
exportFullXML():XML
A common request is to capture the current state of each item's scale/rotation/position and the TransformManager's
settings in an easy-to-store format so that the data can be reloaded and applied later;
exportFullXML()
returns an XML object containing exactly that. | FlexTransformManager | ||
exportItemXML(targetObject:DisplayObject):XML
Exports transform data (scale/rotation/position) of a particular DisplayObject in XML format so that
it can be saved to a database or elsewhere easily and then reapplied later.
| FlexTransformManager | ||
exportSettingsXML():XML
Exports the TransformManager's settings in XML format so that it can be saved to a database or elsewhere easily
and then reapplied later.
| FlexTransformManager | ||
getItem($targetObject:DisplayObject):TransformItem
Gets the TransformItem associated with a particular DisplayObject (if any).
| FlexTransformManager | ||
getSelectionBounds(targetCoordinateSpace:DisplayObject = null):Rectangle
Gets the bounding Rectangle of the current selection (not including handles)
| FlexTransformManager | ||
getSelectionBoundsWithHandles(targetCoordinateSpace:DisplayObject = null):Rectangle
Gets the bounding Rectangle of the current selection (including handles)
| FlexTransformManager | ||
getSelectionCenter():Point
Gets the center point of the current selection
| FlexTransformManager | ||
getUnrotatedSelectionHeight():Number
Gets the height of the selection as if it were not rotated.
| FlexTransformManager | ||
getUnrotatedSelectionWidth():Number
Gets the width of the selection as if it were not rotated.
| FlexTransformManager | ||
isSelected($item:*):Boolean
Determines whether or not a particular DisplayObject or TranformItem is currently selected.
| FlexTransformManager | ||
moveSelection($x:Number, $y:Number, $dispatchEvents:Boolean = true):void
Moves the selected items by a certain number of pixels on the x axis and y axis
| FlexTransformManager | ||
moveSelectionDepthDown():void
Moves the selection down one level.
| FlexTransformManager | ||
moveSelectionDepthUp():void
Moves the selection up one level.
| FlexTransformManager | ||
removeAllChildren():void
Removes all children
| FlexTransformManager | ||
removeChild($child:DisplayObject):DisplayObject
Removes a child DisplayObject
| FlexTransformManager | ||
removeChildAt($index:int):DisplayObject
Removes a child from a particular index number in the display list
| FlexTransformManager | ||
removeEventListener($type:String, $listener:Function, $useCapture:Boolean = false):void
Removes an Event listener
| FlexTransformManager | ||
removeIgnoredObject($object:DisplayObject):void
Removes an ignored DisplayObject so that its clicks are no longer ignored.
| FlexTransformManager | ||
removeItem($item:*):void
Removes an item.
| FlexTransformManager | ||
rotateSelection($angle:Number, $dispatchEvents:Boolean = true):void
Rotates the selected items by a particular angle (in Radians).
| FlexTransformManager | ||
scaleSelection($sx:Number, $sy:Number, $dispatchEvents:Boolean = true):void
Scales the selected items along the x- and y-axis using multipliers.
| FlexTransformManager | ||
selectItem($item:*, $addToSelection:Boolean = false):void
Selects a particular TransformItem or DisplayObject (you must have already added the DisplayObject
to FlexTransformManager in order for it to be selectable - use
addItem() for that)
| FlexTransformManager | ||
selectItems($items:Array, $addToSelection:Boolean = false):void
Selects an Array of TransformItems and/or DisplayObjects.
| FlexTransformManager | ||
updateSelection($centerOrigin:Boolean = true):void
Refreshes the selection box/handles.
| FlexTransformManager |
Event | Summary | Defined by | ||
---|---|---|---|---|
FlexTransformManager | ||||
FlexTransformManager | ||||
FlexTransformManager | ||||
FlexTransformManager | ||||
FlexTransformManager | ||||
FlexTransformManager | ||||
FlexTransformManager | ||||
FlexTransformManager | ||||
FlexTransformManager | ||||
FlexTransformManager | ||||
FlexTransformManager | ||||
FlexTransformManager | ||||
FlexTransformManager | ||||
FlexTransformManager | ||||
FlexTransformManager | ||||
FlexTransformManager | ||||
FlexTransformManager | ||||
FlexTransformManager |
Constant | Defined by | ||
---|---|---|---|
VERSION : Number = 1.911 [static]
| FlexTransformManager |
allowDelete | property |
allowDelete:Boolean
[read-write] If true, when the user presses the DELETE (or BACKSPACE) key, the selected item(s) will be deleted (except items with hasSelectableText
set to true) [default: false
]
public function get allowDelete():Boolean
public function set allowDelete(value:Boolean):void
allowMultiSelect | property |
allowMultiSelect:Boolean
[read-write] If true, multiple items can be selected (by holding down the SHIFT or CONTROL keys and clicking) [default: true
]
public function get allowMultiSelect():Boolean
public function set allowMultiSelect(value:Boolean):void
arrowKeysMove | property |
arrowKeysMove:Boolean
[read-write] If true, the arrow keys on the keyboard will move the selected items when pressed [default: false
]
public function get arrowKeysMove():Boolean
public function set arrowKeysMove(value:Boolean):void
autoDeselect | property |
autoDeselect:Boolean
[read-write] When the user clicks anywhere OTHER than on one of the TransformItems, all are deselected [default: true
]
public function get autoDeselect():Boolean
public function set autoDeselect(value:Boolean):void
bounds | property |
bounds:Rectangle
[read-write]A Rectangle defining the boundaries for movement/scaling/rotation. [default:null]
Implementation public function get bounds():Rectangle
public function set bounds(value:Rectangle):void
constrainScale | property |
constrainScale:Boolean
[read-write] To constrain items to only scaling proportionally, set this to true [default: false
]
public function get constrainScale():Boolean
public function set constrainScale(value:Boolean):void
enabled | property |
enabled:Boolean
[read-write]Enable or disable the entire FlexTransformManager.
Implementation public function get enabled():Boolean
public function set enabled(value:Boolean):void
forceSelectionToFront | property |
forceSelectionToFront:Boolean
[read-write] When true, new selections are forced to the front of the display list of the container DisplayObjectContainer [default: true
]
public function get forceSelectionToFront():Boolean
public function set forceSelectionToFront(value:Boolean):void
handleFillColor | property |
handleFillColor:uint
[read-write] Controls the fill color of the handle [default: 0xFFFFFF
]
public function get handleFillColor():uint
public function set handleFillColor(value:uint):void
handleSize | property |
handleSize:Number
[read-write] Controls the handle size (in pixels) [default: 8
]
public function get handleSize():Number
public function set handleSize(value:Number):void
height | property |
height:Number
[write-only]height
Implementation public function set height(value:Number):void
hideCenterHandle | property |
hideCenterHandle:Boolean
[read-write] To hide the center scale handle, set this to true [default: false
public function get hideCenterHandle():Boolean
public function set hideCenterHandle(value:Boolean):void
ignoredObjects | property |
ignoredObjects:Array
[read-write]Sometimes you want FlexTransformManager to ignore clicks on certain DisplayObjects, like buttons, color pickers, etc. Those items should populate the ignoreObjects Array. The DisplayObject CANNOT be a child of a targetObject.
Implementation public function get ignoredObjects():Array
public function set ignoredObjects(value:Array):void
items | property |
items:Array
[read-only]All of the TransformItem instances that are managed by this FlexTransformManager (regardless of whether or not they're selected)
Implementation public function get items():Array
lineColor | property |
lineColor:uint
[read-write] Controls the line color of the selection box and handles [default: 0x3399FF
]
public function get lineColor():uint
public function set lineColor(value:uint):void
lockPosition | property |
lockPosition:Boolean
[read-write] Prevents moving [default: false
]
public function get lockPosition():Boolean
public function set lockPosition(value:Boolean):void
lockRotation | property |
lockRotation:Boolean
[read-write] Prevents rotating [default: false
]
public function get lockRotation():Boolean
public function set lockRotation(value:Boolean):void
lockScale | property |
lockScale:Boolean
[read-write] Prevents scaling [default: false
]
public function get lockScale():Boolean
public function set lockScale(value:Boolean):void
manager | property |
manager:TransformManager
[read-only]The TransformManager instance associated with the FlexTransformManager
Implementation public function get manager():TransformManager
paddingForRotation | property |
paddingForRotation:Number
[read-write] Determines the amount of space outside each of the four corner scale handles that will trigger rotation mode [default: 12
]
public function get paddingForRotation():Number
public function set paddingForRotation(value:Number):void
scaleFromCenter | property |
scaleFromCenter:Boolean
[read-write] If true, scaling occurs from the center of the selection instead of the corners. [default: false
]
public function get scaleFromCenter():Boolean
public function set scaleFromCenter(value:Boolean):void
selectedItems | property |
selectedItems:Array
[read-write] The currently selected TransformItems (for the associated DisplayObjects, use selectedTargetObjects
)
public function get selectedItems():Array
public function set selectedItems(value:Array):void
selectedTargetObjects | property |
selectedTargetObjects:Array
[read-write] The currently selected targetObjects (DisplayObjects). For the associated TransformItems, use selectedItems
.
public function get selectedTargetObjects():Array
public function set selectedTargetObjects(value:Array):void
selectionRotation | property |
selectionRotation:Number
[read-write]The rotation of the overall selection box
Implementation public function get selectionRotation():Number
public function set selectionRotation(value:Number):void
selectionScaleX | property |
selectionScaleX:Number
[read-write]The scaleX of the overall selection box
Implementation public function get selectionScaleX():Number
public function set selectionScaleX(value:Number):void
selectionScaleY | property |
selectionScaleY:Number
[read-write]The scaleY of the overall selection box
Implementation public function get selectionScaleY():Number
public function set selectionScaleY(value:Number):void
selectionX | property |
selectionX:Number
[read-write]The x-coordinte of the overall selection box (same as the origin)
Implementation public function get selectionX():Number
public function set selectionX(value:Number):void
selectionY | property |
selectionY:Number
[read-write]The y-coordinte of the overall selection box (same as the origin)
Implementation public function get selectionY():Number
public function set selectionY(value:Number):void
targetObjects | property |
targetObjects:Array
[read-only]All of the targetObjects (DisplayObjects) that are managed by this FlexTransformManager (regardless of whether or not they're selected)
Implementation public function get targetObjects():Array
transformManager | property |
transformManager:TransformManager
[read-only]The TransformManager instances associated with this FlexTransformManager
Implementation public function get transformManager():TransformManager
width | property |
width:Number
[write-only]width
Implementation public function set width(value:Number):void
FlexTransformManager | () | constructor |
public function FlexTransformManager($vars:Object = null)
Constructor
Parameters$vars:Object (default = null ) — An object specifying any properties that should be set upon instantiation, like {scaleFromCenter:true, lockRotation:true, bounds:new Rectangle(0, 0, 500, 300)} .
|
addChild | () | method |
public override function addChild($child:DisplayObject):DisplayObject
Adds a child and performs an addItem() so that the new child is managed.
Parameters$child:DisplayObject — The child DisplayObject
|
DisplayObject — DisplayObject
|
addChildAt | () | method |
public override function addChildAt($child:DisplayObject, $index:int):DisplayObject
Adds a child at a particular index and then performs an addItem() to ensure the item is managed
Parameters$child:DisplayObject — The child DisplayObject to add
|
|
$index:int — The index number in the display list at which to add the child
|
DisplayObject — DisplayObject
|
addEventListener | () | method |
public override function addEventListener($type:String, $listener:Function, $useCapture:Boolean = false, $priority:int = 0, $useWeakReference:Boolean = false):void
Allows listening for the following events:
$type:String — Event type
|
|
$listener:Function — Listener function
|
|
$useCapture:Boolean (default = false ) — Use capture phase
|
|
$priority:int (default = 0 ) — Priority
|
|
$useWeakReference:Boolean (default = false ) — Use weak reference
|
addIgnoredObject | () | method |
public function addIgnoredObject($object:DisplayObject):void
Allows you to have FlexTransformManager ignore clicks on a particular DisplayObject (handy for buttons, color pickers, etc.). The DisplayObject CANNOT be a child of a targetObject
Parameters$object:DisplayObject — DisplayObject that should be ignored
|
addItem | () | method |
public function addItem($targetObject:DisplayObject, $scaleMode:String = "scaleNormal", $hasSelectableText:Boolean = false):TransformItem
In order for a DisplayObject to be managed by FlexTransformManger, it must first be added via addItem()
. When the
DisplayObject is added, a TransformItem instance is automatically created and associated with the DisplayObject.
If you need to set item-specific settings like minScaleX, maxScaleX, etc., you would set those via the TransformItem
instance. addItem()
returns a TransformItem instance, but you can retrieve it anytime with the getItem()
method (just pass it your DisplayObject, like var myItem:TransformItem = myManager.getItem(myDisplayObject)
.
$targetObject:DisplayObject — The DisplayObject to be managed
|
|
$scaleMode:String (default = "scaleNormal ") — Either TransformManager.SCALE_NORMAL for normal scaleX/scaleY scaling or TransformManager.SCALE_WIDTH_AND_HEIGHT if you prefer that FlexTransformManager alters the width /height properties instead.
|
|
$hasSelectableText:Boolean (default = false ) — If true, this prevents dragging of the object unless clicking on the edges/border or center handle, and allows the DELETE key to be pressed without deleting the object itself. It will also force the scaleMode to TransformManager.SCALE_WIDTH_AND_HEIGHT .
|
TransformItem —
TransformItem instance
|
addItems | () | method |
public function addItems($targetObjects:Array, $scaleMode:String = "scaleNormal", $hasSelectableText:Boolean = false):Array
Same as addItem() but accepts an Array containing multiple DisplayObjects.
Parameters$targetObjects:Array — An Array of DisplayObject to be managed
|
|
$scaleMode:String (default = "scaleNormal ") — Either TransformManager.SCALE_NORMAL for normal scaleX/scaleY scaling or TransformManager.SCALE_WIDTH_AND_HEIGHT if you prefer that FlexTransformManager alters the width /height properties instead.
|
|
$hasSelectableText:Boolean (default = false ) — If true, this prevents dragging of the objects unless clicking on the edges/border or center handle, and allows the DELETE key to be pressed without deleting the object itself. It will also force the scaleMode to TransformManager.SCALE_WIDTH_AND_HEIGHT .
|
Array — An Array of corresponding TransformItems that are created
|
applyFullXML | () | method |
public function applyFullXML(xml:XML, defaultParent:DisplayObjectContainer, placeholderColor:uint = 0xCCCCCC):Array
Applies XML generated by exportFullXML()
to the TransformManager instance including all settings
and each item's scale/rotation/position. This does not load any external images/assets - you must do that separately.
Typically it's best to fully load the assets first and add them to the display list before calling applyFullXML()
.
When applyFullXML()
is called, it attempts to find the targetObjects in the display list based on their names,
but for each one that cannot be found, a new Sprite will be created and added as a placeholder, filled with the
placeholderColor
and named identically. An array of those placeholders (if any) is returned by
applyFullXML()
which makes it easy to loop through and load your images/assets directly into those
placeholder Sprites. Feel free to add visual preloaders, alter the look of the Sprites, etc.
xml:XML — An XML object containing data about the settings and each item's position/scale/rotation. This XML is typically created using exportFullXML() .
|
|
defaultParent:DisplayObjectContainer — If no items have been added to the TransformManager yet, it won't know which DisplayObjectContainer to look in for targetObjects, so it is important to explicitly tell TransformManager what default parent to use.
|
|
placeholderColor:uint (default = 0xCCCCCC ) — If an item's targetObject cannot be found in the display list (based on its name), it will create a new Sprite and fill it with this color, using it as a placeholder.
|
Array — An array of placeholders that were created for missing targetObjects (if any). You can loop through these and load your assets accordingly. Keep in mind that the placeholders will have the same name as was defined in the XML (from the original targetObject).
|
See also
applyItemXML | () | method |
public function applyItemXML(xml:XML, defaultParent:DisplayObjectContainer = null, placeholderColor:uint = 0xCCCCCC):DisplayObject
Applies XML generated by exportItemXML()
to the TransformManager instance including all transform
data like scale/rotation/position. This does not load any external images/assets - you must do that separately.
Typically it's best to fully load the asset first and add them to the display list before calling applyItemXML()
.
When applyItemXML()
is called, it attempts to find the targetObject in the display list based on
its name, but if it cannot be found, a new Sprite will be created and added as a placeholder, filled with the
placeholderColor
and named identically. To load all of the settings and every item's transform
data, use applyFullXML()
instead.
xml:XML — An XML object containing data about the item's position/scale/rotation. This XML is typically created using exportItemXML() .
|
|
defaultParent:DisplayObjectContainer (default = null ) — If no items have been added to the TransformManager yet, it won't know which DisplayObjectContainer to look in for targetObject, so it is important to explicitly tell TransformManager what default parent to use.
|
|
placeholderColor:uint (default = 0xCCCCCC ) — If the targetObject cannot be found in the display list (based on its name), it will create a new Sprite and fill it with this color, using it as a placeholder.
|
DisplayObject — The DisplayObject associated with the item (a placeholder Sprite if the targeObject wasn't found in the display list).
|
See also
applySettingsXML | () | method |
public function applySettingsXML(xml:XML):void
Applies settings XML generated by exportSettingsXML()
to the TransformManager instance.
This determines things like allowDelete, autoDeselect, lockScale, lockPosition,
etc.
xml:XML — An XML object containing settings data about the TransformManager (typically exported by exportSettingsXML() ).
|
See also
deleteSelection | () | method |
public function deleteSelection($e:Event = null):void
Deletes all selected items.
Parameters$e:Event (default = null ) — Accepts an optional Event in case you want to use this as an event handler
|
deselectAll | () | method |
public function deselectAll():void
Deselects all items
deselectItem | () | method |
public function deselectItem($item:*):void
Deselects a TransformItem or DisplayObject.
Parameters$item:* — The TransformItem or DisplayObject that should be deselected
|
destroy | () | method |
public function destroy():void
Destroys the FlexTransformManager instance, removing all items and preparing it for garbage collection
exportFullXML | () | method |
public function exportFullXML():XML
A common request is to capture the current state of each item's scale/rotation/position and the TransformManager's
settings in an easy-to-store format so that the data can be reloaded and applied later; exportFullXML()
returns an XML object containing exactly that. The TransformManager's settings and each item's transform data is
stored in the following format:
XML — An XML representation of the current state of the TransformManager instance and all of the items it is managing.
|
See also
<transformManager> <settings allowDelete="1" allowMultiSelect="1" autoDeselect="1" constrainScale="0" lockScale="1" scaleFromCenter="0" lockRotation="0" lockPosition="0" arrowKeysMove="0" forceSelectionToFront="1" lineColor="3381759" handleColor="16777215" handleSize="8" paddingForRotation="12" hideCenterHandle="0"/> <items> <item name="mc1" level="1" a="0.9999847412109375" b="0" c="0" d="0.9999847412109375" tx="79.2" ty="150.5" xOffset="-23.4" yOffset="-34.35" rawWidth="128.6" rawHeight="110.69999999999999" scaleMode="scaleNormal" hasSelectableText="0" minScaleX="-Infinity" maxScaleX="Infinity" minScaleY="-Infinity" maxScaleY="Infinity"/> <item name="mc2" level="18" a="0.7987213134765625" b="0.2907257080078125" c="-0.2907257080078125" d="0.7987213134765625" tx="222.5" ty="92.25" xOffset="0" yOffset="0" rawWidth="287.85" rawHeight="215.8" scaleMode="scaleNormal" hasSelectableText="0" minScaleX="-Infinity" maxScaleX="Infinity" minScaleY="-Infinity" maxScaleY="Infinity"/> <item name="text_ti" level="4" a="1" b="0" c="0" d="1" tx="32" ty="303.95" xOffset="-2" yOffset="-2" rawWidth="188" rawHeight="37.2" scaleMode="scaleWidthAndHeight" hasSelectableText="1" minScaleX="-Infinity" maxScaleX="Infinity" minScaleY="-Infinity" maxScaleY="Infinity"/> </items> </transformManager>
exportItemXML | () | method |
public function exportItemXML(targetObject:DisplayObject):XML
Exports transform data (scale/rotation/position) of a particular DisplayObject in XML format so that
it can be saved to a database or elsewhere easily and then reapplied later. If you'd like to export all
settings and every item's data, use the exportFullXML()
instead. exportItemXML()
returns an XML object in the following format:
targetObject:DisplayObject — The DisplayObject whose transform data you'd like to export.
|
XML — An XML object describing the targetObject's transform data (scale/rotation/position) and a few other TransformManager-related settings.
|
See also
<item name="mc1" level="1" a="0.98" b="0" c="0" d="0.9" tx="79.2" ty="150.5" xOffset="-23.4" yOffset="-34.35" rawWidth="128.6" rawHeight="110.7" scaleMode="scaleNormal" hasSelectableText="0" minScaleX="-Infinity" maxScaleX="Infinity" minScaleY="-Infinity" maxScaleY="Infinity"/>
exportSettingsXML | () | method |
public function exportSettingsXML():XML
Exports the TransformManager's settings in XML format so that it can be saved to a database or elsewhere easily
and then reapplied later. exportSettingsXML()
returns an XML object in the following format:
XML — An XML object containing settings data about the TransformManager.
|
See also
<settings allowDelete="1" allowMultiSelect="1" autoDeselect="1" constrainScale="0" lockScale="1" scaleFromCenter="0" lockRotation="0" lockPosition="0" arrowKeysMove="0" forceSelectionToFront="1" lineColor="3381759" handleColor="16777215" handleSize="8" paddingForRotation="12" hideCenterHandle="0"/>
getItem | () | method |
public function getItem($targetObject:DisplayObject):TransformItem
Gets the TransformItem associated with a particular DisplayObject (if any). This can be useful if you need to set item-specific properties like minScaleX/maxScaleX, etc.
Parameters$targetObject:DisplayObject — The DisplayObject with which the TransformItem is associated
|
TransformItem —
The associated TransformItem
|
getSelectionBounds | () | method |
public function getSelectionBounds(targetCoordinateSpace:DisplayObject = null):Rectangle
Gets the bounding Rectangle of the current selection (not including handles)
ParameterstargetCoordinateSpace:DisplayObject (default = null ) — The display object that defines the coordinate system to use.
|
Rectangle — Bounding Rectangle of the current selection (not including handles)
|
getSelectionBoundsWithHandles | () | method |
public function getSelectionBoundsWithHandles(targetCoordinateSpace:DisplayObject = null):Rectangle
Gets the bounding Rectangle of the current selection (including handles)
ParameterstargetCoordinateSpace:DisplayObject (default = null ) — The display object that defines the coordinate system to use.
|
Rectangle — Bounding Rectangle of the current selection (including handles)
|
getSelectionCenter | () | method |
public function getSelectionCenter():Point
Gets the center point of the current selection
ReturnsPoint — Center Point of the current selection
|
getUnrotatedSelectionHeight | () | method |
public function getUnrotatedSelectionHeight():Number
Gets the height of the selection as if it were not rotated.
ReturnsNumber — The unrotated selection height
|
getUnrotatedSelectionWidth | () | method |
public function getUnrotatedSelectionWidth():Number
Gets the width of the selection as if it were not rotated.
ReturnsNumber — The unrotated selection width
|
isSelected | () | method |
public function isSelected($item:*):Boolean
Determines whether or not a particular DisplayObject or TranformItem is currently selected.
Parameters$item:* — The TransformItem or DisplayObject whose selection status needs to be checked
|
Boolean — If true, the item/DisplayObject is currently selected
|
moveSelection | () | method |
public function moveSelection($x:Number, $y:Number, $dispatchEvents:Boolean = true):void
Moves the selected items by a certain number of pixels on the x axis and y axis
Parameters$x:Number — Number of pixels to move the selected items along the x-axis (can be negative or positive)
|
|
$y:Number — Number of pixels to move the selected items along the y-axis (can be negative or positive)
|
|
$dispatchEvents:Boolean (default = true ) — If false, no MOVE Events will be dispatched
|
moveSelectionDepthDown | () | method |
public function moveSelectionDepthDown():void
Moves the selection down one level.
moveSelectionDepthUp | () | method |
public function moveSelectionDepthUp():void
Moves the selection up one level.
removeAllChildren | () | method |
public override function removeAllChildren():void
Removes all children
removeChild | () | method |
public override function removeChild($child:DisplayObject):DisplayObject
Removes a child DisplayObject
Parameters$child:DisplayObject — Child to remove
|
DisplayObject — DisplayObject
|
removeChildAt | () | method |
public override function removeChildAt($index:int):DisplayObject
Removes a child from a particular index number in the display list
Parameters$index:int — Index number from which to remove the child
|
DisplayObject — DisplayObject
|
removeEventListener | () | method |
public override function removeEventListener($type:String, $listener:Function, $useCapture:Boolean = false):void
Removes an Event listener
Parameters$type:String — Type of Event
|
|
$listener:Function — Listener
|
|
$useCapture:Boolean (default = false ) — Use capture phase
|
removeIgnoredObject | () | method |
public function removeIgnoredObject($object:DisplayObject):void
Removes an ignored DisplayObject so that its clicks are no longer ignored.
Parameters$object:DisplayObject — DisplayObject that should not be ignored anymore
|
removeItem | () | method |
public function removeItem($item:*):void
Removes an item. Calling this on an item will NOT delete the DisplayObject - it just prevents it from being affected by this FlexTransformManager anymore.
Parameters$item:* — Either the DisplayObject or the associated TransformItem that should be removed
|
rotateSelection | () | method |
public function rotateSelection($angle:Number, $dispatchEvents:Boolean = true):void
Rotates the selected items by a particular angle (in Radians). This is NOT an absolute value, so if one
of the selected items' rotation property is Math.PI and you rotateSelection(Math.PI)
, the new
angle would be Math.PI 2.
$angle:Number — Angle (in Radians) that should be added to the selected items' current rotation
|
|
$dispatchEvents:Boolean (default = true ) — If false, no ROTATE events will be dispatched
|
scaleSelection | () | method |
public function scaleSelection($sx:Number, $sy:Number, $dispatchEvents:Boolean = true):void
Scales the selected items along the x- and y-axis using multipliers. Keep in mind that these are not absolute values, so if a selected item's scaleX is 2 and you scaleSelection(2, 1), its new scaleX would be 4 because 2 2 = 4.
Parameters$sx:Number — Multiplier for scaling along the selection box's x-axis (which may or may not be the same as the selected item's y-axis, depending on whether or not multiple items are selected and if any are rotated)
|
|
$sy:Number — Multiplier for scaling along the selection box's y-axis (which may or may not be the same as the selected item's y-axis, depending on whether or not multiple items are selected and if any are rotated)
|
|
$dispatchEvents:Boolean (default = true ) — If false, no SCALE events will be dispatched
|
selectItem | () | method |
public function selectItem($item:*, $addToSelection:Boolean = false):void
Selects a particular TransformItem or DisplayObject (you must have already added the DisplayObject
to FlexTransformManager in order for it to be selectable - use addItem()
for that)
$item:* — The TransformItem or DisplayObject that should be selected
|
|
$addToSelection:Boolean (default = false ) — If true, any currently selected items will remain selected and the new item/DisplayObject will be added to the selection.
|
selectItems | () | method |
public function selectItems($items:Array, $addToSelection:Boolean = false):void
Selects an Array of TransformItems and/or DisplayObjects. (you must have already added the DisplayObjects
to FlexTransformManager in order for it to be selectable - use addItem()
or addItems()
for that)
$items:Array — An Array of TransformItems and/or DisplayObjects to be selected
|
|
$addToSelection:Boolean (default = false ) — If true, any currently selected items will remain selected and the new items/DisplayObjects will be added to the selection.
|
updateSelection | () | method |
public function updateSelection($centerOrigin:Boolean = true):void
Refreshes the selection box/handles.
Parameters$centerOrigin:Boolean (default = true ) — If true, the origin (axis of rotation/scaling) will be automatically centered.
|
tmClickOff | event |
tmDelete | event |
tmDepthChange | event |
tmDestroy | event |
tmDoubleClick | event |
tmFinishInteractiveMove | event |
tmFinishInteractiveRotate | event |
tmFinishInteractiveScale | event |
tmMouseDown | event |
tmMove | event |
tmReleaseCursor | event |
tmRotate | event |
tmScale | event |
tmSeizeCursor | event |
tmSelectionChange | event |
tmStartInteractiveMove | event |
tmStartInteractiveRotate | event |
tmStartInteractiveScale | event |
VERSION | constant |
public static const VERSION:Number = 1.911