Flex 3入门教程: 使用 Tree 控件

Tree控件是一个枝和叶节点分层次的机构。树中没每一个条目叫做节点，节点既可以作为枝也可以作为叶。枝节点可以包含叶或枝节点，或者为空。一个叶节点就是一个树的末梢。本快速指南包含一些开发者在使用Treecontrols经常会遇到的一些挑战。

使用XMLLISTCOLLECTION 和ARRAYCOLLECTION对象的对比。

你也许想知道，在运行时从远程或本地得来的数据被动态修改的时候，应该使用XMLListCollection对象还是ArrayCollection对象作为Tree空间的数据提供者。

如果你使用的数据源提供成形的XML，并且，你想在Tree控件中操作 XML数据。你应该使用XMLListCollection对象作为数据提供者。当使用MXML标记时，如果数据源是XMLList对象，你应该把它绑定到XMLLsitCollection对象的source属性上，然后把 XMLListCollection对象绑定到Tree控件的dataProvider属性上。

当你想要动态改变对象值时，不要使用XMLList或XML对象直接绑定到Tree控件的dataProvider属性上。当数据源是RPC(远程过程调用)服务的lastResult属性，并且你想使用XML数据，确保RPC组件的resultFormat属性被设置成e4x，当你使用e4x结果格式，最总结果就是XMLList，可以绑定在XMLListCollection对象上。

这里有一个例子。为例数据被动态改变，使用ArrayCollection对象作为Tree控件的数据提供器。当使用MXML标记时，如果你期望动态的改变Arrayl，你不应该把Array对象直接绑定到Tree控件的dataProvider属性上。作为代替，你应该绑定Array到一个ArrayCollection对象的source属性上，然后再把ArrayCollection对象绑定到Tree控件的dataProvider属性上。

当数据源是RPC(远程过程调用)服务的lastResult对象，并且RPC组件的resultFormat属性被成object，你应该使用ArrayUtil.toArray()方法来确保对象是一个Array。然后绑定到ArrayCollection对象上，就像下边的例子所示：

 

1. <mx:ArrayCollection
2.     id="employeeAC"
3.     source= "{ArrayUtil.toArray(employeeSrv.lastResult.employees.employee)}"/>

在运行时增加和删除叶子节点

你可以在运行时为Tree控件增加或删除叶子节点。下边的例子包含的代码来实现这种改变。这个程序使用预定义的枝和叶来初始化，表现公司部门和员工。你可以向任意枝节点增加叶节点在运行时。你也可以删除预定义的叶节点和你在运行时增加的节点。

在这个例子中的XML包含两种不同的元素名字，department和employee。Tree控件的label函数，决定根据元素的类型应该显示那些文本。它使用了E4X语法来返回department的title，或者employee的name。然后，这些语法在addEmployee()和removeEmployee()中会用到。

为了增加员工到业务部门，addEmployee()方法使用E4X语法，通过title属性的值获得业务部门的节点，并把它保存到XMLList类型的变量dept中。然后，通过调用dept.appendChild()方法向操作节点添加子结点。remove方法保存当前被选择的元素到变量node中，node的类型是XML。调用node.localName()方法确定被选择的元素是否是employee节点。如果是employee节点，删除它。

例子

