(Dot) - MACROMEDIA FLASH MX 2004-ACTIONSCRIPT LANGUAGE Reference

. (dot)

Availability
Flash Player 4.
Usage
object.property_or_method
instancename.variable
instancename.childinstance
instancename.childinstance.variable
Parameters
An instance of a class. The object can be an instance of any of the built-in ActionScript
object
classes or a custom class. This parameter is always to the left of the dot (.) operator.
property_or_method
valid methods and properties for the built-in classes are listed in the method and property
summary tables for that class. This parameter is always to the right of the dot (.) operator.
instancename
childinstance
A variable on the Timeline of the movie clip instance name to the left of the dot
variable
( ) operator.
.
Returns
The method, property or movie clip named on the right side of the dot.
Description
Operator; used to navigate movie clip hierarchies to access nested (child) movie clips, variables, or
properties. The dot operator is also used to test or set the properties of an object or top-level class,
execute a method of an object or top-level class, or create a data structure.
For more information, see "Operator precedence and associativity" in Using ActionScript in Flash.
Example
The following example identifies the current value of the variable
:
person_mc
person_mc.hairColor
The Flash 4 authoring environment did not support dot syntax, but Flash MX 2004 files
published for Flash Player 4 can use the dot operator. The preceding example is equivalent to the
following (deprecated) Flash 4 syntax:
/person_mc:hairColor
The following example creates a new movie clip within the
created inside the movie clip called
and then populated with the current date.
true
48 Chapter 2: ActionScript Language Reference
The name of a property or method associated with an object. All the
The instance name of a movie clip.
A movie clip instance that is a child of, or nested in, another movie clip.
container_mc
hairColor
scope. Then a text field is
_root
. The text field's
autoSize
in the movie clip
property is set to