Element object

Availability

Flash MX 2004.

Description

Everything that appears on the Stage is of the type Element. The following code example lets you select an element:

var el = fl.getDocumentDOM().getTimeline().layers[0].frames[0].elements[0];

Method summary for the Element object

The following methods are available for the Element object:

Method	Description
element.getPersistentData()	Retrieves the value of the data specified by the `name` parameter.
element.getTransformationPoint()	Gets the value of the specified element's transformation point.
element.hasPersistentData()	Determines whether the specified data has been attached to the specified element.
element.removePersistentData()	Removes any persistent data with the specified name that has been attached to the object.
element.setPersistentData()	Stores data with an element.
element.setTransformationPoint()	Sets the position of the element's transformation point.

Property summary for the Element object

The following properties are available for the Element object:

Property	Description
element.depth	Read-only; an integer that has a value greater than 0 for the depth of the object in the view.
element.elementType	Read-only; a string that represents the type of the specified element.
element.height	A float value that specifies the height of the element in pixels.
element.layer	Read-only; represents the Layer object on which the element is located.
element.left	Read-only; a float value that represents the left side of the element.
element.locked	A Boolean value: `true` if the element is locked; `false` otherwise.
element.matrix	A Matrix object. The `matrix` has properties `a, b, c, d, tx`, and `ty. a, b, c, d` are floating-point values; `tx` and `ty` are coordinates.
element.name	A string that specifies the name of the element, normally referred to as the Instance name.
element.rotation	An integer or float value between -180 and 180 that specifies the object's clockwise rotation, in degrees.
element.scaleX	A float value that specifies the x scale value of symbols, drawing objects, and primitive rectangles and ovals.
element.scaleY	A float value that specifies the y scale value of symbols, drawing objects, and primitive rectangles and ovals.
element.selected	A Boolean value that specifies whether the element is selected or not.
element.skewX	A float value between -180 and 180 that specifies the x skew value of symbols, drawing objects, and primitive rectangles and ovals.
element.skewY	A float value between -180 and 180 that specifies the y skew value of symbols, drawing objects, and primitive rectangles and ovals.
element.top	Read-only; top side of the element.
element.transformX	A floating-point number that specifies the x value of the selected element's transformation point, within the coordinate system of the element's parent.
element.transformY	A floating-point number that specifies the y value of the selected element's transformation point, within the coordinate system of the element's parent.
element.width	A float value that specifies the width of the element in pixels.
element.x	A float value that specifies the x value of the selected element's registration point.
element.y	A float value that specifies the y value of the selected element's registration point.

Flash CS3

Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/flash/9.0/main/00004064.html