FileSystemList  - AS3 Flex

包	mx.controls
类	public class FileSystemList
继承	FileSystemList List ListBase ScrollControlBase UIComponent FlexSprite Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object

要更改显示的数据，需要设置 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 语法

隐藏 MXML 语法

  <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"
  />
  

默认 MXML 属性dataProvider

相关 API 元素