To work in ActionScript 3 with an element added in the Flash Stage we use its instance name (the name written in the Properties panel, in the box whith "<Instance Name>").
In AS3 code you can also use objects stored in the Library panel (images, symbols), without adding their instance on the Stage. This is more advantageous because multiple instances of the same object from the Library can be added dinamically and interatively in the Flash presentation, using ActionScript.

To be able to use an element from Library in AS3, it must be stored in a special class, then, this class can be accessed in your code to create and use new instances.
To store the objects from Library in a class, you must enable the option "Export for ActionScript", which is found in the "Advanced" section, in the window which is opened by right-clicking on the object in the Library panel, and choose the Properties option (see in the image below).

Try the following example.
  1. Open a new Flash document, draw a square on the Stage and convert it into a MovieClip Symbol (from Modify -> Convert to Symbol). You can give it a name, for example Square (it is usefuf to give a meaningful name for the Symbol, making it easier recognized in the Library panel).
  2. The Symbol is automatically added in the Library panel. Delete the square on the stage and open the Library panel (from Window -> Library).
  3. Right-click on the Symbol's name (Square) and choose Properties. Flash will open a window like in the image below. Click Advanced, to can access the options in the advanced zone.
    Properties objects in Library
  4. Check the "Export for ActionScript" button, it will store the Symbol in a class (whose name is added in the field "Class"), and gives the posibility to use it in the ActionScript script.
    Flash automatically adds the name of the Symbol in the Library as the class name. It can be modified, but usually it is better to have the same name for the class and object. This name appears also in the column "Linkage" in Library (as you can see in the image above).
  5. Once the "Export for ActionScript" option is enabled and the class name is set (Square), press OK. The class that represents this object is created and can be used in ActionScript code.
    - "Square" becomes a child class of a base class, specified in the field Base class (in this case "flash.display.MovieClip").
    - Now you can create and use in your ActionScript code Instances of the Square class, with the syntax:
                    var instance_name:ClassName = new ClassName();
  6. Right-click on Frame 1 in Timeline, choose Actions to open the "Actions panel", and add the following code:
    // Defines a function that creates an instance of the Square class
    // with parameters for 'x' and 'y' distance, and rotation
    function addSquare(dist_x:Number, dist_y:Number, rot_z:Number):void
      // Creates instance of Square class
      var ins_square:Square = new Square();
      // Sets the distances 'x', 'y', and rotation
      ins_square.x = dist_x;
      ins_square.y = dist_y;
      ins_square.rotationZ = rot_z;
      addChild(ins_square);         // Add the instance in the presentation
    // call this function 3 times
    addSquare(38, 38, 0);
    addSquare(130, 130, -19);
    addSquare(250, 220, -45);
    - This code creates and adds in the Flash presentation three instances of the object Square, each with different values for the distances 'x', 'y' and for rotation.
    - Press "Ctrl+Enter" to see the result.
The Flash player will display three squares like in the image below.
Example AS3 with objects in Library
- This technique can be used with any object added in Library (Symbols, images, sounds).

The Class associated to an element from Library can be edited. You can add instructions and methods that will be applied to the instances created with that class.
Right-click on the object in the Library panel, and choose Edit Class.
Add the code you want, then save the file with this class in the same folder as the FLA document (the name of the file must be the same as the name of the class).

To download the FLA file with the example from this lesson, click: ActionScript with objects from Library.

Daily Test with Code Example

Click on the HTML tag which creates an horizontal line in web page.
<br /> <em> <hr />
Some content ...
<hr />
Content under line ...
Which CSS property defines the text color?
font-style font-variant color
h2 {
  color: #cbdafb;
Click on the function which searches if a character, or text exists in a string.
indexOf() toString() split()
var str = "Web courses -";
if(str.indexOf("http://") == -1) alert("http:// isn`t in string");
else alert("http:// is in string");
Which function splits a string into an array of strings based on a separator?
array_merge() explode() implode()
$str = "apple,banana,melon,pear";
$arr = explode(",", $str);
var_export($arr);      // array (0=>"apple", 1=>"banana", 2=>"melon", 3=>"pear")
Working with objects from Library in AS3

Last accessed pages

  1. jQuery ajax() method (13427)
  2. Selection Tools (4056)
  3. Texarea with buttons to format text, colors and smiles (2773)
  4. Using file_put_contents, file_get_contents, readfile and file() (5435)
  5. Bubbles3 (47680)

Popular pages this month

  1. Qwop (3462)
  2. Drag Racer V3 (1707)
  3. Flash Games - Free online Games (810)
  4. Bubbles3 (810)
  5. Courses Web: PHP-MySQL JavaScript Ajax HTML CSS Flash-AS3 (758)