Getting Started: Tree for Flash CS3

Initializing the Tree and Populating It with ActionScript

The easiest way to create a Tree is to drag it from the Components panel to the stage. This will immediately create a Tree instance and add it to the display list. You may use the Properties panel to set some of its basic properties. An alternative way is to add the Tree component to the library, and then instantiate and add it to the display list in ActionScript:

import com.yahoo.astra.fl.controls.Tree; var mytree:Tree = new Tree(); addChild(mytree);

Here's the functional Tree component (download the FLA):

To set the content of the Tree, you need to provide an XML data source and instantiate the Tree's dataProvider with a new TreeDataProvider. The Tree content is described by ordinary XML data. The Tree preserves the parent-child relationships among nodes exactly as they exist in the XML source.

To use the TreeDataProvider, include the following code in your application:

import com.yahoo.astra.fl.controls.treeClasses.*;

The class com.yahoo.astra.fl.controls.treeClasses.TreeDataProvider is the required DataProvider type for the Tree. It receives XML as its argument and parses it appropriately to be usable by the Tree component.

The following example instantiates a Tree and supplies it with a TreeDataProvider that receives custom XML.

var myxml:XML = <node label="Root"> <node label="Folder 1"> <node label="File 1"/> <node label="File 2"/> </node> <node label="Folder 2"> <node label="File 3"/> <node label="File 4"/> </node> </node> // mytree is the instance name of your tree on Stage mytree.dataProvider = new TreeDataProvider( myxml );

For additional topics, please read Using Tree, or take a look at the Examples section for functional demonstrations. The ActionScript 3.0 Class Reference contains full details on every property, method, and style available to the Tree component.