1. <?xml version="1.0" encoding="utf-8"?>
2. <mx:Application xmlns:mx="http://www.adobe.com/2006/mxml" viewSourceURL="src/index.html">
3.    
4.     <mx:Script>
5.         <![CDATA[            import mx.collections.XMLListCollection;
6.            
7.             [Bindable]
8.             private var company:XML = 
9.               <list>
10.                 <department title="Finance" code="200">
11.                     <employee name="John H"/> 
12.                     <employee name="Sam K"/>
13.                 </department>
14.                 <department title="Operations" code="400"> 
15.                     <employee name="Bill C"/>
16.                     <employee name="Jill W"/>
17.                 </department>                   
18.                 <department title="Engineering" code="300"> 
19.                     <employee name="Erin M"/>
20.                     <employee name="Ann B"/>
21.                 </department>                               
22.               </list>;
23.            
24.             [Bindable] 
25.             private var companyData:XMLListCollection = new XMLListCollection(company.department);
26.            
27.             private function treeLabel(item:Object):String
28.             { 
29.                 var node:XML = XML(item);
30.                 if( node.localName() == "department" ) 
31.                     return node.@title;
32.                 else
33.                     return node.@name;
34.             }
35.             private function addEmployee():void 
36.             {
37.                 var newNode:XML = <employee/>;
38.                 newNode.@name = empName.text;
39.                 var dept:XMLList =company.department.(@title == "Operations");
40.                 if( dept.length() > 0 ) { 
41.                     dept[0].appendChild(newNode);
42.                     empName.text = "";
43.                 }
44.             } 
45.             private function removeEmployee():void
46.             {
47.                 var node:XML = XML(tree.selectedItem);
48.                 if( node == null ) return;
49.                 if( node.localName() != "employee" ) return;
50.            
51.                 var children:XMLList = XMLList(node.parent()).children();
52.                 for(var i:Number=0; i < children.length(); i++) { 
53.                     if( children[i].@name == node.@name ) {
54.                         delete children[i];
55.                     } 
56.                 }
57.             }
58.         ]]>
59.     </mx:Script>
60.    
61.     <mx:Tree id="tree" top="72" left="50" dataProvider="{companyData}"
62.         labelFunction="treeLabel"
63.          height="224" width="179"/> 
64.     <mx:HBox>       
65.         <mx:Button label="Add Operations Employee" click="addEmployee()"/><mx:TextInput id="empName"/> 
66.     </mx:HBox>
67.     <mx:Button label="Remove Selected Employee" click="removeEmployee()"/>   
68. </mx:Application>

 提示：可以通过右键flash查看官方源文件

在运行时添加一个空的枝节点

可以在运行时向Tree控件添加空的枝节点。下边的例子展示了通过数据提供器(data provider)API和数据描述器(data descriptor )API添加枝节点。通常，添加枝节点的首选途径是通过数据提供器(data provider)API。

addEmptyBranthDP()方法通过数据提供器API向使用XML数据提供器的Tree组件增加一个空节点，这个方法为新节点创建一个XML类型的变量，并且设置这个节点的isBranch属性为true来创建一个枝节点。然后这个方法调用Tree控件的dataProvider.addItemAt()方法来向Tree控件的数据提供器增加新的元素。

addEmptyBranchDP2()方法通过数据提供器API向使用对象数据提供器的Tree组件增加一个空节点，这个方法使用children属性创建一个新的对象，使用children属性能够确保isBranch()方法返回true。然后，这个方法调用Tree控件的dataProvider.addItemAt()方法来向Tree控件的数据提供器增加新的对象。

addEmptyBranchDD()方法通过数据描述器(data descripter)API。这个方法创建一个XML类型的变量，并且设置isBranch属性为true来创建一个枝节点。然后，这个方法调用Tree控件的dataDescriptor.addChildAt()方法来向Tree控件的数据描述器添加一个新的子节点。

例子

 

