| 包 | mx.controls |
| 类 | public class FileSystemList |
| 继承 | FileSystemList List ListBase ScrollControlBase UIComponent FlexSprite Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
| 运行时版本: | AIR 1.1 |
要更改显示的数据,需要设置 directory 属性,而无需使用 dataProvider 属性。随后,控件将自动通过枚举该目录的内容填充 dataProvider 属性。您不应亲自设置 dataProvider。
您需要将 directory 属性设置为 File 实例,如以下示例所示:
<mx:FileSystemList directory="{File.desktopDirectory}"/>
您可以设置 enumerationMode 属性,以指定是显示文件、子目录还是同时显示两者。有三种方式可以同时显示两者:目录优先、文件优先或两者混合。
您可以设置 extensions 属性以筛选显示的项目,从而仅显示具有指定扩展名的文件。showHidden 确定控件是否显示操作系统通常隐藏的文件和子目录。您可以指定另外一个 filterFunction 执行自定义筛选,并指定 nameCompareFunction 执行自定义排序。
由于 AIR 不支持文件系统通知,因此,在创建、删除、移动或重命名文件或子目录时不会自动刷新此控件;也就是说,它可以显示文件系统的过期视图。但是,您可以调用 refresh() 重新枚举当前的 directory。例如,当您执行了某个文件操作并已知此操作将导致控件的视图过期时,或者当用户取消激活或重新激活您的应用程序时,您可以选择执行此操作。
您可以使用 showIcons 属性显示或隐藏图标,使用 showExtensions 属性显示或隐藏文件扩展名。
该控件提供了 findItem() 和 findIndex() 两种方法,您可以使用这两种方法搜索显示的文件和子目录,以查找具有指定 nativePath 的文件或子目录。
该控件还提供了 selectedPath 和 selectedPaths 两个属性,工作原理与 selectedItem 和 selectedItems 或者 selectedIndex 和 selectedIndices 类似,但允许您通过 nativePath 字符串指定选择。如果需要显示已预先选择了特定项目的目录,它们将非常有用。因为在这种情况下,您还没有在控件枚举目录时控件将创建的 File 项目,并且不知道其索引将是什么。
该控件允许用户使用鼠标或键盘导航到其它目录。用户可以尝试使用下列方法更改目录:双击子目录;选中子目录后按 Enter 键或 Ctrl-Down;在控件不显示 COMPUTER 目录时按 Ctrl-Up;在存在要导航回的“上一个”目录时按 Ctrl-Left;在存在要导航到的“下一个”目录时按 Ctrl-Right。如果用户试图更改正在显示的目录,则该控件将调度可取消的 directoryChanging 事件。如果没有通过调用 event.preventDefault() 取消此事件,则该控件将显示新目录的内容,并且 directory 属性将发生更改。无论 directory 属性在何时由于任何原因发生更改,控件都会调度 directoryChange 事件通知您。
为了支持控件进行“向上”和“向下”导航,FileSystemList 提供了 canNavigateUp 和 canNavigateDown 属性,以及 navigateUp() 和 navigateDown() 方法。还有一个 navigateTo(),可导航到任意目录。
该控件可跟踪用户曾经导航到的目录,以便支持控件进行“后退”和“前进”导航。有关详细信息,请参见 backHistory、forwardHistory、canNavigateBack 和 canNavigateForward 属性,以及 navigateBack() 和 navigateForward() 方法。
注意:针对每个项目显示的图标都是通用文件和目录图标,您可以使用 fileIcon 和 directoryIcon 样式设置它们。Flex 的基于列表的控件当前支持仅显示嵌入的图标,但不支持在运行时读取的图标。因此,FileSystemList 中不显示操作系统中显示的实际文件系统图标,即使可以通过 File 的 icon 属性在 AIR 中访问它们。
隐藏 MXML 语法The <mx:FileSystemList> tag inherits all of the tag
attributes of its superclass and adds the following tag attributes:
<mx:FileSystemList
Properties
directory="null"
enumerationMode="directoriesFirst"
extensions="null"
filterFunction="null"
nameCompareFunction="null"
selectedPath="null"
selectedPaths="null"
showExtensions="true"
showHidden="false"
showIcons="true"
Styles
directoryIcon="TreeNodeIcon"
fileIcon="TreeNodeIcon"
Events
directoryChange="No default"
directoryChanging="No default"
fileChoose="No default"
/>
另请参见
| 属性 | 定义方 | ||
|---|---|---|---|
![]() | accessibilityProperties : AccessibilityProperties 此显示对象的当前辅助功能选项。 | DisplayObject | |
![]() | activeEffects : Array [只读 (read-only)] 组件上当前播放的效果列表,如 EffectInstance 实例的 Array。 | UIComponent | |
![]() | allowDragSelection : Boolean = false 一个标志,指示是否启用拖动选择。 | ListBase | |
![]() | allowMultipleSelection : Boolean 一个标志,指示是否允许您同时选择多个项目。 | ListBase | |
![]() | alpha : Number 指示指定对象的 Alpha 透明度值。 | DisplayObject | |
![]() | automationDelegate : Object 处理自动化相关功能的委托对象。 | UIComponent | |
![]() | automationName : String 可用作此对象的标识符的名称。 | UIComponent | |
![]() | automationTabularData : Object [只读 (read-only)] IAutomationTabularData 接口的实现,可用于检索数据。 | UIComponent | |
![]() | automationValue : Array [只读 (read-only)] 此值通常对应于对象的经渲染的外观,当对象在应用中以可视方式显示时,此值使标识符与该对象相关联。 | UIComponent | |
| backHistory : Array [只读 (read-only)] 一个 File 对象 Array,表示用户可以向后导航到的目录。 | FileSystemList | ||
![]() | baselinePosition : Number [只读 (read-only)] 组件第一行文本的基线的 y 坐标。 | UIComponent | |
![]() | blendMode : String BlendMode 类中的一个值,用于指定要使用的混合模式。 | DisplayObject | |
![]() | blendShader : Shader [只写] 设置用于混合前景和背景的着色器。 | DisplayObject | |
![]() | borderMetrics : EdgeMetrics [只读 (read-only)] 返回 EdgeMetrics 对象,它具有四个属性:left、top、right 和 bottom。 | ScrollControlBase | |
![]() | buttonMode : Boolean 指定此 sprite 的按钮模式。 | Sprite | |
![]() | cacheAsBitmap : Boolean 如果设置为 true,则 Flash Player 或 Adobe AIR 将缓存显示对象的内部位图表示形式。 | DisplayObject | |
![]() | cacheHeuristic : Boolean [只写] 供 Flex 使用,表示建议为对象实施位图缓存。 | UIComponent | |
![]() | cachePolicy : String 指定此对象的位图缓存策略。 | UIComponent | |
| canNavigateBack : Boolean [只读 (read-only)] 一个标志,如果历史记录列表中至少存在一个可供用户向后导航的目录,则为 true。 | FileSystemList | ||
| canNavigateDown : Boolean [只读 (read-only)] 一个标志,如果用户可向下导航至所选目录,则为 true。 | FileSystemList | ||
| canNavigateForward : Boolean [只读 (read-only)] 一个标志,如果历史记录列表中至少存在一个可供用户向前导航的目录,则为 true。 | FileSystemList | ||
| canNavigateUp : Boolean [只读 (read-only)] 一个标志,如果用户可向上导航至父级目录,则为 true。 | FileSystemList | ||
![]() | className : String [只读 (read-only)] 此实例的类的名称,如“Button”。 | UIComponent | |
![]() | columnCount : int 在 TileList 控件中显示的列数,或在 HorizontalList 控件中显示的项目数。 | ListBase | |
![]() | columnWidth : Number 控件中列的宽度。 | ListBase | |
![]() | constructor : Object
对类对象或给定对象实例的构造函数的引用。 | Object | |
![]() | contentMouseX : Number [只读 (read-only)] 返回鼠标在内容坐标系中的 x 位置。 | UIComponent | |
![]() | contentMouseY : Number [只读 (read-only)] 返回内容坐标系中鼠标的 y 位置。 | UIComponent | |
![]() | contextMenu : NativeMenu 指定与此对象相关联的上下文菜单。 | InteractiveObject | |
![]() | currentState : String 组件的当前视图状态。 | UIComponent | |
![]() | cursorManager : ICursorManager [只读 (read-only)] 获取控制此组件及其同级组件的光标的 CursorManager。 | UIComponent | |
![]() | data : Object 将此组件用作项目渲染器或项目编辑器时,此组件应呈现的数据提供程序中的项目。 | ListBase | |
![]() | dataProvider : Object 要查看的数据集。 | ListBase | |
![]() | dataTipField : String 数据提供程序项目中作为数据提示显示的字段名称。 | ListBase | |
![]() | dataTipFunction : Function 用户提供的函数,在各个项目上运行以确定其数据提示。 | ListBase | |
![]() | descriptor : UIComponentDescriptor 引用 UIComponentDescriptor(如果有),过去曾通过 createComponentFromDescriptor() 方法使用它来创建此 UIComponent 实例。 | UIComponent | |
| directory : File 此控件显示内容所在的目录。 | FileSystemList | ||
![]() | document : Object 引用与此 UIComponent 相关联的文档对象。 | UIComponent | |
![]() | doubleClickEnabled : Boolean 指定 UIComponent 对象是否接收 doubleClick 事件。 | UIComponent | |
![]() | dragEnabled : Boolean 一个标志,指示是否可以将项目拖出此控件并放到其它控件上。 | ListBase | |
![]() | dragMoveEnabled : Boolean 一个标志,指示在拖放操作过程中是否可以移动控件中的项目,而不只是从控件中复制这些项目。 | ListBase | |
![]() | dropEnabled : Boolean 一个标志,指示是否可以将所拖动的项目放到此控件上。 | ListBase | |
![]() | dropTarget : DisplayObject [只读 (read-only)] 指定拖动 sprite 时经过的显示对象,或放置 sprite 的显示对象。 | Sprite | |
![]() | editable : Boolean = false 一个标志,指示用户能否编辑数据提供程序中的项目。 | List | |
![]() | editedItemPosition : Object 正在编辑的数据提供程序项目的项目渲染器的列索引和行索引(如果有)。 | List | |
![]() | editedItemRenderer : IListItemRenderer [只读 (read-only)] 对当前正在编辑的项目所属的 DataGrid 控件中项目渲染器的引用。 | List | |
![]() | editorDataField : String = "text" 项目编辑器的属性名称,其中包含列表项目的新数据。 | List | |
![]() | editorHeightOffset : Number = 0 项目编辑器相对于项目渲染器大小的高度(以像素为单位)。 | List | |
![]() | editorUsesEnterKey : Boolean = false 指示项目编辑器是否使用 Enter 键的标志。 | List | |
![]() | editorWidthOffset : Number = 0 项目编辑器相对于项目渲染器大小的宽度(以像素为单位)。 | List | |
![]() | editorXOffset : Number = 0 项目编辑器左上角相对于项目左上角的 x 位置(以像素为单位)。 | List | |
![]() | editorYOffset : Number = 0 项目编辑器左上角相对于项目左上角的 y 位置(以像素为单位)。 | List | |
![]() | enabled : Boolean 组件是否可以接受用户交互。 | UIComponent | |
| enumerationMode : String 一个 String,指定此控件是仅显示文件、仅显示子目录,还是两者均显示。 | FileSystemList | ||
![]() | errorString : String 当验证程序监视组件并且验证失败时,组件的错误提示中将显示的文本。 | UIComponent | |
![]() | explicitHeight : Number 指定该组件在组件坐标中显式高度(以像素为单位)的数字。 | UIComponent | |
![]() | explicitMaxHeight : Number 布局过程中父级要考虑的组件最大建议高度。 | UIComponent | |
![]() | explicitMaxWidth : Number 布局过程中父级要考虑的组件最大建议宽度。 | UIComponent | |
![]() | explicitMinHeight : Number 布局过程中父级要考虑的组件最小建议高度。 | UIComponent | |
![]() | explicitMinWidth : Number 布局过程中父级要考虑的组件最小建议宽度。 | UIComponent | |
![]() | explicitWidth : Number 指定该组件在组件坐标中显式宽度(以像素为单位)的数字。 | UIComponent | |
| extensions : Array 扩展名的 Array,指定在此控件中可以显示哪些文件。 | FileSystemList | ||
| filterFunction : Function 在应用 enumerationMode 和扩展名属性后,可用来执行其它筛选以确定显示及隐藏哪些文件和子目录的回调函数。 | FileSystemList | ||
![]() | filters : Array 包含当前与显示对象关联的每个滤镜对象的索引数组。 | DisplayObject | |
![]() | flexContextMenu : IFlexContextMenu 此 UIComponent 的上下文菜单。 | UIComponent | |
![]() | focusEnabled : Boolean 指示切换到此组件时,是否可以接收焦点。 | UIComponent | |
![]() | focusManager : IFocusManager 获取控制此组件及其同级组件的焦点的 FocusManager。 | UIComponent | |
![]() | focusPane : Sprite 与此对象相关联的焦点窗格。 | UIComponent | |
![]() | focusRect : Object 指定此对象是否显示焦点矩形。 | InteractiveObject | |
| forwardHistory : Array [只读 (read-only)] 一个 File 对象 Array,表示用户可以向前导航到的目录。 | FileSystemList | ||
![]() | graphics : Graphics [只读 (read-only)] 指定属于此 sprite 的 Graphics 对象,在此 sprite 中可执行矢量绘画命令。 | Sprite | |
![]() | height : Number 指定组件在父坐标中的高度的数字(以像素为单位)。 | UIComponent | |
![]() | hitArea : Sprite 指定一个 sprite 用作另一个 sprite 的点击区域。 | Sprite | |
![]() | horizontalScrollPolicy : String 指示水平滚动条是始终启用、始终禁用还是自动根据传递到 setScrollBarProperties() 方法的参数进行更改的属性。 | ScrollControlBase | |
![]() | horizontalScrollPosition : Number 内容与左边缘的偏移量。 | ScrollControlBase | |
![]() | iconField : String 数据提供程序对象中字段的名称,该字段用于确定显示为图标的对象。 | ListBase | |
![]() | iconFunction : Function 用户提供的函数,在每个项目上运行以确定其图标。 | ListBase | |
![]() | id : String 组件 ID。 | UIComponent | |
![]() | imeMode : String 指定 IME(输入法编辑器)模式。 | List | |
![]() | includeInLayout : Boolean 指定此组件是否包含在父容器的布局中。 | UIComponent | |
![]() | inheritingStyles : Object 此组件的继承样式链的开头内容。 | UIComponent | |
![]() | initialized : Boolean 一个标志,用于确定某个对象是否已通过布局的所有三个阶段:提交、测量和布局(假设每个阶段都是必需的)。 | UIComponent | |
![]() | instanceIndex : int [只读 (read-only)] 重复组件的索引。 | UIComponent | |
![]() | instanceIndices : Array 一个 Array,包含从此 UIComponent 对象的父文档引用该对象所需的索引。 | UIComponent | |
![]() | isDocument : Boolean [只读 (read-only)] 确定此 UIComponent 实例是否为文档对象,也就是说它是否位于 Flex 应用程序、MXML 组件或 ActionScript 组件层次结构的顶层。 | UIComponent | |
![]() | isPopUp : Boolean PopUpManager 将其设置为 true 以指示已弹出该组件。 | UIComponent | |
![]() | itemEditor : IFactory 如果将可编辑属性设置为 true,则为用于控件的项目编辑器的类工厂。 | List | |
![]() | itemEditorInstance : IListItemRenderer 对项目编辑器的当前活动实例(如果有)的引用。 | List | |
![]() | itemRenderer : IFactory 控件的自定义项目渲染器。 | ListBase | |
![]() | labelField : String 数据提供程序项目中作为标签显示的字段名称。 | ListBase | |
![]() | labelFunction : Function 用户提供的函数,在每个项目上运行以确定其标签。 | ListBase | |
![]() | listData : BaseListData 如果使用组件作为嵌入式项目渲染器或嵌入式项目编辑器,则 Flex 将使用 list 控件中的其它数据初始化组件的 listData 属性。 | ListBase | |
![]() | liveScrolling : Boolean = true 一个标志,指示移动滚动栏滑块时实时滚动视图,还是释放滑块后才更新视图。 | ScrollControlBase | |
![]() | loaderInfo : LoaderInfo [只读 (read-only)] 返回一个 LoaderInfo 对象,其中包含加载此显示对象所属的文件的相关信息。 | DisplayObject | |
![]() | mask : DisplayObject 调用显示对象被指定的 mask 对象遮罩。 | DisplayObject | |
![]() | maxHeight : Number 布局过程中父级要考虑的组件最大建议高度。 | UIComponent | |
![]() | maxHorizontalScrollPosition : Number horizontalScrollPosition 属性的最大值。 | ScrollControlBase | |
![]() | maxVerticalScrollPosition : Number verticalScrollPosition 属性的最大值。 | ScrollControlBase | |
![]() | maxWidth : Number 布局过程中父级要考虑的组件最大建议宽度。 | UIComponent | |
![]() | measuredHeight : Number 组件的默认高度(以像素为单位)。 | UIComponent | |
![]() | measuredMinHeight : Number 组件的默认最小高度(以像素为单位)。 | UIComponent | |
![]() | measuredMinWidth : Number 组件的默认最小宽度(以像素为单位)。 | UIComponent | |
![]() | measuredWidth : Number 组件的默认宽度(以像素为单位)。 | UIComponent | |
![]() | menuSelectionMode : Boolean = false 一个标志,指示是否应使用菜单样式选择。 | ListBase | |
![]() | minHeight : Number 布局过程中父级要考虑的组件最小建议高度。 | UIComponent | |
![]() | minWidth : Number 布局过程中父级要考虑的组件最小建议宽度。 | UIComponent | |
![]() | moduleFactory : IFlexModuleFactory 用于在正确的 SWF 上下文中创建 TextFields 的 moduleFactory。 | UIComponent | |
![]() | mouseChildren : Boolean 确定对象的子项是否支持鼠标。 | DisplayObjectContainer | |
![]() | mouseEnabled : Boolean 指定此对象是否接收鼠标消息。 | InteractiveObject | |
![]() | mouseFocusEnabled : Boolean 单击时是否可接收焦点。 | UIComponent | |
![]() | mouseX : Number [只读 (read-only)] 指示鼠标位置的 x 坐标,以像素为单位。 | DisplayObject | |
![]() | mouseY : Number [只读 (read-only)] 指示鼠标位置的 y 坐标,以像素为单位。 | DisplayObject | |
![]() | name : String 指示 DisplayObject 的实例名称。 | DisplayObject | |
| nameCompareFunction : Function 可用于更改文件和子目录名称的比较方式以生成排序顺序的回调函数。 | FileSystemList | ||
![]() | nestLevel : int 此对象在所属关系层次结构中的深度。 | UIComponent | |
![]() | nonInheritingStyles : Object 此组件的非继承样式链的开头内容。 | UIComponent | |
![]() | nullItemRenderer : IFactory 控件的自定义项目渲染器。 | ListBase | |
![]() | numAutomationChildren : int [只读 (read-only)] 此容器包含的自动化子项数。 | UIComponent | |
![]() | numChildren : int [只读 (read-only)] 返回此对象的子项数目。 | DisplayObjectContainer | |
![]() | offscreenExtraRowsOrColumns : int 项目渲染器的额外行或列的目标数量,供在控件布局中使用。 | ListBase | |
![]() | opaqueBackground : Object 指定显示对象是否由于具有某种背景颜色而不透明。 | DisplayObject | |
![]() | owner : DisplayObjectContainer 此 UIComponent 的所有者。 | UIComponent | |
![]() | parent : DisplayObjectContainer [只读 (read-only)] 此组件的父容器或组件。 | UIComponent | |
![]() | parentApplication : Object [只读 (read-only)] 引用包含此 UIComponent 实例的 Application 对象。 | UIComponent | |
![]() | parentDocument : Object [只读 (read-only)] 引用此 UIComponent 的父文档对象。 | UIComponent | |
![]() | percentHeight : Number 以组件父项大小百分比的方式指定组件高度的数字。 | UIComponent | |
![]() | percentWidth : Number 以组件父项大小百分比形式指定其宽度的数字。 | UIComponent | |
![]() | processedDescriptors : Boolean 临时或延迟子项创建操作后设置为 true,具体取决于发生对象。 | UIComponent | |
![]() | prototype : Object [静态]
对类或函数对象的原型对象的引用。 | Object | |
![]() | rendererIsEditor : Boolean = false 指定项目渲染器是否同时也是项目编辑器。 | List | |
![]() | repeater : IRepeater [只读 (read-only)] 对生成此 UIComponent 的父文档中 Repeater 对象的引用。 | UIComponent | |
![]() | repeaterIndex : int [只读 (read-only)] 项目在生成此 UIComponent 的 Repeater 数据提供程序中的索引。 | UIComponent | |
![]() | repeaterIndices : Array 一个 Array,包含项目在生成此 UIComponent 的父文档的 Repeater 数据提供程序中的索引。 | UIComponent | |
![]() | repeaters : Array 一个 Array,包含对生成此 UIComponent 的父文档中 Repeater 对象的引用。 | UIComponent | |
![]() | root : DisplayObject [只读 (read-only)] 对于加载的 SWF 文件中的显示对象,root 属性是此 SWF 文件所表示的显示列表树结构部分中的顶级显示对象。 | DisplayObject | |
![]() | rotation : Number 指示 DisplayObject 实例距其原始方向的旋转程度,以度为单位。 | DisplayObject | |
![]() | rotationX : Number 指示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 x 轴旋转(以度为单位)。 | DisplayObject | |
![]() | rotationY : Number 指示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 y 轴旋转(以度为单位)。 | DisplayObject | |
![]() | rotationZ : Number 指示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 z 轴旋转(以度为单位)。 | DisplayObject | |
![]() | rowCount : int 要显示的行数。 | ListBase | |
![]() | rowHeight : Number 行高(以像素为单位)。 | ListBase | |
![]() | scale9Grid : Rectangle 当前有效的缩放网格。 | DisplayObject | |
![]() | scaleX : Number 用于指定水平缩放系数的数字。 | UIComponent | |
![]() | scaleY : Number 用于指定垂直缩放系数的数字。 | UIComponent | |
![]() | scaleZ : Number 指示从对象的注册点开始应用的对象的深度缩放比例(百分比)。 | DisplayObject | |
![]() | screen : Rectangle [只读 (read-only)] 返回包含此对象的基本绘图表面大小和位置的对象。 | UIComponent | |
![]() | scrollRect : Rectangle 显示对象的滚动矩形范围。 | DisplayObject | |
![]() | scrollTipFunction : Function 将要显示的字符串作为 ScrollTip 计算的函数。 | ScrollControlBase | |
![]() | selectable : Boolean 一个标志,指示列表是否将所选项目显示为选中状态。 | ListBase | |
![]() | selectedIndex : int 所选项目的数据提供程序中的索引。 | ListBase | |
![]() | selectedIndices : Array 数据提供程序中所选项目的索引的数组。 | ListBase | |
![]() | selectedItem : Object 对数据提供程序中所选项目的引用。 | ListBase | |
![]() | selectedItems : Array 对数据提供程序中所选项目的引用的数组。 | ListBase | |
| selectedPath : String 表示所选子目录或文件的 File 项目的 nativePath;如果未选定任何项目,则为 null。 | FileSystemList | ||
| selectedPaths : Array 表示所选子目录和文件的 File 项目的 nativePath 字符串 Array。 | FileSystemList | ||
![]() | showDataTips : Boolean 一个标志,指示是否为行中的文本显示数据提示。 | ListBase | |
| showExtensions : Boolean 一个标志,指定是否显示文件名称中的扩展名。 | FileSystemList | ||
| showHidden : Boolean 一个标志,指定是否显示操作系统视为隐藏的文件和目录。 | FileSystemList | ||
| showIcons : Boolean 一个标志,指定在文件名称之前显示图标。 | FileSystemList | ||
![]() | showInAutomationHierarchy : Boolean 用于确定自动化对象是否显示在自动化层次中的标志。 | UIComponent | |
![]() | showScrollTips : Boolean = false 一个标志,指示拖动滚动滑块时是否应在其旁边显示工具提示。 | ScrollControlBase | |
![]() | soundTransform : SoundTransform 控制此 sprite 中的声音。 | Sprite | |
![]() | stage : Stage [只读 (read-only)] 显示对象的舞台。 | DisplayObject | |
![]() | states : Array 为此组件定义的视图状态。 | UIComponent | |
![]() | styleDeclaration : CSSStyleDeclaration 存储此对象的内嵌继承样式。 | UIComponent | |
![]() | styleName : Object 此组件使用的类样式。 | UIComponent | |
![]() | systemManager : ISystemManager 返回此组件使用的 SystemManager 对象。 | UIComponent | |
![]() | tabChildren : Boolean 确定对象的子项是否支持 Tab 键。 | DisplayObjectContainer | |
![]() | tabEnabled : Boolean 指定此对象是否遵循 Tab 键顺序。 | InteractiveObject | |
![]() | tabIndex : int 指定 SWF 文件中的对象按 Tab 键顺序排列。 | InteractiveObject | |
![]() | textSnapshot : TextSnapshot [只读 (read-only)] 返回此 DisplayObjectContainer 实例的 TextSnapshot 对象。 | DisplayObjectContainer | |
![]() | toolTip : String 要在 ToolTip 中显示的文本。 | UIComponent | |
![]() | transform : Transform 一个对象,具有与显示对象的矩阵、颜色转换和像素范围有关的属性。 | DisplayObject | |
![]() | transitions : Array 一个 Transition 对象 Array,其中的每个 Transition 对象都定义一组效果,用于在视图状态发生更改时播放。 | UIComponent | |
![]() | tweeningProperties : Array 当前在此对象上进行补间的属性数组。 | UIComponent | |
![]() | uid : String 对象的唯一标识符。 | UIComponent | |
![]() | updateCompletePendingFlag : Boolean 一个标志,确定某个对象是否已通过所有三个阶段的布局验证(假设需要通过所有验证)。 | UIComponent | |
![]() | useHandCursor : Boolean 布尔值,指示当鼠标滑过其 buttonMode 属性设置为 true 的 sprite 时是否显示手指形(手形光标)。 | Sprite | |
![]() | validationSubField : String 供验证程序用来将子字段与此组件相关联。 | UIComponent | |
![]() | value : Object [只读 (read-only)] 所选项目,或者所选项目的数据或标签字段。 | ListBase | |
![]() | variableRowHeight : Boolean 一个标志,指示各行是否可以采用不同的高度。 | ListBase | |
![]() | verticalScrollPolicy : String 指示垂直滚动条是始终启用、始终禁用还是自动根据传递到 setScrollBarProperties() 方法的参数进行更改的属性。 | ScrollControlBase | |
![]() | verticalScrollPosition : Number 顶边到内容的偏移量。 | ScrollControlBase | |
![]() | viewMetrics : EdgeMetrics [只读 (read-only)] 考虑滚动条(如果可见)的 EdgeMetrics 对象。 | ScrollControlBase | |
![]() | visible : Boolean 控制此 UIComponent 的可见性。 | UIComponent | |
![]() | width : Number 指定组件在父坐标中的宽度的数字(以像素为单位)。 | UIComponent | |
![]() | wordWrap : Boolean 一个标志,指示行中的文本是否应自动换行。 | ListBase | |
![]() | x : Number 指定组件在其父容器中的水平位置(以像素为单位)的数字。 | UIComponent | |
![]() | y : Number 指定组件在其父容器中的垂直位置(以像素为单位)的数字。 | UIComponent | |
![]() | z : Number 指示 DisplayObject 实例相对于 3D 父容器沿 z 轴的 z 坐标位置。 | DisplayObject | |
| 方法 | 定义方 | ||
|---|---|---|---|
构造函数。 | FileSystemList | ||
![]() | 将一个 DisplayObject 子实例添加到该 DisplayObjectContainer 实例中。 | DisplayObjectContainer | |
![]() | 将一个 DisplayObject 子实例添加到该 DisplayObjectContainer 实例中。 | DisplayObjectContainer | |
![]() | 如果正在运行数据更改效果,则添加项目渲染器。 | ListBase | |
![]() | addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象,以使侦听器能够接收事件通知。 | EventDispatcher | |
![]() | 指示安全限制是否会导致出现以下情况:在列表中忽略了使用指定 point 点调用 DisplayObjectContainer.getObjectsUnderPoint() 方法时返回的所有显示对象。 | DisplayObjectContainer | |
![]() | 返回将放置项目添加到放置目标中的位置的索引。 | ListBase | |
![]() | 排队稍后调用的函数。 | UIComponent | |
清除此控件,使其不显示任何项目。 | FileSystemList | ||
![]() | 删除此组件实例中的样式属性。 | UIComponent | |
![]() | 确定指定显示对象是 DisplayObjectContainer 实例的子项还是该实例本身。 | DisplayObjectContainer | |
![]() | 将 Point 对象由内容坐标转换为全局坐标。 | UIComponent | |
![]() | 将 Point 对象由内容坐标转换为本地坐标。 | UIComponent | |
![]() | 返回标识此容器中的子项的一组属性。 | UIComponent | |
![]() | 使用由 itemEditor 属性指定的编辑器在 editedItemPosition 为项目渲染器创建项目编辑器。 | List | |
![]() | 获取适当的渲染器,如果未指定渲染器,则使用默认渲染器。 | List | |
![]() | 在 IUIComponent 对象的父项文档对象上创建对此对象的 id 引用。 | UIComponent | |
![]() | 在 IUIComponent 对象的父项文档对象上删除对此对象的 id 引用。 | UIComponent | |
![]() | 关闭当前在某个项目上打开的项目编辑器。 | List | |
![]() | 返回与此 UIComponent 的文本样式对应的 UITextFormat 对象。 | UIComponent | |
![]() | 将事件调度到事件流中。 | UIComponent | |
![]() | 在此组件周围显示或隐藏焦点指示符。 | UIComponent | |
![]() | drawRoundRect(x:Number, y:Number, width:Number, height:Number, cornerRadius:Object = null, color:Object = null, alpha:Object = null, gradientMatrix:Matrix = null, gradientType:String = "linear", gradientRatios:Array = null, hole:Object = null):void 通过编程方式在此外观的 Graphics 对象中绘制一个矩形。 | UIComponent | |
![]() | 停止在组件上播放效果实例时,由效果实例调用。 | UIComponent | |
![]() | 开始在组件上播放效果实例时,由效果实例调用。 | UIComponent | |
![]() | 结束组件上当前播放的所有效果。 | UIComponent | |
![]() | 将数据绑定到此 UIComponent 对象。 | UIComponent | |
返回具有指定本机文件系统路径的 File 项目的索引。 | FileSystemList | ||
搜索此控件中当前显示的 File 实例,并返回一个具有指定 nativePath 属性的实例。 | FileSystemList | ||
![]() | 根据 String 查找列表中的项目,并将所选内容移至该项目。 | ListBase | |
![]() | 打印完成后调用。 | UIComponent | |
![]() | 在指定的索引位置提供自动化对象。 | UIComponent | |
![]() | 返回一个矩形,该矩形定义相对于 targetCoordinateSpace 对象坐标系的显示对象区域。 | DisplayObject | |
![]() | 返回位于指定索引处的子显示对象实例。 | DisplayObjectContainer | |
![]() | 返回具有指定名称的子显示对象。 | DisplayObjectContainer | |
![]() | 返回 DisplayObject 的 child 实例的索引位置。 | DisplayObjectContainer | |
![]() | 查找此 UIComponent 实例的类型选择器。 | UIComponent | |
![]() | 返回一个约束布局值,这与获取此组件的约束样式的方式类似。 | UIComponent | |
![]() | 确定是使用显式高度还是测量高度的一种简便方法 | UIComponent | |
![]() | 确定是使用显式宽度还是测量宽度的一种简便方法 | UIComponent | |
![]() | 获取当前具有焦点的对象。 | UIComponent | |
![]() | 返回相应的工厂;如果尚未指定,则使用默认工厂。 | ListBase | |
![]() | 返回对象的数组,这些对象位于指定点下,并且是该 DisplayObjectContainer 实例的子项(或孙子项,依此类推)。 | DisplayObjectContainer | |
![]() | 返回一个矩形,该矩形根据 targetCoordinateSpace 参数定义的坐标系定义显示对象的边界,但不包括形状上的任何笔触。 | DisplayObject | |
![]() | 返回 true 或 false 以指示是否应在目标上播放效果。 | ListBase | |
![]() | 返回 dataProvider 中由指定的 Repeater 用来生成此 Repeater 的项目;如果此 Repeater 未重复,则返回 null。 | UIComponent | |
![]() | 获取已在此组件的样式查找链中的某个位置设置过的样式属性。 | UIComponent | |
![]() | 将 Point 对象由全局坐标转换为内容坐标。 | UIComponent | |
![]() | 将 point 对象从舞台(全局)坐标转换为显示对象的(本地)坐标。 | DisplayObject | |
![]() | 将二维点从舞台(全局)坐标转换为三维显示对象的(本地)坐标。 | DisplayObject | |
![]() | 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。 | EventDispatcher | |
![]() |
指示对象是否已经定义了指定的属性。 | Object | |
![]() | 在鼠标指针下方隐藏指示允许执行拖放操作的放置指示符。 | ListBase | |
![]() | 计算显示对象,以确定它是否与 obj 显示对象重叠或相交。 | DisplayObject | |
![]() | 计算显示对象,以确定它是否与 x 和 y 参数指定的点重叠或相交。 | DisplayObject | |
![]() | 返回一个框 Matrix,在绘制水平渐变时可以将其作为 rot 参数传递给 drawRoundRect() 方法。 | UIComponent | |
![]() | 针对数据提供程序中某个项目的索引获取项目渲染器(如果存在)。 | ListBase | |
![]() | 计算 colIndex 和 rowIndex 处项目的数据提供程序中的偏移量。 | ListBase | |
![]() | 初始化此组件的内部结构。 | UIComponent | |
![]() | 初始化用于跟踪此组件的重复实例的各个属性。 | UIComponent | |
![]() | 标记组件,以便在稍后屏幕更新期间调用该组件的 updateDisplayList() 方法。 | UIComponent | |
![]() | 在下次更新时刷新所有行。 | ListBase | |
![]() | 标记组件,以便在稍后屏幕更新期间调用该组件的 commitProperties() 方法。 | UIComponent | |
![]() | 标记组件,以便在稍后屏幕更新期间调用该组件的 measure() 方法。 | UIComponent | |
![]() | 确定数据提供程序项目的项目渲染器是否可编辑。 | List | |
![]() | 确定是否加亮显示数据提供者项目的项目渲染器(当鼠标滑过它,或者通过键盘导航使它位于尖号下方时)。 | ListBase | |
![]() | 确定数据提供程序项目的项目渲染器是否可选。 | ListBase | |
![]() | 确定是否已选中数据提供程序项目的项目渲染器。 | ListBase | |
![]() | 确定渲染器是否显示某个项目。 | ListBase | |
![]() |
指示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | |
![]() | 确定渲染器是否包含(或拥有)显示对象。 | ListBase | |
![]() | 返回通过此项目渲染器呈现的该项目在数据提供程序中的项目索引。 | ListBase | |
![]() | 返回渲染器根据 dataTipField 和 dataTipFunction 属性显示给定数据对象的数据提示字符串。 | ListBase | |
![]() | 根据 iconField 和 iconFunction 属性返回表示数据项目图标的类(如果存在)。 | ListBase | |
![]() | 返回数据提供程序中给定项目的项目渲染器(如果存在)。 | ListBase | |
![]() | 返回渲染器根据 labelField 和 labelFunction 属性显示给定数据对象的字符串。 | ListBase | |
![]() | 将三维显示对象的(本地)坐标的三维点转换为舞台(全局)坐标中的二维点。 | DisplayObject | |
![]() | 将 Point 对象由本地坐标转换为内容坐标。 | UIComponent | |
![]() | 将 point 对象从显示对象的(本地)坐标转换为舞台(全局)坐标。 | DisplayObject | |
![]() | 使用当前项目渲染器测量数据提供程序中的一组项目,并返回这些项目的高度之和。 | ListBase | |
![]() | 测量指定的 HTML 文本(该文本中可能包含 <font> 和 <b> 等 HTML 标记),假定该文本显示在单行 UITextField(使用由此 UIComponent 的样式确定的 UITextFormat)中。 | UIComponent | |
![]() | 测量指定的文本,假定该文本显示在单行 UITextField(使用由此 UIComponent 的样式确定的 UITextFormat)中。 | UIComponent | |
![]() | 使用当前项目渲染器测量数据提供程序中的一组项目,并返回找到的最大宽度。 | ListBase | |
![]() | 将组件移动到其父项内的指定位置。 | UIComponent | |
更改此控件可显示 backHistory 数组中上次访问过的目录中的内容。 | FileSystemList | ||
更改此控件可显示所选子目录的内容。 | FileSystemList | ||
更改此控件可显示 forwardHistory 数组中上次访问过的目录中的内容。 | FileSystemList | ||
更改此控件可显示指定目录的内容。 | FileSystemList | ||
更改此控件可显示层次结构中上一目录的内容。 | FileSystemList | ||
![]() | 将样式更改传播到子项。 | UIComponent | |
![]() | 如果 owner 属性链从 child 指向此 UIComponent,则返回 true。 | UIComponent | |
![]() | 当在父项中添加或删除 UIComponent 对象时由 Flex 调用。 | UIComponent | |
![]() | 准备 IFlexDisplayObject 用于打印。 | UIComponent | |
![]() |
指示指定的属性是否存在、是否可枚举。 | Object | |
重新枚举此控件显示的当前目录。 | FileSystemList | ||
![]() | 为此组件构建或重新构建 CSS 样式缓存;如果 recursive 参数为 true,还会为此组件的所有后代执行同样的操作。 | UIComponent | |
![]() | 针对每个效果事件,将 EffectManager 注册为一个事件侦听器。 | UIComponent | |
![]() | 从 DisplayObjectContainer 实例的子列表中删除指定的 child DisplayObject 实例。 | DisplayObjectContainer | |
![]() | 从 DisplayObjectContainer 的子列表中指定的 index 位置删除子 DisplayObject。 | DisplayObjectContainer | |
![]() | 如果正在运行数据更改效果,则移除项目渲染器。 | ListBase | |
![]() | 从 EventDispatcher 对象中删除侦听器。 | EventDispatcher | |
![]() | 重放指定的事件。 | UIComponent | |
![]() | 使用提供的 ID 解析子项。 | UIComponent | |
![]() | [静态] 在调用 suspendBackgroundProcessing() 之后继续对使用 callLater() 排队的方法进行背景处理。 | UIComponent | |
![]() | 确保给定索引处的数据提供程序项目可见。 | ListBase | |
![]() | 调整对象大小。 | UIComponent | |
![]() | 更改现有子项在显示对象容器中的位置。 | DisplayObjectContainer | |
![]() | 设置一个布局约束值的方式,与设置此组件的约束样式的方式相同。 | UIComponent | |
![]() | 设置当前状态。 | UIComponent | |
![]() | 设置此组件的焦点。 | UIComponent | |
![]() |
设置循环操作动态属性的可用性。 | Object | |
![]() | 对此组件实例设置样式属性。 | UIComponent | |
![]() | 当 visible 属性发生更改时调用。 | UIComponent | |
![]() | 在鼠标指针下方显示拖放指示符表示允许拖放操作以及项目的放置位置。 | ListBase | |
![]() | 允许用户拖动指定的 Sprite。 | Sprite | |
![]() | 结束 startDrag() 方法。 | Sprite | |
![]() | 检测对样式属性的更改。 | UIComponent | |
![]() | 首次初始化组件样式时,Flex 会调用 stylesInitialized() 方法。 | UIComponent | |
![]() | [静态] 阻止对使用 callLater() 排队的方法进行背景处理,直到调用 resumeBackgroundProcessing() 为止。 | UIComponent | |
![]() | 交换两个指定子对象的 Z 轴顺序(从前到后顺序)。 | DisplayObjectContainer | |
![]() | 在子级列表中两个指定的索引位置,交换子对象的 Z 轴顺序(前后顺序)。 | DisplayObjectContainer | |
![]() | 返回一个字符串,用于指示此对象在应用程序的 DisplayObject 层次结构中所处的位置。 | FlexSprite | |
![]() | 如果对应于特定数据项目的项目渲染器需要移动到控件中项目渲染器的正常位置之外,则将作为数据更改效果的一部分由 UnconstrainItemAction 效果调用。 | ListBase | |
![]() | 验证子项的位置和大小,并绘制其它可视内容。 | UIComponent | |
![]() | 验证并更新此对象的属性和布局,如果需要的话重绘对象。 | UIComponent | |
![]() | 由布局逻辑用于通过调用 commitProperties() 方法来验证组件的属性。 | UIComponent | |
![]() | 如果使用此 ILayoutManagerClient 调用 LayoutManager.invalidateSize() 方法,随后在测量时调用了 validateSize() 方法,则验证组件的度量大小。 | UIComponent | |
![]() | 处理分配给此组件的验证程序调度的 valid 和 invalid 事件。 | UIComponent | |
![]() |
返回指定对象的原始值。 | Object | |
![]() | 返回一个框 Matrix,在绘制垂直渐变时可以将其作为 rot 参数传递给 drawRoundRect()。 | UIComponent | |
![]() | 检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。 | EventDispatcher | |
| 事件 | 摘要 | 定义方 | ||
|---|---|---|---|---|
![]() | [广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。 | EventDispatcher | ||
![]() | 使用 addChild() 或 addChildAt() 方法将组件作为内容子项添加到容器时调度。 | UIComponent | ||
![]() | 将显示对象添加到显示列表中时调度。 | DisplayObject | ||
![]() | 在将显示对象直接添加到舞台显示列表或将包含显示对象的子树添加至舞台显示列表中时调度。 | DisplayObject | ||
![]() | 当用户操作导致 selectedIndex 或 selectedItem 属性更改时调度此事件。 | ListBase | ||
![]() | 当用户从文本上下文菜单中选择“清除”(或“删除”)时调度。 | InteractiveObject | ||
![]() | 用户在同一 InteractiveObject 上按下并释放用户指针设备的主按钮时调度。 | InteractiveObject | ||
![]() | 当用户在 AIR 应用程序中选择与此交互式对象相关联的上下文菜单时调度。 | InteractiveObject | ||
![]() | 当用户激活特定于平台的复制操作的快捷键组合或从文本上下文菜单中选择“复制”时调度。 | InteractiveObject | ||
![]() | 当组件完成其构建、属性处理、测量、布置和绘制时调度。 | UIComponent | ||
![]() | 视图状态更改后调度。 | UIComponent | ||
![]() | 在 currentState 属性更改后但视图状态更改前调度。 | UIComponent | ||
![]() | 当用户激活特定于平台的剪切操作的快捷键组合或从文本上下文菜单中选择“剪切”时调度。 | InteractiveObject | ||
![]() | 当 data 属性更改时进行调度。 | ListBase | ||
![]() | [广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。 | EventDispatcher | ||
| 当此控件显示的目录由于某种原因发生更改时调度。 | FileSystemList | |||
| 当用户尝试更改此控件显示的目录时调度此事件。 | FileSystemList | |||
![]() | 如果 InteractiveObject 的 doubleClickEnabled 标志设置为 true,当用户在该对象上快速连续按下两次并释放指针设备的主按钮时调度。 | InteractiveObject | ||
![]() | 在拖动操作完成时(将拖动的数据放到放置目标时或在没有执行放置操作的情况下结束拖放操作时)由拖动启动器(作为要拖动的数据源的组件)调度。 | UIComponent | ||
![]() | 用户在放置目标上释放鼠标时由放置目标调度。 | UIComponent | ||
![]() | 当用户在拖动操作过程中将鼠标移动到某个组件所处的位置时,由该组件调度。 | UIComponent | ||
![]() | 用户在组件外拖动但没有将数据放置到目标时,由组件调度。 | UIComponent | ||
![]() | 在拖动操作期间,当用户在鼠标位于组件上方的情况下移动鼠标时,由组件调度。 | UIComponent | ||
![]() | 启动拖动操作时,由拖动启动器调度。 | UIComponent | ||
![]() | 在一个效果结束后调度。 | UIComponent | ||
![]() | 在即将开始播放效果前调度。 | UIComponent | ||
![]() | [播放事件] 播放头进入新帧时调度。 | DisplayObject | ||
![]() | 组件返回到根视图状态之后调度。 | UIComponent | ||
![]() | [广播事件] 播放头退出当前帧时调度。 | DisplayObject | ||
![]() | 组件退出根视图状态之前调度。 | UIComponent | ||
| 当用户通过双击文件或选择文件并按 Enter 键来选择文件时调度此事件。 | FileSystemList | |||
![]() | 显示对象获得焦点后调度。 | InteractiveObject | ||
![]() | 显示对象失去焦点后调度。 | InteractiveObject | ||
![]() | [广播事件] 在帧显示对象的构造函数运行之后但在帧脚本运行之前调度。 | DisplayObject | ||
![]() | 当对象的状态从可见变为不可见时调度。 | UIComponent | ||
![]() | 当组件完成构建并设置了所有初始化属性后调度。 | UIComponent | ||
![]() | 当组件由 Validator 监控且未通过验证时调度。 | UIComponent | ||
![]() | 当用户单击控件中的某个项目时调度此事件。 | ListBase | ||
![]() | 当用户双击控件中的某个项目时调度此事件。 | ListBase | ||
![]() | 当设置了 editedItemPosition 属性且项目可编辑时调度。 | List | ||
![]() | 当用户在某个项目上释放鼠标按键时、切换到 List 或 List 内部时,或通过任何其它方式尝试编辑项目时调度。 | List | ||
![]() | 当项目编辑会话由于任何原因结束时调度。 | List | ||
![]() | 当项目渲染器获得焦点时调度。在下列情况下项目渲染器可能获得焦点:当用户单击 List 控件中的某个项目或者使用键盘导航到该项目时。 | List | ||
![]() | 当项目渲染器失去焦点时调度。在下列情况下项目渲染器可能会失去焦点:用户单击 List 控件中的其它项目或在列表外部单击时,或使用键盘导航到 List 控件中的其它项目或导航到 List 控件外部时。 | List | ||
![]() | 当用户将鼠标指针移出控件中的某个项目时调度此事件。 | ListBase | ||
![]() | 当用户将鼠标指针滚至控件中的某个项目时调度此方法。 | ListBase | ||
![]() | 用户按下某个键时调度。 | InteractiveObject | ||
![]() | 用户尝试使用键盘导航更改焦点时调度。 | InteractiveObject | ||
![]() | 用户释放某个键时调度。 | InteractiveObject | ||
![]() | 当用户在同一 InteractiveObject 上按下并释放用户指针设备的中间按钮时调度。 | InteractiveObject | ||
![]() | 当用户在 InteractiveObject 实例上按下指针设备的中间按钮时调度。 | InteractiveObject | ||
![]() | 当用户在 InteractiveObject 实例上释放指针设备按钮时调度。 | InteractiveObject | ||
![]() | 当用户在 InteractiveObject 实例上按下指针设备按钮时调度。 | InteractiveObject | ||
![]() | 当用户在使用 PopUpManager 打开的某个组件外部单击时,从该组件调度。 | UIComponent | ||
![]() | 用户尝试使用指针设备更改焦点时调度。 | InteractiveObject | ||
![]() | 用户移动 InteractiveObject 上的指针设备时调度。 | InteractiveObject | ||
![]() | 用户将指针设备从 InteractiveObject 实例上移开时调度。 | InteractiveObject | ||
![]() | 用户将指针设备移动到 InteractiveObject 实例上时调度。 | InteractiveObject | ||
![]() | 当用户在 InteractiveObject 实例上释放指针设备按钮时调度。 | InteractiveObject | ||
![]() | 当鼠标滚轮滚动到 InteractiveObject 实例上时调度。 | InteractiveObject | ||
![]() | 当用户使用鼠标滚轮滚动到使用 PopUpManager 打开的某个组件外部时,从该组件调度。 | UIComponent | ||
![]() | 移动对象后调度。 | UIComponent | ||
![]() | 当用户释放拖动动作时由拖动启动器 InteractiveObject 调度。 | InteractiveObject | ||
![]() | 在将拖动对象放置到目标上且已通过对 DragManager.acceptDragDrop() 的调用接受该放置操作时,由目标 InteractiveObject 调度。 | InteractiveObject | ||
![]() | 当拖动动作进入其边界时由 InteractiveObject 调度。 | InteractiveObject | ||
![]() | 当拖动动作离开其边界时由 InteractiveObject 调度。 | InteractiveObject | ||
![]() | 当拖动动作保持在其边界内时,由 InteractiveObject 持续调度。 | InteractiveObject | ||
![]() | 在拖动操作开始时由在 DragManager.doDrag() 调用中指定为拖动启动器的 InteractiveObject 调度。 | InteractiveObject | ||
![]() | 在拖动操作期间由在 DragManager.doDrag() 调用中指定为拖动启动器的 InteractiveObject 调度。 | InteractiveObject | ||
![]() | 当用户激活特定于平台的粘贴操作的快捷键组合或从文本上下文菜单中选择“粘贴”时调度。 | InteractiveObject | ||
![]() | 在组件初始化序列开始时调度。 | UIComponent | ||
![]() | 使用 removeChild() 或 removeChildAt() 方法将组件作为内容子项从容器中删除时调度。 | UIComponent | ||
![]() | 将要从显示列表中删除显示对象时调度。 | DisplayObject | ||
![]() | 在从显示列表中直接删除显示对象或删除包含显示对象的子树时调度。 | DisplayObject | ||
![]() | [广播事件] 将要更新和呈现显示列表时调度。 | DisplayObject | ||
![]() | 在调整组件大小时调度。 | UIComponent | ||
![]() | 当用户在同一 InteractiveObject 上按下并释放用户指针设备的右按钮时调度。 | InteractiveObject | ||
![]() | 当用户在 InteractiveObject 实例上按下指针设备按钮时调度。 | InteractiveObject | ||
![]() | 当用户在 InteractiveObject 实例上释放指针设备按钮时调度。 | InteractiveObject | ||
![]() | 用户将指针设备从 InteractiveObject 实例上移开时调度。 | InteractiveObject | ||
![]() | 用户将指针设备移动到 InteractiveObject 实例上时调度。 | InteractiveObject | ||
![]() | 当滚动内容时调度。 | ScrollControlBase | ||
![]() | 当用户激活特定于平台的全选操作的快捷键组合或从文本上下文菜单中选择“全选”时调度。 | InteractiveObject | ||
![]() | 当对象的状态从不可见变为可见时调度。 | UIComponent | ||
![]() | 对象的 tabChildren 标志值发生更改时调度。 | InteractiveObject | ||
![]() | 对象的 tabEnabled 标志发生更改时调度。 | InteractiveObject | ||
![]() | 对象的 tabIndex 属性值发生更改时调度。 | InteractiveObject | ||
![]() | 要创建 ToolTip 时由组件调度。 | UIComponent | ||
![]() | 已隐藏组件的 ToolTip 并要将其放弃时由组件调度。 | UIComponent | ||
![]() | 要隐藏组件的 ToolTip 时由组件调度。 | UIComponent | ||
![]() | 要显示组件的 ToolTip 时由组件调度。 | UIComponent | ||
![]() | 显示组件的 ToolTip 时由组件调度。 | UIComponent | ||
![]() | 用户将鼠标移动到设置了 toolTip 属性的组件上方后,由该组件调度。 | UIComponent | ||
![]() | 当调用了对象的 commitProperties()、measure() 和 updateDisplayList() 方法后调度(如果需要)。 | UIComponent | ||
![]() | 当组件由 Validator 监控并且成功通过验证时调度。 | UIComponent | ||
![]() | 当以编程方式或通过用户交互更改值时调度。 | UIComponent | ||
| 样式 | 说明 | 定义方 | ||
|---|---|---|---|---|
![]() | 类型: Array 格式: Color CSS 继承: yes 列表中项目使用的背景色。此值是由两种或更多种颜色组成的数组。列表项目的背景色将从数组中的各种颜色之间选取。 对于 DataGrid 控件,行中的所有项目都使用相同的背景色,而每行的背景色都由颜色数组确定。 对于只使用一个列表填充二维显示的 TileList 控件,此样式可根据指定的列数、行数和颜色数生成棋盘外观、条纹或其它图案。TileList 循环使用各种颜色,根据布局方向设置各个项目的背景色。如果您的 TileList 为水平布局,并且颜色数和列数均为偶数,则显示条纹图案。如果列数为奇数,则显示棋盘图案。 仅当未指定 | ListBase | ||
![]() | 类型: Number CSS 继承: nobackgroundColor 属性定义的颜色和 backgroundImage 样式定义的图像或 SWF 文件的 Alpha 级别。有效值范围为从 0. | ScrollControlBase | ||
![]() | 类型: uint 格式: Color CSS 继承: no 组件的背景颜色。您可以同时设置 backgroundColor 和 backgroundImage。一些组件没有背景。DataGrid 控件会忽略此样式。默认值为 undefined,即不进行设置。如果此样式和 backgroundImage 样式都为 undefined,则控件将采用透明背景。 对于 Application 容器,此样式指定应用程序加载时的背景色以及运行该应用程序时的背景渐变。Flex 计算比指定颜色略深的颜色和比指定颜色略浅的颜色之间的渐变。 大多数 Flex 控件的默认外观为半透明。因此,容器的背景颜色将在某种程度上“渗入”该容器中的控件。通过将控件的 <mx: Container backgroundColor="0x66CC66"/> <mx: ControlName ... | ScrollControlBase | ||
![]() | 类型: uint 格式: Color CSS 继承: yes 禁用组件时的组件的背景颜色。全局默认值为 undefined。List 控件的默认值为 0xDDDDDD(浅灰)。如果禁用了容器,背景将变暗,而暗淡程度由 disabledOverlayAlpha 样式控制。. | ScrollControlBase | ||
![]() | 类型: Object 格式: File CSS 继承: no 组件的背景图像。此样式可以是绝对或相对 URL 或类。您可以同时设置 backgroundColor 和 backgroundImage。背景图像显示在背景色上面。默认值为 undefined,表示“未设置”。如果此样式和 backgroundColor 样式都未定义,则控件将采用透明背景。 大多数 Flex 控件的默认外观为半透明。因此,容器的背景图像将在某种程度上“渗入”该容器中的控件。通过将控件的 <mx: Container backgroundColor="0x66CC66"/> <mx: ControlName ... | ScrollControlBase | ||
![]() | 类型: String CSS 继承: no 将 backgroundImage 指定的图像缩放到不同的百分比大小。"100%" 值将拉抻该图像以适应整个组件。要指定百分比值,您必须输入百分号 (%)。Application 容器的默认值为 100%。所有其它容器的默认值为 auto,此值将保持图像的原始大小。. | ScrollControlBase | ||
![]() | 类型: String CSS 继承: no 从内容区域的上边缘到控件的基线位置的垂直距离(以像素为单位)。如果设置此样式,则组件的基线锚定在其内容区域的上边缘;调整组件容器大小后,这两个边缘将保持它们的间距。 此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器( 默认值为 | UIComponent | ||
![]() | 类型: uint 格式: Color CSS 继承: no 边框颜色。默认值取决于组件类;如果没有覆盖该类的默认值,则默认值为 0xB7BABC。. | ScrollControlBase | ||
![]() | 类型: String CSS 继承: no 边框边。指定要显示的边框边的以空格分隔的 String。此 String 可以任意顺序包含 "left"、"top"、"right" 和 "bottom"。默认值为 "left top right bottom",此值会显示所有四条边。仅当 borderStyle 为 "solid" 时才使用此样式。. | ScrollControlBase | ||
![]() | 类型: Class CSS 继承: no 组件的边框外观类。mx. | ScrollControlBase | ||
![]() | 类型: String CSS 继承: no 边框样式。可能值为 "none"、"solid"、"inset" 和 "outset"。默认值取决于组件类;如果没有覆盖该类的默认值,则默认值为 "inset"。大多数容器的默认值为 "none"。. | ScrollControlBase | ||
![]() | 类型: Number 格式: Length CSS 继承: no 边框厚度。仅在将 borderStyle 设置为 "solid" 时使用。. | ScrollControlBase | ||
![]() | 类型: String CSS 继承: no 从组件的下边缘到其内容区域的下边缘的垂直距离(以像素为单位)。如果设置此样式,则组件的下边缘锚定在其内容区域的下边缘;调整组件容器大小后,这两个边缘将保持它们的间距。 此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器( 默认值为 | UIComponent | ||
![]() | 类型: uint 格式: Color CSS 继承: yes 组件中文本(包括组件标签)的颜色。. | ScrollControlBase | ||
![]() | 类型: Number 格式: Length CSS 继承: no 组件角的半径。默认值取决于组件类;如果未覆盖类的默认值,则默认值为 0。对于 ApplicationControlBar,默认值为 5。. | ScrollControlBase | ||
directoryIcon | 类型: Class 格式: EmbeddedFile CSS 继承: no 指定表示目录的图标。默认图标位于 Assets.swf 文件中。在 MXML 中,可以使用以下语法来设置此属性: directoryIcon="@Embed(source='directoryIcon.jpg');"
默认值为 TreeNodeIcon. | FileSystemList | ||
![]() | 类型: uint 格式: Color CSS 继承: yes 禁用时组件中文本的颜色。. | ScrollControlBase | ||
![]() | 类型: Class CSS 继承: no 用于指示所拖动项目的放置位置的外观。如果拖放操作的目标位置可能是 ListBase-derived 组件,则调用 showDropFeedback() 方法将产生此类的实例,并将该实例定位在所放置项目之后项目的 itemRenderer 上方一个像素处(如果进行放置)。. | ListBase | ||
![]() | 类型: uint 格式: Color CSS 继承: yes 投影颜色。. | ScrollControlBase | ||
![]() | 类型: Boolean CSS 继承: no 指定组件是否具有可见投影的布尔值属性。此样式与 borderStyle="solid" 一起使用。默认值为 false。 注意:对于显示在容器上的投影,需设置 | ScrollControlBase | ||
![]() | 类型: uint 格式: Color CSS 继承: yes 验证失败时,组件加亮部分的颜色。验证失败时,Flex 还会将组件的 borderColor 样式设置为 errorColor。. | UIComponent | ||
fileIcon | 类型: Class 格式: EmbeddedFile CSS 继承: no 指定表示文件的图标。默认图标位于 Assets.swf 文件中。在 MXML 中,可以使用以下语法来设置此属性: fileIcon="@Embed(source='fileIcon.jpg');"
默认值为 TreeNodeIcon. | FileSystemList | ||
![]() | 类型: Number CSS 继承: no 指定焦点外观的 alpha 透明度值。. | ListBase | ||
![]() | 类型: String CSS 继承: no 焦点矩形使用的混合模式。有关详细信息,请参阅 flash. | UIComponent | ||
![]() | 类型: String CSS 继承: no 指定焦点矩形的哪些角应该是圆角。此值是使用空格分隔的 String,该 String 可以是 "tl"、"tr"、"bl" 和 "br" 的任意组合。例如,要指定右侧的角为圆角,左侧的角为直角,应使用 "tr br"。cornerRadius 样式属性指定圆角的半径。默认值取决于组件类;如果未覆盖该类的默认值,则默认值为 "tl tr bl br"。. | ListBase | ||
![]() | 类型: Class CSS 继承: no 用于绘制焦点矩形的外观。. | UIComponent | ||
![]() | 类型: Number 格式: Length CSS 继承: no 焦点矩形轮廓的粗细,以像素为单位。. | UIComponent | ||
![]() | 类型: String CSS 继承: yes 设置内部 TextField 的 antiAliasType 属性。可能值为 "normal" (flash. | ScrollControlBase | ||
![]() | 类型: String CSS 继承: yes 使用的字体的名称。与在完全 CSS 实现中不同,这里不支持逗号分隔的列表。您可以使用任何字体系列名称。如果您指定通用字体名称,它将转换为相应的设备字体。. | ScrollControlBase | ||
![]() | 类型: String CSS 继承: yes 设置用于表示 Flex 控件文本的内部 TextField 的 gridFitType 属性。可能值为 "none" (flash. | ScrollControlBase | ||
![]() | 类型: Number CSS 继承: yes 设置用于表示 Flex 控件文本的内部 TextField 的 sharpness 属性。此属性指定字型边缘的清晰度。可能值为从 -400 到 400 之间的数字。 仅当使用嵌入字体并将 此样式对系统字体不起作用。 此样式适用于 TextField 子控件中的所有文本;但不适用于部分字符。 . | ScrollControlBase | ||
![]() | 类型: Number 格式: Length CSS 继承: yes 文本的高度,以像素为单位。除 ColorPicker 控件之外,所有控件的默认值都为 10。ColorPicker 控件的默认值为 11。. | ScrollControlBase | ||
![]() | 类型: String CSS 继承: yes 确定文本是否使用斜体。可识别的值为 "normal" 和 "italic"。. | ScrollControlBase | ||
![]() | 类型: Number CSS 继承: yes 设置用于表示 Flex 控件文本的内部 TextField 的 thickness 属性。此属性指定字型边缘的粗细。可能值为从 -200 到 200 之间的数字。 仅当使用嵌入字体并将 此样式对系统字体不起作用。 此样式适用于 TextField 子控件中的所有文本;但不适用于部分字符。 . | ScrollControlBase | ||
![]() | 类型: String CSS 继承: yes 确定文本是否使用粗体。可识别的值为 normal 和 bold。Button 控件的默认值为 bold。所有其它控件的默认值为 normal。. | ScrollControlBase | ||
![]() | 类型: String CSS 继承: no 从组件内容区域的中心到组件中心的水平距离(以像素为单位)。如果设置此样式,则组件的中心锚定在其内容区域的中心;调整组件容器大小后,这两个中心将保持它们的水平间距。 此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器( 默认值为 | UIComponent | ||
![]() | 类型: String CSS 继承: no 水平 scrollbar 的样式名称。通过它,可以更精细地控制滚动条的外观。. | ScrollControlBase | ||
![]() | 类型: Boolean CSS 继承: yes 一个布尔值,指示是启用 ( true) 还是禁用 (false) 字距调整。字距调整会调整某些字符对之间的间隔以提高可读性,并应只在必要时(例如使用大字体标题时)使用。仅嵌入字体支持字距调整。某些字体(如宋体)和等宽字体(如 Courier New)不支持字距调整。. | ScrollControlBase | ||
![]() | 类型: Number 格式: Length CSS 继承: yes 文本行之间附加的垂直空间。 默认值为 2。 ComboBox 控件的默认值为 0。 . | ScrollControlBase | ||
![]() | 类型: String CSS 继承: no 从组件内容区域的左边缘到组件左边缘的水平距离(以像素为单位)。如果设置此样式,则组件的左边缘锚定在其内容区域的左边缘;调整组件容器大小后,这两个边缘将保持它们的间距。 此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器( 默认值为 | UIComponent | ||
![]() | 类型: Number CSS 继承: yes 各字符之间显示的附加像素数。如果为正值,则会在正常间距的基础上增加字符间距;如果为负值,则减小此间距。. | ScrollControlBase | ||
![]() | 类型: Number 格式: Length CSS 继承: no 行的底部与该行中渲染器底部之间的像素数目。. | ListBase | ||
![]() | 类型: Number 格式: Length CSS 继承: no 组件左边框与其内容区域左边缘之间的像素数目。 默认值为 0。 Button 控件的默认值为 10。 ComboBox 控件的默认值为 5。 Form 容器的默认值为 16。 Tree 控件的默认值为 2。 . | ListBase | ||
![]() | 类型: Number 格式: Length CSS 继承: no 组件右边框与其内容区域右边缘之间的像素数目。 默认值为 0。 Button 控件的默认值为 10。 ComboBox 控件的默认值为 5。 Form 容器的默认值为 16。 . | ListBase | ||
![]() | 类型: Number 格式: Length CSS 继承: no 行的顶部与该行中渲染器顶部之间的像素数目。. | ListBase | ||
![]() | 类型: String CSS 继承: no 从组件的右边缘到其内容区域的右边缘的水平距离(以像素为单位)。如果设置此样式,则组件的右边缘锚定在其内容区域的右边缘;调整组件容器大小后,这两个边缘将保持它们的间距。 此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器( 默认值为 | UIComponent | ||
![]() | 类型: uint 格式: Color CSS 继承: yes 用户滚过鼠标时渲染器的背景色。. | ListBase | ||
![]() | 类型: uint 格式: Color CSS 继承: yes 用户选中此组件时渲染器的背景色。. | ListBase | ||
![]() | 类型: uint 格式: Color CSS 继承: yes 禁用此组件时渲染器的背景色。. | ListBase | ||
![]() | 类型: Number 格式: Time CSS 继承: no 选择效果的持续时间。如果选中了某个项目,则在背景着色时会播放相应的效果。设置为 0 可禁用此效果。. | ListBase | ||
![]() | 类型: Function CSS 继承: no 针对选项效果的 easingFunction。如果选中了某个项目,则在背景着色时会播放相应的效果。默认效果为颜色的线性淡入淡出。easingFunction 可用于控制选择效果。. | ListBase | ||
![]() | 类型: String CSS 继承: no 投影方向。可能值包括 "left"、"center" 和 "right"。. | ScrollControlBase | ||
![]() | 类型: Number 格式: Length CSS 继承: no 投影距离。如果将此属性设置为负值,此阴影将出现在组件的上方。. | ScrollControlBase | ||
![]() | 类型: String CSS 继承: yes 容器内文本的对齐情况。可能值有: "left"、"right" 或 "center"。 大多数组件的默认值为 | ScrollControlBase | ||
![]() | 类型: String CSS 继承: yes 确定文本是否加下划线。可能值有: "none" 和 "underline"。. | ScrollControlBase | ||
![]() | 类型: Number 格式: Length CSS 继承: yes 文本第一行偏离容器左侧的距离(以像素为单位)。. | ScrollControlBase | ||
![]() | 类型: uint 格式: Color CSS 继承: yes 用户滚过鼠标时渲染器文本的颜色。. | ListBase | ||
![]() | 类型: uint 格式: Color CSS 继承: yes 用户选中渲染器时其文本的颜色。. | ListBase | ||
![]() | 类型: uint 格式: Color CSS 继承: yes 组件的主题颜色。此属性控制加亮内容的外观、选中组件时的外观和其它相似的形象化提示,但是它对此组件的常规边框和背景颜色不起作用。虽然可以使用任意有效的颜色值,但首选值为 haloGreen、haloBlue、haloOrange 和 haloSilver。 | UIComponent | ||
![]() | 类型: String CSS 继承: no 从控件内容区域的上边缘到组件上边缘的垂直距离(以像素为单位)。如果设置此样式,则组件的上边缘锚定在其内容区域的上边缘;调整其容器大小后,这两个边缘将保持其间距。 此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器( 默认值为 | UIComponent | ||
![]() | 类型: Boolean CSS 继承: no 一个标志,控制当鼠标滚过项目时是否加亮显示该项目。如果为 true,则当鼠标滚过行时加亮显示这些行。如果为 false,则只在选中行时才进行加亮显示。. | ListBase | ||
![]() | 类型: String CSS 继承: no 垂直对齐行中的渲染器。可能值包括 "top"、"middle" 和 "bottom"。DataGrid 根据此样式以及 paddingTop 和 paddingBottom 样式在行中定位渲染器。如果某一行上各列中项目的高度不等,则其它列表类不使用 verticalAlign,但项目渲染器可以检查此样式属性,并根据检查结果调整其布局。. | ListBase | ||
![]() | 类型: String CSS 继承: no 从组件内容区域的中心到组件中心的垂直距离(以像素为单位)。如果设置此样式,则组件的中心锚定在其内容区域的中心;调整其容器大小后,这两个中心将保持其垂直间距。 此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器( 默认值为 | UIComponent | ||
![]() | 类型: String CSS 继承: no 垂直 scrollbar 的样式名称。通过它,可以更精细地控制滚动条的外观。. | ScrollControlBase | ||
| 常量 | 定义方 | ||
|---|---|---|---|
| COMPUTER : File [静态] 一个可用作 directory 属性值的常数,代表名为“Computer”的伪顶级目录。 | FileSystemList | ||
![]() | DEFAULT_MAX_HEIGHT : Number = 10000 [静态] maxHeight 属性的默认值。 | UIComponent | |
![]() | DEFAULT_MAX_WIDTH : Number = 10000 [静态] maxWidth 属性的默认值。 | UIComponent | |
![]() | DEFAULT_MEASURED_HEIGHT : Number = 22 [静态] measuredHeight 属性的默认值。 | UIComponent | |
![]() | DEFAULT_MEASURED_MIN_HEIGHT : Number = 22 [静态] measuredMinHeight 属性的默认值。 | UIComponent | |
![]() | DEFAULT_MEASURED_MIN_WIDTH : Number = 40 [静态] measuredMinWidth 属性的默认值。 | UIComponent | |
![]() | DEFAULT_MEASURED_WIDTH : Number = 160 [静态] measuredWidth 属性的默认值。 | UIComponent | |
| backHistory | 属性 |
backHistory:Array [只读 (read-only)] 一个 File 对象 Array,表示用户可以向后导航到的目录。
该 Array 中的第一个项目是历史记录列表中可回退到的下一个目录。最后一个项目是历史记录列表中可回退到的最远的目录。
此 Array 可以包含 null 项目,表示以根目录(如 Microsoft Windows 中的 C:\ 和 D:\)作为内容的并不存在的目录。
以下示例演示如何将此属性与 FileSystemHistoryButton 控件一起使用,以实现一个后退按钮:
<mx:FileSystemList id="fileSystemViewer" directory="{File.desktopDirectory}"/>
<mx:FileSystemHistoryButton label="Back"
enabled="{fileSystemViewer.canNavigateBack}"
dataProvider="{fileSystemViewer.backHistory}"
click="fileSystemViewer.navigateBack();"
itemClick="fileSystemViewer.navigateBack(event.index);"/>
默认值为 [].
此属性可用作数据绑定的源。修改此属性后,将调度 historyChanged 事件。
public function get backHistory():Array另请参见
| canNavigateBack | 属性 |
canNavigateBack:Boolean [只读 (read-only)]
一个标志,如果历史记录列表中至少存在一个可供用户向后导航的目录,则为 true。
以下示例演示如何将此属性与 FileSystemHistoryButton 控件一起使用,以实现一个后退按钮:
<mx:FileSystemList id="fileSystemViewer" directory="{File.desktopDirectory}"/>
<mx:FileSystemHistoryButton label="Back"
enabled="{fileSystemViewer.canNavigateBack}"
dataProvider="{fileSystemViewer.backHistory}"
click="fileSystemViewer.navigateBack();"
itemClick="fileSystemViewer.navigateBack(event.index);"/>
默认值为 false.
此属性可用作数据绑定的源。修改此属性后,将调度 historyChanged 事件。
public function get canNavigateBack():Boolean另请参见
| canNavigateDown | 属性 |
canNavigateDown:Boolean [只读 (read-only)]
一个标志,如果用户可向下导航至所选目录,则为 true。如果未选中任何项目,或所选项目是一个文件而非目录时,此标志为 false。
以下示例演示如何将此属性与 Button 控件一起使用:
<mx:FileSystemList id="fileSystemViewer" directory="{File.desktopDirectory}"/>
<mx:Button label="Open"
enabled="{fileSystemViewer.canNavigateDown}"
click="fileSystemViewer.navigateDown();"/>
默认值为 false.
此属性可用作数据绑定的源。修改此属性后,将调度 directoryChanged 事件。
public function get canNavigateDown():Boolean另请参见
| canNavigateForward | 属性 |
canNavigateForward:Boolean [只读 (read-only)]
一个标志,如果历史记录列表中至少存在一个可供用户向前导航的目录,则为 true。
以下示例演示如何将此属性与 FileSystemHistoryButton 控件一起使用,以实现一个前进按钮:
<mx:FileSystemList id="fileSystemViewer" directory="{File.desktopDirectory}"/>
<mx:FileSystemHistoryButton label="Forward"
enabled="{fileSystemViewer.canNavigateForward}"
dataProvider="{fileSystemViewer.forwardHistory}"
click="fileSystemViewer.navigateForward();"
itemClick="fileSystemViewer.navigateForward(event.index);"/>
默认值为 false.
此属性可用作数据绑定的源。修改此属性后,将调度 historyChanged 事件。
public function get canNavigateForward():Boolean另请参见
| canNavigateUp | 属性 |
canNavigateUp:Boolean [只读 (read-only)]
一个标志,如果用户可向上导航至父级目录,则为 true。仅当此控件显示根目录(如 Microsoft Windows 中的 C:\ 和 D:\)时,此标志才为 false。(此时,directory 属性为 COMPUTER。)
以下示例演示如何将此属性与 Button 控件一起使用:
<mx:FileSystemList id="fileSystemViewer" directory="{File.desktopDirectory}"/>
<mx:Button label="Up"
enabled="{fileSystemViewer.canNavigateUp}"
click="fileSystemViewer.navigateUp();"/>
默认值为 false.
此属性可用作数据绑定的源。修改此属性后,将调度 directoryChanged 事件。
public function get canNavigateUp():Boolean另请参见
| directory | 属性 |
directory:File [读写] 此控件显示内容所在的目录。
如果将此属性设置为代表现有目录的 File 对象,则 dataProvider 立即改为 null。稍后,在此控件经 LayoutManager 重新验证后,它将枚举目录的内容并使用生成的代表该目录中文件和子目录的 File 对象的 ArrayCollection 填充 dataProvider 属性。
将此属性设置为不代表现有目录的 File 对象将出现错误。将此属性设置为 COMPUTER 可同步显示根目录,如 Windows 上的 C:、D:。
设置此属性将取消对以前任何所选项目的选择,并会将控件的滚动位置重置到其左上角。
默认值为 COMPUTER.
此属性可用作数据绑定的源。修改此属性后,将调度 directoryChanged 事件。
public function get directory():File public function set directory(value:File):void| enumerationMode | 属性 |
enumerationMode:String [读写] 一个 String,指定此控件是仅显示文件、仅显示子目录,还是两者均显示。在两者都显示的情况下,它还可指定子目录显示在文件之前、之后还是与文件混合显示。可能的值由 FileSystemEnumerationMode 类指定。
此属性将影响控件中显示哪些子目录和文件,以及它们的显示顺序。不过,它不会影响 dataProvider 属性中存在哪些 File 实例;此属性通过更改应用于 dataProvider 的滤镜函数的行为起作用。设置此属性不会导致重新枚举当前 directory。
设置此属性将取消对任何所选项目的选择,并会将控件的滚动位置重置到其左上角。
默认值为 FileSystemEnumerationMode.DIRECTORIES_FIRST.
public function get enumerationMode():String public function set enumerationMode(value:String):void另请参见
| extensions | 属性 |
extensions:Array [读写]
扩展名的 Array,指定在此控件中可以显示哪些文件。例如,如果将此属性设置为 [ ".htm", ".html" ],则只显示具有这些扩展名的文件。
扩展名不区分大小写,且前面的句点是可选的。例如,指定 ".HTML" 与指定 "html" 效果相同。
即使目录的名称中包含句点,也不受扩展名筛选的影响。
enumerationMode 和 filterFunction 属性也与确定在控件中显示哪些文件相关。例如,如果此属性为 [ ".htm", ".html" ],但 enumerationMode 属性为 FileSystemEnumerationMode.DIRECTORIES_ONLY 或 filterFunction 针对某个 .html 文件返回 false,则不会显示该文件。
如果此属性是 null,则不会进行扩展名筛选,但显示所有文件。如果此属性是空 Array,则会过滤所有扩展名,不显示带有扩展名的任何文件。
此属性将影响控件中显示哪些文件。不过,它不会影响 dataProvider 属性中存在哪些 File 实例;此属性通过更改应用于 dataProvider 的滤镜函数的行为起作用。设置此属性不会导致重新枚举当前 directory。
设置此属性将取消对任何所选项目的选择,并会将控件的滚动位置重置到其左上角。
默认值为 null.
public function get extensions():Array public function set extensions(value:Array):void| filterFunction | 属性 |
filterFunction:Function [读写]
在应用 enumerationMode 和 extensions 属性后,可用来执行其它筛选以确定显示及隐藏哪些文件和子目录的回调函数。
该函数必须具有以下特征:
function myFilterFunction(file:File):Boolean此函数应返回
true 以表示显示指定的文件或子目录;应返回 false 以表示隐藏指定的文件或子目录。
若要确保将每个枚举的文件和子目录都传递给此函数,enumerationMode 属性不能为 FileSystemEnumerationMode.FILES_ONLY 或 FileSystemEnumerationMode.DIRECTORIES_ONLY,且 extensions 属性必须是 null。否则,这些属性将导致在调用此滤镜函数之前进行预筛选。
此属性将影响控件中显示哪些子目录和文件。不过,它不会影响 dataProvider 属性中存在哪些 File 实例;此属性通过更改应用于 dataProvider 的滤镜函数的行为起作用。设置此属性不会导致重新枚举当前 directory。
设置此属性将取消对任何所选项目的选择,并会将控件的滚动位置重置到其左上角。
默认值为 null.
public function get filterFunction():Function public function set filterFunction(value:Function):void| forwardHistory | 属性 |
forwardHistory:Array [只读 (read-only)] 一个 File 对象 Array,表示用户可以向前导航到的目录。
该 Array 中的第一个项目是历史记录列表中可前进到的下一个目录。最后一个项目是历史记录列表中可前进到的最远的目录。
此 Array 可能包含特殊的 COMPUTER File 对象,它代表内容为根目录(如 Windows 上的 C:\ 和 D:\)的不存在的目录。
以下示例演示如何将此属性与 FileSystemHistoryButton 控件一起使用,以实现一个前进按钮:
<mx:FileSystemList id="fileSystemViewer" directory="{File.desktopDirectory}"/>
<mx:FileSystemHistoryButton label="Forward"
enabled="{fileSystemViewer.canNavigateForward}"
dataProvider="{fileSystemViewer.forwardHistory}"
click="fileSystemViewer.navigateForward();"
itemClick="fileSystemViewer.navigateForward(event.index);"/>
默认值为 [].
此属性可用作数据绑定的源。修改此属性后,将调度 historyChanged 事件。
public function get forwardHistory():Array另请参见
| nameCompareFunction | 属性 |
nameCompareFunction:Function [读写] 可用于更改文件和子目录名称的比较方式以生成排序顺序的回调函数。
该函数必须具有以下特征:
function myNameCompareFunction(name1:String, name2:String):int
如果 name1 应排在 name2 之前,则返回 -1;如果 name1 应排在 name2 之后,则返回 1;如果名称相同,则返回 0。
如果未设置此属性,则控件将对两个名称执行不区分大小写、依赖区域设置的比较。首先对每个名称调用 String 方法 toLocaleLowerCase(),然后使用 < 和 > 运算符进行比较。
如果已将 enumerationMode 设置为 FileSystemEnumerationMode.FILES_FIRST 或 FileSystemEnumerationMode.DIRECTORIES_FIRST,则仅使用此方法比较单组文件和目录之内的名称。
此属性将影响子目录和文件在控件中的显示顺序。不过,它不会影响 dataProvider 属性中的 File 实例;它通过更改应用于 dataProvider 的排序行为起作用。设置此属性不会导致重新枚举当前 directory。
设置此属性将取消对任何所选项目的选择,并会将控件的滚动位置重置到其左上角。
默认值为 null.
public function get nameCompareFunction():Function public function set nameCompareFunction(value:Function):void| selectedPath | 属性 |
selectedPath:String [读写]
表示所选子目录或文件的 File 项目的 nativePath;如果未选定任何项目,则为 null。
如果选择了多个项目,此属性将获得 selectedPaths 数组中的第一个路径。
设置此属性将影响 selectedPaths、selectedItem、selectedItems、selectedIndex 和 selectedIndices 属性。
默认值为 null.
此属性可用作数据绑定的源。修改此属性后,将调度 directoryChanged 事件。
public function get selectedPath():String public function set selectedPath(value:String):void另请参见
| selectedPaths | 属性 |
selectedPaths:Array [读写]
表示所选子目录和文件的 File 项目的 nativePath 字符串 Array。如果未选择任何项目,则此 Array 为空。
设置此属性将影响 selectedPaths、selectedItem、selectedItems、selectedIndex 和 selectedIndices 属性。
默认值为 [].
此属性可用作数据绑定的源。修改此属性后,将调度 directoryChanged 事件。
public function get selectedPaths():Array public function set selectedPaths(value:Array):void另请参见
| showExtensions | 属性 |
showExtensions:Boolean [读写]
一个标志,指定是否显示文件名称中的扩展名。将此属性设置为 true 将显示文件扩展名,设置为 false 将隐藏文件扩展名。始终显示目录名称中的扩展名。
设置此属性不会影响显示哪些项目或它们出现的顺序,也不会影响选择哪些项目或滚动位置。
默认值为 true.
public function get showExtensions():Boolean public function set showExtensions(value:Boolean):void| showHidden | 属性 |
showHidden:Boolean [读写]
一个标志,指定是否显示操作系统视为隐藏的文件和目录。将此属性设置为 true 将显示隐藏的文件和目录,设置为 false 将隐藏它们。
设置此属性将取消对任何所选项目的选择,并会将控件的滚动位置重置到其左上角。
默认值为 false.
public function get showHidden():Boolean public function set showHidden(value:Boolean):void| showIcons | 属性 |
showIcons:Boolean [读写]
一个标志,指定在文件名称之前显示图标。将此属性设置为 true 将显示图标,设置为 false 将隐藏图标。
您可以设置 directoryIcon 和 fileIcon 样式来更改默认图标。此控件无法显示操作系统针对文件显示的实际图标,因为 Apollo M2 不支持该功能。
设置此属性不会影响显示哪些项目或它们出现的顺序,也不会影响选择哪些项目或滚动位置。
默认值为 true.
public function get showIcons():Boolean public function set showIcons(value:Boolean):void| FileSystemList | () | 构造函数 |
public function FileSystemList()构造函数。
| clear | () | 方法 |
public function clear():void清除此控件,使其不显示任何项目。
此方法会将 dataProvider 设置为 null,但 directory 属性保持不变。可以调用 refresh 再次填充此控件。
| findIndex | () | 方法 |
public function findIndex(nativePath:String):int返回具有指定本机文件系统路径的 File 项目的索引。
不会搜索符合以下条件的项目:存在于控件的集合中,但由于筛选未能显示。
参数
nativePath:String —
一个字符串,用于指定 File 项目的 nativePath。
|
int —
从零开始的索引;如果在指定的路径中没有找到 File,则为 -1。
|
另请参见
| findItem | () | 方法 |
public function findItem(nativePath:String):File
搜索此控件中当前显示的 File 实例,并返回一个具有指定 nativePath 属性的实例。
不会搜索符合以下条件的 File 实例:存在于控件的集合中,但由于筛选未能显示。
参数
nativePath:String —
一个字符串,用于指定 File 项目的 nativePath。
|
File —
如果找到了一个具有指定 nativePath 的 File 实例,则返回该实例;如果没有找到,则返回 null。
|
| navigateBack | () | 方法 |
public function navigateBack(index:int = 0):void
更改此控件可显示 backHistory 数组中上次访问过的目录中的内容。
如果 backHistory 数组为空,或者指定的索引不在该数组中,则此方法不会产生任何效果。
此方法返回时,directory 属性将包含新目录的 File 实例。枚举新目录之前,dataProvider 属性暂时为 null。枚举之后,dataProvider 属性将包含新目录内容的 File 实例的 ArrayCollection。
历史记录列表不会更改。但是,列表中的当前索引会发生更改,这会影响 backHistory 和 forwardHistory 属性。此方法返回新值后,这些属性即可获得新的值。
以下示例演示如何将此方法与 FileSystemHistoryButton 控件一起使用,以创建一个后退按钮:
<mx:FileSystemList id="fileSystemViewer" directory="{File.desktopDirectory}"/>
<mx:FileSystemHistoryButton label="Back"
enabled="{fileSystemViewer.canNavigateBack}"
dataProvider="{fileSystemViewer.backHistory}"
click="fileSystemViewer.navigateBack();"
itemClick="fileSystemViewer.navigateBack(event.index);"/>
参数
index:int (default = 0) —
backHistory 数组中要导航到的索引。默认值为 0,指示“最近的返回”目录。
|
另请参见
| navigateDown | () | 方法 |
public function navigateDown():void更改此控件可显示所选子目录的内容。
如果没有选中子目录,则此方法不产生任何效果。
此方法返回时,directory 属性将包含新目录的 File 实例。枚举新目录之前,dataProvider 属性暂时为 null。枚举之后,dataProvider 属性将包含新目录内容的 File 实例的 ArrayCollection。
以下示例演示如何将此方法与 Button 控件一起使用,以创建一个打开按钮:
<mx:FileSystemList id="fileSystemViewer" directory="{File.desktopDirectory}"/>
<mx:Button label="Open"
enabled="{fileSystemViewer.canNavigateDown}"
click="fileSystemViewer.navigateDown();"/>
另请参见
| navigateForward | () | 方法 |
public function navigateForward(index:int = 0):void
更改此控件可显示 forwardHistory 数组中上次访问过的目录中的内容。
如果 forwardHistory 数组为空,或者指定的索引不在该数组中,则此方法不会产生任何效果。
此方法返回时,directory 属性将包含新目录的 File 实例。枚举新目录之前,dataProvider 属性暂时为 null。枚举之后,dataProvider 属性将包含新目录内容的 File 实例的 ArrayCollection。
历史记录列表不会更改。但是,列表中的当前索引会发生更改,这会影响 backHistory 和 forwardHistory 属性。此方法返回新值后,这些属性即可获得新的值。
以下示例演示如何将此方法与 FileSystemHistoryButton 控件一起使用,以创建一个前进按钮:
<mx:FileSystemList id="fileSystemViewer" directory="{File.desktopDirectory}"/>
<mx:FileSystemHistoryButton label="Forward"
enabled="{fileSystemViewer.canNavigateForward}"
dataProvider="{fileSystemViewer.forwardHistory}"
click="fileSystemViewer.navigateForward();"
itemClick="fileSystemViewer.navigateForward(event.index);"/>
参数
index:int (default = 0) —
forwardHistory 数组中要导航到的索引。默认值为 0,指示“最近的前往”目录。
|
另请参见
| navigateTo | () | 方法 |
| navigateUp | () | 方法 |
public function navigateUp():void更改此控件可显示层次结构中上一目录的内容。
如果此控件当前显示根目录(如 Microsoft Windows 中的 C: 和 D:),则此方法不会产生任何效果。
此方法返回时,directory 属性将包含新目录的 File 实例。枚举新目录之前,dataProvider 属性暂时为 null。枚举之后,dataProvider 属性将包含新目录内容的 File 实例的 ArrayCollection。
以下示例演示如何将此方法与 Button 控件一起使用,以创建一个向上按钮:
<mx:FileSystemList id="fileSystemViewer" directory="{File.desktopDirectory}"/>
<mx:Button label="Up"
enabled="{fileSystemViewer.canNavigateUp}"
click="fileSystemViewer.navigateUp();"/>
另请参见
| refresh | () | 方法 |
public function refresh():void重新枚举此控件显示的当前目录。
由于 AIR 不支持文件系统通知,因此,在创建、删除、移动或重命名文件或子目录时不会自动刷新此控件;也就是说,它可以显示文件系统的过期视图。不过,您可以调用 refresh() 来重新枚举当前 directory 以使其保持最新状态。例如,当您执行了某个文件操作并已知此操作将导致控件的视图过期时,或者当用户取消激活或重新激活您的应用程序时,您可以选择执行此操作。
此方法将保留所有选定的项目(如果它们仍然存在)和滚动位置(如果第一个可见项目仍然存在)。
| directoryChange | 事件 |
mx.events.FileEventmx.events.FileEvent.DIRECTORY_CHANGE当此控件显示的目录由于某种原因发生更改时调度。
FileEvent.DIRECTORY_CHANGE 常数可为directoryChange 事件定义事件对象的 type 属性值。
事件对象的属性有下列值:
| 属性 | 值 |
|---|---|
bubbles
| false |
cancelable
| false |
currentTarget
|
用于定义处理该事件的事件侦听器的 Object。例如,如果您使用 myButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。
|
file
| 与此事件相关联的 File 对象。 |
target
|
调度该事件的 Object;它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。
|
type
| FileEvent.DIRECTORY_CHANGE |
| directoryChanging | 事件 |
mx.events.FileEventmx.events.FileEvent.DIRECTORY_OPENING当用户尝试更改此控件显示的目录时调度此事件。
用户可以尝试使用下列方法更改目录:双击子目录;选中子目录后按 Enter 键或 Ctrl-Down;在控件不显示 COMPUTER 目录时按 Ctrl-Up;在历史记录列表中存在要导航回的“上一个”目录时按 Ctrl-Left;在历史记录列表中存在要导航到的“下一个”目录时按 Ctrl-Right。
此事件是可取消的。如果调用 event.preventDefault(),则不会更改目录。
更改 directory 属性后,dataProvider 会包含新目录中项目的 File 实例,此时将调度 directoryChange 事件。
directoryOpening 事件定义事件对象的 type 属性值。
事件对象的属性有下列值:
| 属性 | 值 |
|---|---|
bubbles
| false |
cancelable
| true |
currentTarget
|
用于定义处理该事件的事件侦听器的 Object。例如,如果您使用 myButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。
|
file
| 与此事件相关联的 File 对象。 |
target
|
调度该事件的 Object;它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。
|
type
| FileEvent.DIRECTORY_OPENING |
| fileChoose | 事件 |
mx.events.FileEventmx.events.FileEvent.FILE_CHOOSE当用户通过双击文件或选择文件并按 Enter 键来选择文件时调度此事件。
FileEvent.FILE_CHOOSE 常数可为fileChoose 事件定义事件对象的 type 属性值。
事件对象的属性有下列值:
| 属性 | 值 |
|---|---|
bubbles
| false |
cancelable
| false |
currentTarget
|
用于定义处理该事件的事件侦听器的 Object。例如,如果您使用 myButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。
|
file
| 与此事件相关联的 File 对象。 |
target
|
调度该事件的 Object;它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。
|
type
| FileEvent.FILE_CHOOSE |
| COMPUTER | 常量 |
public static const COMPUTER:File
一个可用作 directory 属性值的常数,代表名为“Computer”的伪顶级目录。这个伪目录中包含根目录(如 Windows 上的 C:\ 和 D:\,或 Macintosh 上的 /)。