Flex - Controle de árvore

Introdução

O controle Tree exibe dados hierárquicos organizados como uma árvore expansível.

Declaração de Classe

A seguir está a declaração para mx.controls.Tree classe -

public class Tree 
   extends List
      implements IIMESupport

Propriedades Públicas

Sr. Não	Descrição da Propriedade
1	dataDescriptor : mx.controls.treeClasses:ITreeDataDescriptor Retorna o ITreeDataDescriptor atual.
2	dataProvider : Object [substituir] Um objeto que contém os dados a serem exibidos.
3	dragMoveEnabled : Boolean [substituir] Indica que os itens podem ser movidos em vez de apenas copiados do controle Tree como parte de uma operação de arrastar e soltar.
4	firstVisibleItem : Object O item que é exibido atualmente na linha superior da árvore.
5	hasRoot : Boolean [somente leitura] Indica que o dataProvider atual tem um item raiz; por exemplo, um único nó superior em uma estrutura hierárquica.
6	itemIcons : Object Um objeto que especifica os ícones dos itens.
7	maxHorizontalScrollPosition : Number [substituir] O valor máximo da propriedade maxHorizontalScrollPosition do controle Tree.
8	openItems : Object Os itens que foram abertos ou configurados como abertos.
9	showRoot : Boolean Define a visibilidade do item raiz.

Métodos Públicos

Sr. Não	Método e Descrição
1	Tree() Construtor.
2	expandChildrenOf(item:Object, open:Boolean):void Abre ou fecha todos os itens da árvore abaixo do item especificado.
3	expandItem(item:Object, open:Boolean, animate:Boolean = false, dispatchEvent:Boolean = false, cause:Event = null):void Abre ou fecha um item de filial.
4	getParentItem(item:Object):* Retorna o pai conhecido de um item filho.
5	isItemOpen(item:Object):Boolean Retorna verdadeiro se a ramificação do item especificado estiver aberta (mostrando seus filhos).
6	setItemIcon(item:Object, iconID:Class, iconID2:Class):void Define o ícone associado ao item.

Métodos Protegidos

Sr. Não	Método e Descrição
1	dragCompleteHandler(event:DragEvent):void [substituir] Manipula eventos DragEvent.DRAG_COMPLETE.
2	dragDropHandler(event:DragEvent):void [substituir] Manipula eventos DragEvent.DRAG_DROP.
3	initListData(item:Object, treeListData:mx.controls.treeClasses:TreeListData):void Inicializa um objeto TreeListData que é usado pelo representante de item de árvore.
4	makeListData(data:Object, uid:String, rowNum:int):BaseListData [substituir] Cria uma nova instância de TreeListData e preenche os campos com base no item do provedor de dados de entrada.

Eventos

Sr. Não	Descrição do Evento
1	itemClose Enviado quando uma ramificação é fechada ou recolhida.
2	itemOpen Enviado quando uma filial é aberta ou expandida.
3	itemOpening Enviado quando uma filial é aberta ou fechada.

Métodos herdados

Esta classe herda métodos das seguintes classes -

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

Exemplo de Flex Tree Control

Vamos seguir as etapas a seguir para verificar o uso do controle Tree em um aplicativo Flex, criando um aplicativo de teste -

Degrau	Descrição
1	Crie um projeto com um nome HelloWorld em um pacote com.tutorialspoint.client conforme explicado no capítulo Flex - Criar aplicativo .
2	Modifique HelloWorld.mxml conforme explicado abaixo. Mantenha o resto dos arquivos inalterados.
3	Compile e execute o aplicativo para ter certeza de que a lógica de negócios está funcionando de acordo com os requisitos.

A seguir está o conteúdo do arquivo mxml modificado 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: {[email protected]}" />
         </s:Panel>		
      </s:VGroup>	 
   </s:BorderContainer>	
</s:Application>

Quando estiver pronto com todas as alterações feitas, vamos compilar e executar o aplicativo no modo normal como fizemos no capítulo Flex - Criar aplicativo . Se tudo estiver bem com sua aplicação, ele produzirá o seguinte resultado: [ Experimente online ]

↰ Previous page