1. <?xml version="1.0" encoding="utf-8"?>
2. <mx:Application xmlns:mx="http://www.adobe.com/2006/mxml" viewSourceURL="src/index.html">    <mx:Script>
3.         <![CDATA[ 
4.             [Bindable]
5.             private var dataX:XML =
6.                 <item label="Top"> 
7.                 <item label="Child One"/>
8.                 <item label="Child Two" />
9.             </item>;
10.        
11.             [Bindable] 
12.             private var dataObj:Object =
13.                 [{label:"Top", children:
14.                 [ 
15.                 {label:"Child One"}, {label: "Child Two"}
16.                 ] 
17.                 }];
18.        
19.             // Adding a branch by going through the Tree control's dataProvider. This is
20.             // the preferred method.
21.             // Toggling the isBranch attribute to true causes DefaultDataDescriptor.isBranch()
22.             // to return true and the Tree treats the node as a branch.
23.             private function addEmptyBranchDP():void 
24.             {
25.                 var newNode:XML = <item label='Middle' isBranch="true"></item>;
26.                 xmlBound2Tree.dataProvider.addItemAt(newNode, 1);
27.             } 
28.        
29.             // For an object graph, the key point is that the children property needs to be defined,
30.             // even if it is empty.
31.             // This causes isBranch() to return true and the Tree treats the new node as a branch.
32.             private function addEmptyBranchDP2():void
33.             { 
34.                 var newObj:Object = {label:"Middle", children:[]};
35.                 objGraphBound2Tree.dataProvider.addItemAt(newObj, 1);
36.             } 
37.        
38.             // Adding a branch by going through the Tree control's dataDescriptor.
39.             private function addEmptyBranchDD():void
40.             {
41.                 var newNode:XML = <item label='Child 4' isBranch="true"></item>;
42.                 xmlBound2Tree.dataDescriptor.addChildAt(dataX, newNode, 2, dataX);
43.             } 
44.           ]]>
45.     </mx:Script> 
46.     <mx:Label text="Tree with XML data"/>
47.     <mx:Tree id="xmlBound2Tree" dataProvider="{dataX}" labelField="@label" showRoot="true" width="200"/> 
48.     <mx:Button label="Add Empty Branch through the dataProvider" click="addEmptyBranchDP();"/>
49.     <mx:Button label="Add Empty Branch through the dataDescriptor" click="addEmptyBranchDD();"/> 
50.     <mx:Spacer height="10"/>
51.     <mx:Label text="Tree with object data"/>
52.     <mx:Tree id="objGraphBound2Tree" dataProvider="{dataObj}" width="200"/> 
53.     <mx:Button label="Add Empty Branch through the dataProvider" click="addEmptyBranchDP2();"/>   
54. </mx:Application>

 

结果

打开树到指定的节点 

默认的，Tree控件在初始化后是收缩的，你也许不确定如何初始化控件时展开数，并且选定指定的节点。下边的例子，展示了如何实现它。在这个程序中，initTree()方法，在Tree控件被创建后调用。这个方法展开Tree控件的根节点，并且设置selectedIndex属性为指定节点的索引号。

1. <?xml version="1.0"?>
2. <mx:Application xmlns:mx="http://www.adobe.com/2006/mxml" viewSourceURL="src/index.html">    <mx:Script>
3.         <![CDATA[
4.             import Flash.events.*;
5.             import mx.events.*;
6.             import mx.controls.*;
7.             private function initTree():void { 
8.                 XMLTree1.expandItem(MailBox.getItemAt(0), true);
9.                 XMLTree1.selectedIndex = 2;
10.             }
11.         ]]> 
12.     </mx:Script> 
13.     <mx:Tree id="XMLTree1" width="150" height="170"
14.              labelField="@label" creationComplete="initTree();"> 
15.         <mx:XMLListCollection id="MailBox">
16.             <mx:XMLList>
17.                 <node label="Mail" data="100"> 
18.                     <node label="Inbox" data="70"/>
19.                     <node label="Personal Folder" data="10"> 
20.                         <node label="Business" data="2"/>
21.                         <node label="Demo" data="3"/> 
22.                         <node label="Saved Mail" data="5" />
23.                     </node>
24.                     <node label="Sent" data="15"/> 
25.                     <node label="Trash" data="5"/>
26.                  </node>
27.             </mx:XMLList>
28.         </mx:XMLListCollection> 
29. </mx:Tree>
30. </mx:Application>

结果

 

读取多节点名XML文档

你可以从具有多个节点名字的XML文档中组装Tree 控件。下边的例子实现了这个功能。Tree控件的数据提供者是一个XMLListCollection，它组装自一个包含folder和Pfolder元素的XMLList。Tree控件的labelField属性被设置为label属性，不管元素叫什么名字，这个属性对XMLList中的所有属性都是公共的。

