包	mx.controls
类	public class FileSystemDataGrid
继承	FileSystemDataGrid DataGrid DataGridBase ListBase ScrollControlBase UIComponent FlexSprite Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object

针对每个项目显示的信息都包括：项目名称（带有可选通用图标）、类型、大小、创建日期和修改日期。为此，FileSystemDataGrid 会自动创建五列（DataGridColumn 实例）－ nameColumn、typeColumn、sizeColumn、creationDateColumn 和 modificationDateColumn，并将 columns 属性设置为一个由这五个实例组成的数组。每个列实例都将自动配置为包含适当的 labelFunction 和 sortCompareFunction 等。如果您并非需要所有这五列，或者希望更改其排序，请重置 columns 属性。如果要自定义某个列（如更改其 labelFunction），则只需在相应的列对象上重新分配该属性。

要更改显示的数据，需要设置 directory 属性，而无需使用 dataProvider 属性。随后，控件将自动通过枚举该目录的内容填充 dataProvider 属性。您不应亲自设置 dataProvider。

您需要将 directory 属性设置为 File 实例，如以下示例所示：

<mx:FileSystemDataGrid 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 的基于列表的控件当前支持仅显示嵌入的图标，但不支持在运行时读取的图标。因此，虽然可通过 File 的 icon 属性在 AIR 中访问操作系统中显示的实际文件系统图标，但这些图标不会显示在 FileSystemDataGrid 中。

显示 MXML 语法

隐藏 MXML 语法

  <mx:FileSystemDataGrid
    Properties
    dateFormatString=""
    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"
  />
  

另请参见