flex 中关于Tree 的详解介绍
Tree 类
继承 MovieClip > UIObject 类 > UIComponent 类 > View > ScrollView > ScrollSelectList > List 组件 > Tree
ActionScript 类名称 mx.controls.Tree
Tree 类的方法、属性和事件使您可以管理和处理 Tree 对象。
Tree 类的方法摘要
下表列出了 Tree 类的方法。
方法
描述
Tree.addTreeNode()
向 Tree 实例添加节点。
Tree.addTreeNodeAt()
在 Tree 实例中的特定位置添加节点。
Tree.getDisplayIndex()
返回给定节点的显示索引。
Tree.getIsBranch()
指定文件夹是否为分支(具有文件夹图标和展开箭头)。
Tree.getIsOpen()
指示节点是打开还是关闭。
Tree.getNodeDisplayedAt()
将树的某个显示索引映射到在该索引处显示的节点。
Tree.getTreeNodeAt()
返回在树的根上的节点。
Tree.“refresh”()
更新树。
Tree.removeAll()
从 Tree 实例中删除所有节点并刷新树。
Tree.removeTreeNodeAt()
删除在指定位置的节点并刷新树。
Tree.setIcon()
为指定的节点指定图标。
Tree.setIsBranch()
指定节点是否为分支(具有文件夹图标和展开箭头)。
Tree.setIsOpen()
打开或关闭节点。
从 UIObject 类继承的方法
下表列出了 Tree 类从 UIObject 类继承的方法。从 Tree 对象调用这些方法时,请使用 TreeInstance.methodName 的形式。
方法
描述
UIObject.createClassObject()
创建指定类的对象。
UIObject.createObject()
创建对象的子对象。
UIObject.destroyObject()
破坏组件实例。
UIObject.doLater()
在属性检查器和"组件"检查器中设置了参数之后,调用一个函数。
UIObject.getStyle()
从样式声明或对象获取样式属性。
UIObject.invalidate()
标记对象使其在到达下一个帧间隔时进行重绘。
UIObject.move()
将对象移动到要求的位置。
UIObject.redraw()
强制验证对象,以便在当前帧中绘制该对象。
UIObject.setSize()
将对象调整为所要求的大小。
UIObject.setSkin()
设置对象的外观。
UIObject.setStyle()
设置样式声明或对象的样式属性。
从 UIComponent 类继承的方法
下表列出了 Tree 类从 UIComponent 类继承的方法。从 Tree 对象调用这些方法时,请使用 TreeInstance.methodName 的形式。
方法
描述
UIComponent.getFocus()
返回对具有焦点的对象的引用。
UIComponent.setFocus()
将焦点设置到组件实例中。
从 List 类继承的方法
下表列出了 Tree 类从 List 类继承的方法。从 Tree 对象调用这些方法时,请使用 TreeInstance.methodName 的形式。
方法
描述
List.addItem()
向列表的结尾添加项目。
List.addItemAt()
将项目添加到指定索引处的列表。对于 Tree 组件,最好使用 Tree.addTreeNodeAt()。
List.getItemAt()
返回指定索引处的项目。
List.removeAll()
删除列表中的所有项目。
List.removeItemAt()
删除指定索引处的项目。
List.replaceItemAt()
用其它项目替换指定索引处的项目。
List.setPropertiesAt()
将指定的属性应用到指定的项目。
List.sortItems()
按照指定的比较函数对列表中的项目进行排序。
List.sortItemsBy()
按照指定的属性对列表中的项目进行排序。
Tree 类的属性摘要
下表列出了 Tree 类的属性。
属性
描述
Tree.dataProvider
指定 XML 数据源。
Tree.firstVisibleNode
指定显示在最顶层的第一个节点。
Tree.selectedNode
指定 Tree 实例中的一个选定节点。
Tree.selectedNodes
指定 Tree 实例中的多个选定节点。
从 UIObject 类继承的属性
下表列出了 Tree 类从 UIObject 类继承的属性。从 Tree 对象访问这些属性时,请使用 TreeInstance.propertyName 的形式。
属性
描述
UIObject.bottom
只读;对象的底边缘位置(相对于其父对象的底边缘)。
UIObject.height
只读;对象的高度,以像素为单位。
UIObject.left
只读;对象的左边缘(以像素为单位)。
UIObject.right
只读;对象的右边缘位置(相对于其父对象的右边缘)。
UIObject.scaleX
一个数字,它指示对象相对于其父对象在 x 方向上的缩放因子。
UIObject.scaleY
一个数字,它指示对象相对于其父对象在 y 方向上的缩放因子。
UIObject.top
只读;对象上边缘的位置(相对于其父对象)。
UIObject.visible
一个布尔值,它指示对象是可见的 (true) 还是不可见的 (false)。
UIObject.width
只读;对象的宽度,以像素为单位。
UIObject.x
只读;对象的左边缘(以像素为单位)。
UIObject.y
只读;对象的上边缘(以像素为单位)。
从 UIComponent 类继承的属性
下表列出了 Tree 类从 UIComponent 类继承的属性。从 Tree 对象访问这些属性时,请使用 TreeInstance.propertyName 的形式。
属性
描述
UIComponent.enabled
指示组件是否可以接收焦点和输入。
UIComponent.tabIndex
一个数字,指示文档中组件的 Tab 键顺序。
从 List 类继承的属性
下表列出了 Tree 类从 List 类继承的属性。从 Tree 对象访问这些属性时,请使用 TreeInstance.propertyName 的形式。
属性
描述
List.cellRenderer
指定要使用的类或元件以显示列表的每一行。
List.dataProvider
列表项的来源。
List.hPosition
列表的水平位置。
List.hScrollPolicy
指示是 ("on") 否 ("off") 显示水平滚动条。
List.iconField
各项目中用于指定图标的字段。
List.iconFunction
一个函数,它确定要使用的图标。
List.labelField
指定各项目中用作标签文本的字段。
List.labelFunction
一个函数,它确定各个项目的哪些字段要用作标签文本。
List.length
列表中的项目数。该属性为只读。
List.maxHPosition
当将 List.hScrollPolicy 设置为 "on" 时,列表可以向右滚动的像素数目。
List.multipleSelection
指示列表中是 (true) 否 (false) 允许多选。
List.rowCount
列表中至少可以看到一部分的行数。
List.rowHeight
列表中每行的像素高度。
List.selectable
指示列表是 (true) 否 (false) 为可选择列表。
List.selectedIndex
单选列表中的选择索引。
List.selectedIndices
多选列表中的已选择项目的数组。
List.selectedItem
单选列表中的已选择项目。该属性为只读。
List.selectedItems
多选列表中的已选择的项目对象。该属性为只读。
List.vPosition
滚动列表,以便使最顶部可见的项目为指定的数。
List.vScrollPolicy
指示是显示 ("on")、不显示 ("off") 还是在需要时显示 ("auto") 垂直滚动条。
Tree 类的事件摘要
下表列出了 Tree 类的事件。
事件
描述
Tree.nodeClose
在用户关闭节点时广播。
Tree.nodeOpen
在用户打开节点时广播。
从 UIObject 类继承的事件
下表列出了 Tree 类从 UIObject 类继承的事件。
事件
描述
UIObject.draw
当对象将要绘制它的图形时进行广播。
UIObject.hide
在对象的状态从可见变为不可见时广播。
UIObject.load
创建子对象时广播。
UIObject.move
移动了对象时广播。
UIObject.resize
在调整对象大小后广播。
UIObject.reveal
在对象的状态从不可见变为可见时广播。
UIObject.unload
卸载子对象时广播。
从 UIComponent 类继承的事件
下表列出了 Tree 类从 UIComponent 类继承的事件。
事件
描述
UIComponent.focusIn
当对象收到焦点时进行广播。
UIComponent.focusOut
当对象失去焦点时进行广播。
UIComponent.keyDown
当按下按键时进行广播。
UIComponent.keyUp
当松开按键时进行广播。
从 List 类继承的事件
下表列出了 Tree 类从 List 类继承的事件。
事件
描述
List.change
只要用户交互造成选择更改就广播。
List.itemRollOut
当指针在列表项上滑过然后又滑离时广播。
List.itemRollOver
当指针滑过列表项时进行广播。
List.scroll
滚动列表时,进行广播。