Flex - 樹控制元件

介紹

樹控制元件顯示以可擴充套件樹的形式排列的分層資料。

類宣告

以下是mx.controls.Tree類的宣告：

public class Tree 
   extends List
      implements IIMESupport

公共屬性

序號	屬性及描述
1	dataDescriptor : mx.controls.treeClasses:ITreeDataDescriptor 返回當前的 ITreeDataDescriptor。
2	dataProvider : Object [覆蓋] 包含要顯示的資料的物件。
3	dragMoveEnabled : Boolean [覆蓋] 指示專案可以移動，而不僅僅是從樹控制元件中複製作為拖放操作的一部分。
4	firstVisibleItem : Object 當前顯示在樹頂部行的專案。
5	hasRoot : Boolean [只讀] 指示當前 dataProvider 具有根專案；例如，分層結構中的單個頂部節點。
6	itemIcons : Object 指定專案圖示的物件。
7	maxHorizontalScrollPosition : Number [覆蓋] 樹控制元件的 maxHorizontalScrollPosition 屬性的最大值。
8	openItems : Object 已開啟或設定為開啟的專案。
9	showRoot : Boolean 設定根專案的可見性。

公共方法

序號	方法及描述
1	Tree() 建構函式。
2	expandChildrenOf(item:Object, open:Boolean):void 開啟或關閉指定專案下方的所有樹專案。
3	expandItem(item:Object, open:Boolean, animate:Boolean = false, dispatchEvent:Boolean = false, cause:Event = null):void 開啟或關閉分支專案。
4	getParentItem(item:Object):* 返回子專案的已知父級。
5	isItemOpen(item:Object):Boolean 如果指定專案分支已開啟（顯示其子項），則返回 true。
6	setItemIcon(item:Object, iconID:Class, iconID2:Class):void 設定與專案關聯的圖示。

受保護的方法

序號	方法及描述
1	dragCompleteHandler(event:DragEvent):void [覆蓋] 處理 DragEvent.DRAG_COMPLETE 事件。
2	dragDropHandler(event:DragEvent):void [覆蓋] 處理 DragEvent.DRAG_DROP 事件。
3	initListData(item:Object, treeListData:mx.controls.treeClasses:TreeListData):void 初始化樹專案渲染器使用的 TreeListData 物件。
4	makeListData(data:Object, uid:String, rowNum:int):BaseListData [覆蓋] 建立一個新的 TreeListData 例項，並根據輸入資料提供程式專案填充欄位。

事件

序號	事件及描述
1	itemClose 分支關閉或摺疊時排程。
2	itemOpen 分支開啟或展開時排程。
3	itemOpening 初始化分支開啟或關閉時排程。

序號

事件及描述

itemClose

分支關閉或摺疊時排程。

itemOpen

分支開啟或展開時排程。

itemOpening

初始化分支開啟或關閉時排程。

繼承的方法

此類繼承自以下類的方法：

mx.controls.List
mx.controls.listClasess.ListBase
mx.core.ScrollControlBase
mx.core.UIComponent
mx.core.FlexSprite
flash.display.Sprite
flash.display.DisplayObjectContainer
flash.display.InteractiveObject
flash.display.DisplayObject
flash.events.EventDispatcher
Object

Flex 樹控制元件示例

讓我們按照以下步驟，透過建立一個測試應用程式來檢查 Flex 應用程式中樹控制元件的使用：

步驟	描述
1	在包 com.tutorialspoint.client 下建立一個名為 HelloWorld 的專案，如 Flex - 建立應用程式章節中所述。
2	修改 HelloWorld.mxml，如下所述。保持其餘檔案不變。
3	編譯並執行應用程式，以確保業務邏輯按要求工作。

以下是修改後的 mxml 檔案 src/com.tutorialspoint/HelloWorld.mxml 的內容。

<?xml version = "1.0" encoding = "utf-8"?>
<s:Application xmlns:fx = "http://ns.adobe.com/mxml/2009"
   xmlns:s = "library://ns.adobe.com/flex/spark"
   xmlns:mx = "library://ns.adobe.com/flex/mx
   width = "100%" height = "100%" minWidth = "500" minHeight = "500">
   
   <fx:Style source = "/com/tutorialspoint/client/Style.css" />	
   <fx:Script>
      <![CDATA[
         [Bindable]
         public var selectedNode:XML;

         // Event handler for the Tree control change event.
         public function treeChanged(event:Event):void {
            selectedNode = Tree(event.target).selectedItem as XML;
         }
      ]]>
   </fx:Script>
   
   <fx:Declarations>
      <fx:XMLList id = "treeData">
         <node label = "E-Mail Box">
            <node label = "Inbox">
            <node label = "Client" />
               <node label = "Product" />
               <node label = "Personal" />
            </node>
            
            <node label = "Sent Items">
               <node label = "Professional" />
               <node label = "Personal" />
            </node>
            
            <node label = "Deleted Items" />
            <node label = "Spam" />
         </node>    
      </fx:XMLList>
   </fx:Declarations>
   
   <s:BorderContainer width = "630" height = "480" id = "mainContainer" 
      styleName = "container">
      <s:VGroup width = "100%" height = "100%" gap = "50" 
         horizontalAlign = "center" verticalAlign = "middle">
         <s:Label id = "lblHeader" text = "Complex Controls Demonstration" 
            fontSize = "40" color = "0x777777" styleName = "heading" />
            
         <s:Panel id = "treePanel" title = "Using Tree" 
            width = "500" height = "300">
            <s:layout>
               <s:VerticalLayout  gap = "10" verticalAlign = "middle" 
                  horizontalAlign = "center" />	
            </s:layout>
               
            <mx:Tree id = "tree" width = "95%" height = "75%" 
               labelField = "@label" showRoot = "false" 
               dataProvider = "{treeData}" change = "treeChanged(event)" />
            <s:TextArea height = "20%" width = "95%" 
               text = "Selected Item: {selectedNode.@label}" />
         </s:Panel>		
      </s:VGroup>	 
   </s:BorderContainer>	
</s:Application>

完成所有更改後，讓我們像在Flex - 建立應用程式章節中所做的那樣，以正常模式編譯並執行應用程式。如果應用程式一切正常，它將產生以下結果：[ 線上嘗試 ]

flex_complex_controls.htm

列印頁面