例子

 

1. <?xml version="1.0"?>
2. <mx:Application xmlns:mx="http://www.adobe.com/2006/mxml" viewSourceURL="src/index.html">
3.     <mx:Tree id="tree1" dataProvider="{MailBox}" labelField="@label" showRoot="true" width="160"/>
4.     <mx:XMLListCollection id="MailBox" source="{Folders}"/>
5.      <mx:XMLList id="Folders">
6.         <folder label="Mail">
7.             <folder label="INBOX"/>
8.             <folder label="Personal Folder">
9.                 <Pfolder label="Business" />
10.                 <Pfolder label="Demo" /> 
11.                 <Pfolder label="Saved Mail" /> 
12.             </folder>
14.             <folder label="Sent" />
15.             <folder label="Trash" />
16.         </folder>
17.     </mx:XMLList>    
18. </mx:Application>

结果

 

当数据提供器更新时保持Tree控件打开

默认地，当数据提供器更新数据时Tree控件收缩。下边的例子展示了当数据提供器更新时保持Tree控件打开的方法。
在这个应用程序中，当一个用户单击Button控件时changeProvider()方法更新数据提供器。通常，这会导致Tree控件收缩。然而，Tree控件的渲染事件处理器，renderTree()方法，放置收缩的发生。当changerProvider()方法被调用，当前状态是打开的元素被保存到对象open变量中。当数据被刷新时，被命名为refreshData的Boolean类型的变量被置为true。renderTree()方法调用Tree控件的invalidateList()方法来刷新树的行。然后置refreshDate属性为false，并且重置Tree控件的打开元素属性为open对象变量，这个变量在刷新前就包含了状态是打开的元素。

例子

 

1. <?xml version="1.0" encoding="utf-8"?>
2. <mx:Application xmlns:mx="http://www.adobe.com/2006/mxml" layout="vertical" initialize="initTree()" viewSourceURL="srcview/index.html">
4.     <mx:Script>
5.         <![CDATA[
6.             [Bindable]
7.             public var open:Object = new Object();
8.             [Bindable]
10.             public var refreshData:Boolean = false;
11.             [Bindable]
12.             public var switchObj:Object = new Object();
13.             [Bindable]
15.             public var firstObj:Object = new Object();
16.             [Bindable]
18.             public var firstObj1:Object = new Object();
19.             [Bindable]
21.             public var firstObj2:Object = new Object();
22.             [Bindable]
24.             public var provider:String = "firstObj";
26.             private function initTree():void
28.             {
30.                 firstObj = new Object();
31.                 firstObj.label = "Foods";
32.                 firstObj.children = new Array();
33.                 firstObj1.label = "Fruits";
34.                 firstObj1.children = new Array();
35.                 firstObj2.label = "Oranges";
36.                 firstObj1.children[0] = firstObj2;
37.                 firstObj.children[0] = firstObj1;
38.                 switchObj = firstObj;
39.             }
41.             public function changeProvider():void
42.             {
43.                 open = SampleTree.openItems;
44.                 refreshData = true;
45.                 if (provider == "firstObj")
47.                 {
48.                     provider = "switchObj";
49.                     SampleTree.dataProvider = switchObj;
50.                 }
51.                 else
53.                 {
54.                     provider = "firstObj";
55.                     SampleTree.dataProvider = firstObj;
56.                 }
57.             }
59.             public function renderTree():void{
60.                 if(refreshData){
62.                     // Refresh all rows on next update.
63.                     SampleTree.invalidateList();
64.                     refreshData = false;
65.                     SampleTree.openItems = open;
66.                     // Validate and update the properties and layout
    分享到：
    Flex嵌入html页面 | birdeye
    • 2010-09-27 11:10
    • 浏览 2187
    • 评论(0)
    • 分类:Web前端
    • 查看更多