mx.controlsFileSystemDataGrid FileSystemDataGrid 控件允许您以数据网格格式显示单个文件系统目录的内容。The <mx:FileSystemDataGrid> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <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"
  />
  
]]>
mx.controls:DataGrid FileSystemDataGrid 控件允许您以数据网格格式显示单个文件系统目录的内容。

针对每个项目显示的信息都包括:项目名称(带有可选通用图标)、类型、大小、创建日期和修改日期。为此,FileSystemDataGrid 会自动创建五列(DataGridColumn 实例)- nameColumntypeColumnsizeColumncreationDateColumnmodificationDateColumn,并将 columns 属性设置为一个由这五个实例组成的数组。每个列实例都将自动配置为包含适当的 labelFunctionsortCompareFunction 等。如果您并非需要所有这五列,或者希望更改其排序,请重置 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 的文件或子目录。

该控件还提供了 selectedPathselectedPaths 两个属性,工作原理与 selectedItemselectedItems 或者 selectedIndexselectedIndices 类似,但允许您通过 nativePath 字符串指定选择。如果需要显示已预先选择了特定项目的目录,它们将非常有用。因为在这种情况下,您还没有在控件枚举目录时控件将创建的 File 项目,并且不知道其索引将是什么。

该控件允许用户使用鼠标或键盘导航到其它目录。用户可以尝试使用下列方法更改目录:双击子目录;选中子目录后按 Enter 键或 Ctrl-Down;在控件不显示 COMPUTER 目录时按 Ctrl-Up;在存在要导航回的“上一个”目录时按 Ctrl-Left;在存在要导航到的“下一个”目录时按 Ctrl-Right。如果用户试图更改正在显示的目录,则该控件将分派可取消的 directoryChanging 事件。如果没有通过调用 event.preventDefault() 取消此事件,则该控件将显示新目录的内容,并且 directory 属性将发生更改。无论 directory 属性在何时由于任何原因发生更改,控件都会分派 directoryChange 事件通知您。

为了支持控件进行“向上”和“向下”导航,FileSystemList 提供了 canNavigateUpcanNavigateDown 属性,以及 navigateUp()navigateDown() 方法。还有一个 navigateTo(),可导航到任意目录。

该控件可跟踪用户曾经导航到的目录,以便支持控件进行“后退”和“前进”导航。有关详细信息,请参见 backHistoryforwardHistorycanNavigateBackcanNavigateForward 属性,以及 navigateBack()navigateForward() 方法。

注意:针对每个项目显示的图标都是通用文件和目录图标,您可以使用 fileIcondirectoryIcon 样式设置它们。Flex 的基于列表的控件当前支持仅显示嵌入的图标,但不支持在运行时读取的图标。因此,虽然可通过 File 的 icon 属性在 AIR 中访问操作系统中显示的实际文件系统图标,但这些图标不会显示在 FileSystemDataGrid 中。

flash.filesystem.FilefileChoose 当用户通过双击文件或选择文件并按 Enter 键来选择文件时分派此事件。mx.events.FileEvent.FILE_CHOOSEmx.events.FileEvent 当用户通过双击文件或选择文件并按 Enter 键来选择文件时分派此事件。 directoryChanging 当用户尝试更改此控件显示的目录时分派此事件。mx.events.FileEvent.DIRECTORY_OPENINGmx.events.FileEvent 当用户尝试更改此控件显示的目录时分派此事件。

用户可以尝试使用下列方法更改目录:双击子目录;选中子目录后按 Enter 键或 Ctrl-Down;在控件不显示 COMPUTER 目录时按 Ctrl-Up;在历史记录列表中存在要导航回的“上一个”目录时按 Ctrl-Left;在历史记录列表中存在要导航到的“下一个”目录时按 Ctrl-Right。

此事件是可取消的。如果调用 event.preventDefault(),则不会更改目录。

更改 directory 属性后,dataProvider 会包含新目录中项目的 File 实例,此时将分派 directoryChange 事件。

directoryChange 当此控件显示的选定目录由于某种原因发生更改时分派此事件。mx.events.FileEvent.DIRECTORY_CHANGEmx.events.FileEvent 当此控件显示的选定目录由于某种原因发生更改时分派此事件。 FileSystemDataGrid 构造函数。 构造函数。 clear findIndex 从零开始的索引;如果在指定的路径中没有找到 File,则为 -1nativePath一个字符串,用于指定 File 项目的 nativePath findItem 如果找到了一个具有指定 nativePath 的 File 实例,则返回该实例;如果没有找到,则返回 nullnativePath一个字符串,用于指定 File 项目的 nativePath navigateBack 更改此控件可显示 backHistory 数组中上次访问过的目录中的内容。index0backHistory 数组中要导航到的索引。默认值为 0,指示“最近的返回”目录。 更改此控件可显示 backHistory 数组中上次访问过的目录中的内容。

如果 backHistory 数组为空,或者指定的索引不在该数组中,则此方法不会产生任何效果。

此方法返回时,directory 属性将包含新目录的 File 实例。枚举新目录之前,dataProvider 属性暂时为 null。枚举之后,dataProvider 属性将包含新目录内容的 File 实例的 ArrayCollection。

历史记录列表不会更改。但是,列表中的当前索引会发生更改,这会影响 backHistoryforwardHistory 属性。此方法返回新值后,这些属性即可获得新的值。

以下示例演示如何将此方法与 FileSystemHistoryButton 控件一起使用,以创建一个后退按钮:

      <mx:FileSystemDataGrid id="fileSystemViewer" directory="{File.desktopDirectory}"/>
      <mx:FileSystemHistoryButton label="Back"
          enabled="{fileSystemViewer.canNavigateBack}"
          dataProvider="{fileSystemViewer.backHistory}"
          click="fileSystemViewer.navigateBack();"
          itemClick="fileSystemViewer.navigateBack(event.index);"/>
backHistorycanNavigateBack
navigateDown 更改此控件可显示所选子目录的内容。 更改此控件可显示所选子目录的内容。

如果没有选中子目录,则此方法不产生任何效果。

此方法返回时,directory 属性将包含新目录的 File 实例。枚举新目录之前,dataProvider 属性暂时为 null。枚举之后,dataProvider 属性将包含新目录内容的 File 实例的 ArrayCollection。

以下示例演示如何将此方法与 Button 控件一起使用,以创建一个打开按钮:

      <mx:FileSystemDataGrid id="fileSystemViewer" directory="{File.desktopDirectory}"/>
      <mx:Button label="Open"
          enabled="{fileSystemViewer.canNavigateDown}"
          click="fileSystemViewer.navigateDown();"/>
canNavigateDown
navigateForward 更改此控件可显示 forwardHistory 数组中上次访问过的目录中的内容。index0forwardHistory 数组中要导航到的索引。默认值为 0,指示“最近的前往”目录。 更改此控件可显示 forwardHistory 数组中上次访问过的目录中的内容。

如果 forwardHistory 数组为空,或者指定的索引不在该数组中,则此方法不会产生任何效果。

此方法返回时,directory 属性将包含新目录的 File 实例。枚举新目录之前,dataProvider 属性暂时为 null。枚举之后,dataProvider 属性将包含新目录内容的 File 实例的 ArrayCollection。

历史记录列表不会更改。但是,列表中的当前索引会发生更改,这会影响 backHistoryforwardHistory 属性。此方法返回新值后,这些属性即可获得新的值。

以下示例演示如何将此方法与 FileSystemHistoryButton 控件一起使用,以创建一个前进按钮:

      <mx:FileSystemDataGrid id="fileSystemViewer" directory="{File.desktopDirectory}"/>
      <mx:FileSystemHistoryButton label="Forward"
          enabled="{fileSystemViewer.canNavigateForward}"
          dataProvider="{fileSystemViewer.forwardHistory}"
          click="fileSystemViewer.navigateForward();"
          itemClick="fileSystemViewer.navigateForward(event.index);"/>
canNavigateForwardforwardHistory
navigateTo directory一个文件对象,表示文件或目录。 navigateUp 更改此控件可显示层次结构中上一目录的内容。 更改此控件可显示层次结构中上一目录的内容。

如果此控件当前显示根目录(如 Microsoft Windows 中的 C: 和 D:),则此方法不会产生任何效果。

此方法返回时,directory 属性将包含新目录的 File 实例。枚举新目录之前,dataProvider 属性暂时为 null。枚举之后,dataProvider 属性将包含新目录内容的 File 实例的 ArrayCollection。

以下示例演示如何将此属性与 Button 控件一起使用,以创建一个向上按钮:

      <mx:FileSystemDataGrid id="fileSystemViewer" directory="{File.desktopDirectory}"/>
      <mx:Button label="Up"
          enabled="{fileSystemViewer.canNavigateUp}"
          click="fileSystemViewer.navigateUp();"/>
canNavigateUp
refresh COMPUTER unknown creationDateColumn DataGridColumn,表示 Created 列。 DataGridColumn,表示 Created 列。FileSystemDataGrid 控件可自动创建此列。

您可以设置 creationDateColumn.width 等属性来自定义此列。要完全删除此列,或更改列的顺序,请将 columns 属性设置为一个数组(如 [ nameColumn, modificationDateColumn, sizeColumn ])。

modificationDateColumn DataGridColumn,表示 Modified 列。 DataGridColumn,表示 Modified 列。FileSystemDataGrid 控件可自动创建此列。

您可以设置 modificationDateColumn.width 等属性来自定义此列。要完全删除此列,或更改列的顺序,请将 columns 属性设置为一个数组(如 [ nameColumn, modificationDateColumn, sizeColumn ])。

nameColumn DataGridColumn 表示 Name 列。 DataGridColumn 表示 Name 列。FileSystemDataGrid 控件可自动创建此列。

您可以设置 nameColumn.width 等属性来自定义此列。要完全删除此列,或更改列的顺序,请将 columns 属性设置为一个数组(如 [ nameColumn, modificationDateColumn, sizeColumn ])。

sizeColumn DataGridColumn,表示 Size 列。 DataGridColumn,表示 Size 列。FileSystemDataGrid 控件可自动创建此列。

您可以设置 sizeColumn.width 等属性来自定义此列。要完全删除此列,或更改列的顺序,请将 columns 属性设置为一个数组(如 [ nameColumn, modificationDateColumn, sizeColumn ])。

typeColumn DataGridColumn,表示 Type 列。 DataGridColumn,表示 Type 列。FileSystemDataGrid 控件可自动创建此列。

您可以设置 typeColumn.width 等属性来自定义此列。要完全删除此列,或更改列的顺序,请将 columns 属性设置为一个数组(如 [ nameColumn, modificationDateColumn, sizeColumn ])。

backHistory 一个 File 对象 Array,表示用户可以向后导航到的目录。[] 一个 File 对象 Array,表示用户可以向后导航到的目录。

该 Array 中的第一个项目是历史记录列表中可回退到的下一个目录。最后一个项目是历史记录列表中可回退到的最远的目录。

此 Array 可以包含 null 项目,表示以根目录(如 Microsoft Windows 中的 C:\ 和 D:\)作为内容的并不存在的目录。

以下示例演示如何将此属性与 FileSystemHistoryButton 控件一起使用,以实现一个后退按钮:

      <mx:FileSystemDataGrid id="fileSystemViewer" directory="{File.desktopDirectory}"/>
      <mx:FileSystemHistoryButton label="Back"
         enabled="{fileSystemViewer.canNavigateBack}"
         dataProvider="{fileSystemViewer.backHistory}"
         click="fileSystemViewer.navigateBack();"
         itemClick="fileSystemViewer.navigateBack(event.index);"/>
canNavigateBacknavigateBack()mx.controls.FileSystemHistoryButton
canNavigateBack 一个标志,如果历史记录列表中至少存在一个可供用户向后导航的目录,则为 true。false 一个标志,如果历史记录列表中至少存在一个可供用户向后导航的目录,则为 true

以下示例演示如何将此属性与 FileSystemHistoryButton 控件一起使用,以实现一个后退按钮:

      <mx:FileSystemDataGrid id="fileSystemViewer" directory="{File.desktopDirectory}"/>
      <mx:FileSystemHistoryButton label="Back"
          enabled="{fileSystemViewer.canNavigateBack}"
          dataProvider="{fileSystemViewer.backHistory}"
          click="fileSystemViewer.navigateBack();"
          itemClick="fileSystemViewer.navigateBack(event.index);"/>
backHistorynavigateBack()
canNavigateDown 一个标志,如果用户可向下导航至所选目录,则为 true。false 一个标志,如果用户可向下导航至所选目录,则为 true。如果未选中任何项目,或所选项目是一个文件而非目录时,此标志为 false

以下示例演示如何将此属性与 Button 控件一起使用:

      <mx:FileSystemDataGrid id="fileSystemViewer" directory="{File.desktopDirectory}"/>
      <mx:Button label="Open"
          enabled="{fileSystemViewer.canNavigateDown}"
          click="fileSystemViewer.navigateDown();"/>
navigateDown()
canNavigateForward 一个标志,如果历史记录列表中至少存在一个可供用户向前导航的目录,则为 true。false 一个标志,如果历史记录列表中至少存在一个可供用户向前导航的目录,则为 true

以下示例演示如何将此属性与 FileSystemHistoryButton 控件一起使用,以实现一个前进按钮:

      <mx:FileSystemDataGrid id="fileSystemViewer" directory="{File.desktopDirectory}"/>
      <mx:FileSystemHistoryButton label="Forward"
          enabled="{fileSystemViewer.canNavigateForward}"
          dataProvider="{fileSystemViewer.forwardHistory}"
          click="fileSystemViewer.navigateForward();"
          itemClick="fileSystemViewer.navigateForward(event.index);"/>
forwardHistorynavigateForward()
canNavigateUp 一个标志,如果用户可向上导航至父级目录,则为 true。false 一个标志,如果用户可向上导航至父级目录,则为 true。仅当此控件显示根目录(如 Microsoft Windows 中的 C:\ 和 D:\)时,此标志才为 false。(此时,directory 属性为 COMPUTER。)

以下示例演示如何将此属性与 Button 控件一起使用:

      <mx:FileSystemDataGrid id="fileSystemViewer" directory="{File.desktopDirectory}"/>
      <mx:Button label="Up"
          enabled="{fileSystemViewer.canNavigateUp}"
          click="fileSystemViewer.navigateUp();"/>
navigateUp()
dateFormatString 一个 String,用于确定 Created 和 Modified 列中的日期格式。 一个 String,用于确定 Created 和 Modified 列中的日期格式。通过设置此属性,可以设置此控件创建的内部 DateFormatter 的 formatStringmx.formatters.DateFormatter.formatStringdirectory enumerationMode FileSystemEnumerationMode.DIRECTORIES_FIRST mx.controls.FileSystemEnumerationModeextensions null filterFunction null forwardHistory 一个 File 对象 Array,表示用户可以向前导航到的目录。[] 一个 File 对象 Array,表示用户可以向前导航到的目录。

该 Array 中的第一个项目是历史记录列表中可前进到的下一个目录。最后一个项目是历史记录列表中可前进到的最远的目录。

此 Array 可以包含 null 项目,表示以根目录(如 Windows 中的 C:\ 和 D:\)作为内容的并不存在的目录。

以下示例演示如何将此属性与 FileSystemHistoryButton 控件一起使用,以实现一个前进按钮:

      <mx:FileSystemDataGrid id="fileSystemViewer" directory="{File.desktopDirectory}"/>
      <mx:FileSystemHistoryButton label="Forward"
          enabled="{fileSystemViewer.canNavigateForward}"
          dataProvider="{fileSystemViewer.forwardHistory}"
          click="fileSystemViewer.navigateForward();"
          itemClick="fileSystemViewer.navigateForward(event.index);"/>
mx.controls.FileSystemHistoryButton
nameCompareFunction null selectedPath null mx.controls.listClasses.ListBase.selectedIndexmx.controls.listClasses.ListBase.selectedItemselectedPaths [] mx.controls.listClasses.ListBase.selectedIndexmx.controls.listClasses.ListBase.selectedItemshowExtensions showHidden showIcons sizeDisplayMode 一个 String,用于指定 Size 列是按字节显示文件大小,还是舍入到最接近的千字节(其中一千字节相当于 1024 字节)。 一个 String,用于指定 Size 列是按字节显示文件大小,还是舍入到最接近的千字节(其中一千字节相当于 1024 字节)。可能值由 FileSystemSizeDisplayMode 类指定。 mx.controls.FileSystemSizeDisplayMode
FileSystemTree FileSystemTree 控件采用树状结构显示文件系统目录的内容。The <mx:FileSystemTree> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <mx:FileSystemTree
    Properties
    directory="null"
    enumerationMode="directoriesFirst"
    extensions="null"
    filterFunction="null"
    nameCompareFunction="null"
    openPaths="null"
    selectedPath="null"
    selectedPaths="null"
    showExtensions="true"
    showHidden="false"
    showIcons="true"
 
    Events
    directoryChange="No default"
    directoryClosing="No default"
    directoryOpening="No default"
    fileChoose="No default"
  />
  
]]>
mx.controls:Tree FileSystemTree 控件采用树状结构显示文件系统目录的内容。

您可以通过将 directory 属性设置为 flash.filesystem.File 类实例来指定显示哪个目录下的内容。(File 实例可以表示目录,也可以表示文件。)每当此属性由于任何原因发生更改时,此控件都会分派 directoryChange 事件。

可设置 enumerationMode 属性,以指定是显示此目录的文件、其子目录还是同时显示两者。在每个树节点中同时显示文件和子目录的方式有三种:目录优先、文件优先或两者混合。

可设置 extensions 属性以过滤列表,从而仅显示具有指定扩展名的文件。(目录上的扩展名将被忽略。)您也可以通过设置 filterFunction 属性指定自己需要的其他过滤函数。

可使用 showExtensions 属性显示或隐藏文件扩展名,使用 showIcons 属性显示或隐藏图标。

通过将 nameCompareFunction 属性设置为可比较两个文件名或目录名的函数,可在每个树节点中执行自定义排序。

如果用户双击关闭的目录节点或单击其显示图标,此控件将分派 directoryOpening 事件。如果用户双击打开的目录节点或单击其显示图标,此控件将分派 directoryClosing 事件。处理函数可以通过调用 event.preventDefault() 取消上述任一事件,此时不会打开节点。

如果用户双击某个文件节点,此控件将分派 select 事件。

flash.filesystem.FilefileChoose 当用户通过双击文件或选择文件并按 Enter 键来选择文件时分派此事件。mx.events.FileEvent.FILE_CHOOSEmx.events.FileEvent 当用户通过双击文件或选择文件并按 Enter 键来选择文件时分派此事件。 directoryOpening 当用户使用鼠标或键盘打开目录节点时分派。mx.events.FileEvent.DIRECTORY_OPENINGmx.events.FileEvent 当用户使用鼠标或键盘打开目录节点时分派。

此事件是可取消的。如果调用 event.preventDefault(),此控件将继续显示当前目录,而不会改为显示双击的子目录。

directoryClosing 当用户使用鼠标或键盘关闭打开的目录节点时分派。mx.events.FileEvent.DIRECTORY_CLOSINGmx.events.FileEvent 当用户使用鼠标或键盘关闭打开的目录节点时分派。 directoryChange 当 directory 属性由于任何原因而发生更改时分派。mx.events.FileEvent.DIRECTORY_CHANGEmx.events.FileEventdirectory 属性由于任何原因而发生更改时分派。 FileSystemTree 构造函数。 构造函数。 clear 清除列表。 清除列表。

此方法会将 dataProvider 设置为 null,但 directory 属性保持不变。您可以调用 refresh 重新填充列表。

closeSubdirectory 关闭本机文件系统路径指定的子目录。nativePath一个字符串,用于指定 File 项目的 nativePath 关闭本机文件系统路径指定的子目录。

如果 nativePath 未指定将显示在此控件中的目录,则此方法不会执行任何操作。

findIndex 从零开始的索引;如果在指定的路径中没有找到 File,则为 -1nativePath一个字符串,用于指定 File 项目的 nativePath findItem 如果找到了一个具有指定 nativePath 的 File 实例,则返回该实例;如果没有找到,则返回 nullnativePath一个字符串,用于指定 File 项目的 nativePath openSubdirectory 打开由本机文件系统路径指定的子目录。nativePath一个字符串,用于指定 File 项目的 nativePath 打开由本机文件系统路径指定的子目录。

此方法将自动打开到达指定目录需要经过的所有中间目录。

如果 nativePath 指定的文件系统目录不存在,或者该目录不在此控件显示的目录中,则此方法不会执行任何操作。

refresh 重新枚举此控件显示的当前目录。 重新枚举此控件显示的当前目录。

返回此方法后,directory 属性包含与之前相同目录的 File 实例。重新枚举目录之前,dataProvider 属性暂时为 null。枚举之后,dataProvider 属性将包含此目录内容的 File 实例的 ArrayCollection。

COMPUTER unknown directory 此控件显示内容所在的目录。COMPUTER 此控件显示内容所在的目录。

如果将此属性设置为代表现有目录的 File 对象,则 dataProvider 立即改为 null。稍后,当此控件再次经 LayoutManager 验证后,它将同步枚举此目录内容,并使用为该目录的文件和子目录生成的 File 对象的 ArrayCollection 填充 dataProvider 属性。

将此属性设置为不代表现有目录的 File 对象将出现错误。将此属性设置为 COMPUTER 可同步显示根目录,如 Windows 上的 C:、D:。

enumerationMode FileSystemEnumerationMode.DIRECTORIES_FIRST mx.controls.FileSystemEnumerationModeextensions null filterFunction null nameCompareFunction null openPaths File 项目的 nativePath 字符串 Array,用于呈示打开的子目录。[] File 项目的 nativePath 字符串 Array,用于呈示打开的子目录。如果未打开子目录,则此 Array 为空。 selectedPath null mx.controls.listClasses.ListBase.selectedIndexmx.controls.listClasses.ListBase.selectedItemselectedPaths [] mx.controls.listClasses.ListBase.selectedIndexmx.controls.listClasses.ListBase.selectedItemshowExtensions true showHidden false showIcons true
FileSystemList 使用 FileSystemList 控件,可以列表格式显示单个文件系统目录的内容。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"
  />
  
]]>
mx.controls:List 使用 FileSystemList 控件,可以列表格式显示单个文件系统目录的内容。

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

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

    <mx:FileSystemList directory="{File.desktopDirectory}"/>

您可以设置 enumerationMode 属性,以指定是显示文件、子目录还是同时显示两者。有三种方式可以同时显示两者:目录优先、文件优先或两者混合。

您可以设置 extensions 属性以筛选显示的项目,从而仅显示具有指定扩展名的文件。showHidden 确定控件是否显示操作系统通常隐藏的文件和子目录。您可以指定另外一个 filterFunction 执行自定义筛选,并指定 nameCompareFunction 执行自定义排序。

由于 AIR 不支持文件系统通知,因此,在创建、删除、移动或重命名文件或子目录时不会自动刷新此控件;也就是说,它可以显示文件系统的过期视图。但是,您可以调用 refresh() 重新枚举当前的 directory。例如,当您执行了某个文件操作并已知此操作将导致控件的视图过期时,或者当用户取消激活或重新激活您的应用程序时,您可以选择执行此操作。

您可以使用 showIcons 属性显示或隐藏图标,使用 showExtensions 属性显示或隐藏文件扩展名。

该控件提供了 findItem()findIndex() 两种方法,您可以使用这两种方法搜索显示的文件和子目录,以查找具有指定 nativePath 的文件或子目录。

该控件还提供了 selectedPathselectedPaths 两个属性,工作原理与 selectedItemselectedItems 或者 selectedIndexselectedIndices 类似,但允许您通过 nativePath 字符串指定选择。如果需要显示已预先选择了特定项目的目录,它们将非常有用。因为在这种情况下,您还没有在控件枚举目录时控件将创建的 File 项目,并且不知道其索引将是什么。

该控件允许用户使用鼠标或键盘导航到其它目录。用户可以尝试使用下列方法更改目录:双击子目录;选中子目录后按 Enter 键或 Ctrl-Down;在控件不显示 COMPUTER 目录时按 Ctrl-Up;在存在要导航回的“上一个”目录时按 Ctrl-Left;在存在要导航到的“下一个”目录时按 Ctrl-Right。如果用户试图更改正在显示的目录,则该控件将分派可取消的 directoryChanging 事件。如果没有通过调用 event.preventDefault() 取消此事件,则该控件将显示新目录的内容,并且 directory 属性将发生更改。无论 directory 属性在何时由于任何原因发生更改,控件都会分派 directoryChange 事件通知您。

为了支持控件进行“向上”和“向下”导航,FileSystemList 提供了 canNavigateUpcanNavigateDown 属性,以及 navigateUp()navigateDown() 方法。还有一个 navigateTo(),可导航到任意目录。

该控件可跟踪用户曾经导航到的目录,以便支持控件进行“后退”和“前进”导航。有关详细信息,请参见 backHistoryforwardHistorycanNavigateBackcanNavigateForward 属性,以及 navigateBack()navigateForward() 方法。

注意:针对每个项目显示的图标都是通用文件和目录图标,您可以使用 fileIcondirectoryIcon 样式设置它们。Flex 的基于列表的控件当前支持仅显示嵌入的图标,但不支持在运行时读取的图标。因此,FileSystemList 中不显示操作系统中显示的实际文件系统图标,即使可以通过 File 的 icon 属性在 AIR 中访问它们。

flash.filesystem.FilefileChoose 当用户通过双击文件或选择文件并按 Enter 键来选择文件时分派此事件。mx.events.FileEvent.FILE_CHOOSEmx.events.FileEvent 当用户通过双击文件或选择文件并按 Enter 键来选择文件时分派此事件。 directoryChanging 当用户尝试更改此控件显示的目录时分派此事件。mx.events.FileEvent.DIRECTORY_OPENINGmx.events.FileEvent 当用户尝试更改此控件显示的目录时分派此事件。

用户可以尝试使用下列方法更改目录:双击子目录;选中子目录后按 Enter 键或 Ctrl-Down;在控件不显示 COMPUTER 目录时按 Ctrl-Up;在历史记录列表中存在要导航回的“上一个”目录时按 Ctrl-Left;在历史记录列表中存在要导航到的“下一个”目录时按 Ctrl-Right。

此事件是可取消的。如果调用 event.preventDefault(),则不会更改目录。

更改 directory 属性后,dataProvider 会包含新目录中项目的 File 实例,此时将分派 directoryChange 事件。

directoryChange 当此控件显示的目录由于某种原因发生更改时分派。mx.events.FileEvent.DIRECTORY_CHANGEmx.events.FileEvent 当此控件显示的目录由于某种原因发生更改时分派。 FileSystemList 构造函数。 构造函数。 clear 清除此控件,使其不显示任何项目。 清除此控件,使其不显示任何项目。

此方法会将 dataProvider 设置为 null,但 directory 属性保持不变。可以调用 refresh 再次填充此控件。

findIndex 返回具有指定本机文件系统路径的 File 项目的索引。从零开始的索引;如果在指定的路径中没有找到 File,则为 -1nativePath一个字符串,用于指定 File 项目的 nativePath 返回具有指定本机文件系统路径的 File 项目的索引。

不会搜索符合以下条件的项目:存在于控件的集合中,但由于筛选未能显示。

flash.filesystem.File.nativePath
findItem 搜索此控件中当前显示的 File 实例,并返回一个具有指定 nativePath 属性的实例。如果找到了一个具有指定 nativePath 的 File 实例,则返回该实例;如果没有找到,则返回 nullnativePath一个字符串,用于指定 File 项目的 nativePath 搜索此控件中当前显示的 File 实例,并返回一个具有指定 nativePath 属性的实例。

不会搜索符合以下条件的 File 实例:存在于控件的集合中,但由于筛选未能显示。

navigateBack 更改此控件可显示 backHistory 数组中上次访问过的目录中的内容。index0backHistory 数组中要导航到的索引。默认值为 0,指示“最近的返回”目录。 更改此控件可显示 backHistory 数组中上次访问过的目录中的内容。

如果 backHistory 数组为空,或者指定的索引不在该数组中,则此方法不会产生任何效果。

此方法返回时,directory 属性将包含新目录的 File 实例。枚举新目录之前,dataProvider 属性暂时为 null。枚举之后,dataProvider 属性将包含新目录内容的 File 实例的 ArrayCollection。

历史记录列表不会更改。但是,列表中的当前索引会发生更改,这会影响 backHistoryforwardHistory 属性。此方法返回新值后,这些属性即可获得新的值。

以下示例演示如何将此方法与 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);"/>
backHistorycanNavigateBack
navigateDown 更改此控件可显示所选子目录的内容。 更改此控件可显示所选子目录的内容。

如果没有选中子目录,则此方法不产生任何效果。

此方法返回时,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();"/>
canNavigateDown
navigateForward 更改此控件可显示 forwardHistory 数组中上次访问过的目录中的内容。index0forwardHistory 数组中要导航到的索引。默认值为 0,指示“最近的前往”目录。 更改此控件可显示 forwardHistory 数组中上次访问过的目录中的内容。

如果 forwardHistory 数组为空,或者指定的索引不在该数组中,则此方法不会产生任何效果。

此方法返回时,directory 属性将包含新目录的 File 实例。枚举新目录之前,dataProvider 属性暂时为 null。枚举之后,dataProvider 属性将包含新目录内容的 File 实例的 ArrayCollection。

历史记录列表不会更改。但是,列表中的当前索引会发生更改,这会影响 backHistoryforwardHistory 属性。此方法返回新值后,这些属性即可获得新的值。

以下示例演示如何将此方法与 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);"/>
canNavigateForwardforwardHistory
navigateTo 更改此控件可显示指定目录的内容。directory一个文件对象,表示文件或目录。 更改此控件可显示指定目录的内容。 navigateUp 更改此控件可显示层次结构中上一目录的内容。 更改此控件可显示层次结构中上一目录的内容。

如果此控件当前显示根目录(如 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();"/>
canNavigateUp
refresh 重新枚举此控件显示的当前目录。 重新枚举此控件显示的当前目录。

由于 AIR 不支持文件系统通知,因此,在创建、删除、移动或重命名文件或子目录时不会自动刷新此控件;也就是说,它可以显示文件系统的过期视图。不过,您可以调用 refresh() 来重新枚举当前 directory 以使其保持最新状态。例如,当您执行了某个文件操作并已知此操作将导致控件的视图过期时,或者当用户取消激活或重新激活您的应用程序时,您可以选择执行此操作。

此方法将保留所有选定的项目(如果它们仍然存在)和滚动位置(如果第一个可见项目仍然存在)。

COMPUTER 一个可用作 directory 属性值的常量,代表名为“Computer”的伪顶级目录。unknown 一个可用作 directory 属性值的常量,代表名为“Computer”的伪顶级目录。这个伪目录中包含根目录(如 Windows 上的 C:\ 和 D:\,或 Macintosh 上的 /)。 backHistory 一个 File 对象 Array,表示用户可以向后导航到的目录。[] 一个 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);"/>
canNavigateBacknavigateBack()mx.controls.FileSystemHistoryButton
canNavigateBack 一个标志,如果历史记录列表中至少存在一个可供用户向后导航的目录,则为 true。false 一个标志,如果历史记录列表中至少存在一个可供用户向后导航的目录,则为 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);"/>
backHistorynavigateBack()
canNavigateDown 一个标志,如果用户可向下导航至所选目录,则为 true。false 一个标志,如果用户可向下导航至所选目录,则为 true。如果未选中任何项目,或所选项目是一个文件而非目录时,此标志为 false

以下示例演示如何将此属性与 Button 控件一起使用:

      <mx:FileSystemList id="fileSystemViewer" directory="{File.desktopDirectory}"/>
      <mx:Button label="Open"
          enabled="{fileSystemViewer.canNavigateDown}"
          click="fileSystemViewer.navigateDown();"/>
navigateDown()
canNavigateForward 一个标志,如果历史记录列表中至少存在一个可供用户向前导航的目录,则为 true。false 一个标志,如果历史记录列表中至少存在一个可供用户向前导航的目录,则为 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);"/>
forwardHistorynavigateForward()
canNavigateUp 一个标志,如果用户可向上导航至父级目录,则为 true。false 一个标志,如果用户可向上导航至父级目录,则为 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();"/>
navigateUp()
directory 此控件显示内容所在的目录。COMPUTER 此控件显示内容所在的目录。

如果将此属性设置为代表现有目录的 File 对象,则 dataProvider 立即改为 null。稍后,在此控件经 LayoutManager 重新验证后,它将枚举目录的内容并使用生成的代表该目录中文件和子目录的 File 对象的 ArrayCollection 填充 dataProvider 属性。

将此属性设置为不代表现有目录的 File 对象将出现错误。将此属性设置为 COMPUTER 可同步显示根目录,如 Windows 上的 C:、D:。

设置此属性将取消对以前任何所选项目的选择,并会将控件的滚动位置重置到其左上角。

enumerationMode 一个 String,指定此控件是仅显示文件、仅显示子目录,还是两者均显示。FileSystemEnumerationMode.DIRECTORIES_FIRST 一个 String,指定此控件是仅显示文件、仅显示子目录,还是两者均显示。在两者都显示的情况下,它还可指定子目录显示在文件之前、之后还是与文件混合显示。可能的值由 FileSystemEnumerationMode 类指定。

此属性将影响控件中显示哪些子目录和文件,以及它们的显示顺序。不过,它不会影响 dataProvider 属性中存在哪些 File 实例;此属性通过更改应用于 dataProvider 的滤镜函数的行为起作用。设置此属性不会导致重新枚举当前 directory

设置此属性将取消对任何所选项目的选择,并会将控件的滚动位置重置到其左上角。

mx.controls.FileSystemEnumerationMode
extensions 扩展名的 Array,指定在此控件中可以显示哪些文件。null 扩展名的 Array,指定在此控件中可以显示哪些文件。例如,如果将此属性设置为 [ ".htm", ".html" ],则只显示具有这些扩展名的文件。

扩展名不区分大小写,且前面的句点是可选的。例如,指定 ".HTML" 与指定 "html" 效果相同。

即使目录的名称中包含句点,也不受扩展名筛选的影响。

enumerationModefilterFunction 属性也与确定在控件中显示哪些文件相关。例如,如果此属性为 [ ".htm", ".html" ],但 enumerationMode 属性为 FileSystemEnumerationMode.DIRECTORIES_ONLYfilterFunction 针对某个 .html 文件返回 false,则不会显示该文件。

如果此属性是 null,则不会进行扩展名筛选,但显示所有文件。如果此属性是空 Array,则会过滤所有扩展名,不显示带有扩展名的任何文件。

此属性将影响控件中显示哪些文件。不过,它不会影响 dataProvider 属性中存在哪些 File 实例;此属性通过更改应用于 dataProvider 的滤镜函数的行为起作用。设置此属性不会导致重新枚举当前 directory

设置此属性将取消对任何所选项目的选择,并会将控件的滚动位置重置到其左上角。

filterFunction 在应用 enumerationMode 和扩展名属性后,可用来执行其它筛选以确定显示及隐藏哪些文件和子目录的回调函数。null 在应用 enumerationModeextensions 属性后,可用来执行其它筛选以确定显示及隐藏哪些文件和子目录的回调函数。

该函数必须具有以下特征:

function myFilterFunction(file:File):Boolean
此函数应返回 true 以表示显示指定的文件或子目录;应返回 false 以表示隐藏指定的文件或子目录。

若要确保将每个枚举的文件和子目录都传递给此函数,enumerationMode 属性不能为 FileSystemEnumerationMode.FILES_ONLYFileSystemEnumerationMode.DIRECTORIES_ONLY,且 extensions 属性必须是 null。否则,这些属性将导致在调用此滤镜函数之前进行预筛选。

此属性将影响控件中显示哪些子目录和文件。不过,它不会影响 dataProvider 属性中存在哪些 File 实例;此属性通过更改应用于 dataProvider 的滤镜函数的行为起作用。设置此属性不会导致重新枚举当前 directory

设置此属性将取消对任何所选项目的选择,并会将控件的滚动位置重置到其左上角。

forwardHistory 一个 File 对象 Array,表示用户可以向前导航到的目录。[] 一个 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);"/>
canNavigateForwardnavigateForward()mx.controls.FileSystemHistoryButton
nameCompareFunction 可用于更改文件和子目录名称的比较方式以生成排序顺序的回调函数。null 可用于更改文件和子目录名称的比较方式以生成排序顺序的回调函数。

该函数必须具有以下特征:

function myNameCompareFunction(name1:String, name2:String):int

如果 name1 应排在 name2 之前,则返回 -1;如果 name1 应排在 name2 之后,则返回 1;如果名称相同,则返回 0

如果未设置此属性,则控件将对两个名称执行不区分大小写、依赖区域设置的比较。首先对每个名称调用 String 方法 toLocaleLowerCase(),然后使用 <> 运算符进行比较。

如果已将 enumerationMode 设置为 FileSystemEnumerationMode.FILES_FIRSTFileSystemEnumerationMode.DIRECTORIES_FIRST,则仅使用此方法比较单组文件和目录之内的名称。

此属性将影响子目录和文件在控件中的显示顺序。不过,它不会影响 dataProvider 属性中的 File 实例;它通过更改应用于 dataProvider 的排序行为起作用。设置此属性不会导致重新枚举当前 directory

设置此属性将取消对任何所选项目的选择,并会将控件的滚动位置重置到其左上角。

selectedPath 表示所选子目录或文件的 File 项目的 nativePath;如果未选定任何项目,则为 null。null 表示所选子目录或文件的 File 项目的 nativePath;如果未选定任何项目,则为 null

如果选择了多个项目,此属性将获得 selectedPaths 数组中的第一个路径。

设置此属性将影响 selectedPathsselectedItemselectedItemsselectedIndexselectedIndices 属性。

mx.controls.listClasses.ListBase.selectedIndexmx.controls.listClasses.ListBase.selectedItem
selectedPaths 表示所选子目录和文件的 File 项目的 nativePath 字符串 Array。[] 表示所选子目录和文件的 File 项目的 nativePath 字符串 Array。如果未选择任何项目,则此 Array 为空。

设置此属性将影响 selectedPathsselectedItemselectedItemsselectedIndexselectedIndices 属性。

mx.controls.listClasses.ListBase.selectedIndexmx.controls.listClasses.ListBase.selectedItem
showExtensions 一个标志,指定是否显示文件名称中的扩展名。true 一个标志,指定是否显示文件名称中的扩展名。将此属性设置为 true 将显示文件扩展名,设置为 false 将隐藏文件扩展名。始终显示目录名称中的扩展名。

设置此属性不会影响显示哪些项目或它们出现的顺序,也不会影响选择哪些项目或滚动位置。

showHidden 一个标志,指定是否显示操作系统视为隐藏的文件和目录。false 一个标志,指定是否显示操作系统视为隐藏的文件和目录。将此属性设置为 true 将显示隐藏的文件和目录,设置为 false 将隐藏它们。

设置此属性将取消对任何所选项目的选择,并会将控件的滚动位置重置到其左上角。

showIcons 一个标志,指定在文件名称之前显示图标。true 一个标志,指定在文件名称之前显示图标。将此属性设置为 true 将显示图标,设置为 false 将隐藏图标。

您可以设置 directoryIconfileIcon 样式来更改默认图标。此控件无法显示操作系统针对文件显示的实际图标,因为 AIR 不支持该功能。

设置此属性不会影响显示哪些项目或它们出现的顺序,也不会影响选择哪些项目或滚动位置。

FileSystemSizeDisplayMode FileSystemSizeDisplayMode 类为 FileSystemDataGrid 类的 sizeDisplayMode 属性定义常数值。Object FileSystemSizeDisplayMode 类为 FileSystemDataGrid 类的 sizeDisplayMode 属性定义常量值。 mx.controls.FileSystemDataGrid.enumerationModeBYTES 指定以字节为单位显示文件大小。bytes 指定以字节为单位显示文件大小。 KILOBYTES 指定以千字节为单位显示文件大小。kilobytes 指定以千字节为单位显示文件大小。 HTML HTML 控件允许您显示应用程序中的 HTML 内容。The <mx:HTML> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <mx:HTML
    Properties
    data="null"
    historyPosition="0"
    htmlHost="null"
    htmlLoaderFactory="mx.core.ClassFactory"
    htmlText=""
    listData="null"
    location=""
    paintsDefaultBackground="false"
    runtimeApplicationDomain="null"
    userAgent="null"
 
    Styles
    paddingBottom="0"
    paddingLeft="0"
    paddingRight="0"
    paddingTop="0"
 
    Events
    complete="No default"
    htmlDOMInitialize="No default"
    htmlRender="No default"
    locationChange="No default"
    uncaughtScriptException="No default"
  />
  
]]>
mx.core:IDataRenderermx.controls.listClasses:IDropInListItemRenderermx.controls.listClasses:IListItemRenderermx.managers:IFocusManagerComponentmx.core:ScrollControlBase HTML 控件允许您显示应用程序中的 HTML 内容。

可以使用 location 属性指定在控件中显示其内容的 HTML 页面的 URL,也可以设置 htmlText 属性来指定包含控件中所显示的 HTML 格式的文本的 String。

HTMLLoaderuncaughtScriptException 当发生未捕获的 JavaScript 异常时分派。flash.events.HTMLUncaughtScriptExceptionEvent.UNCAUGHT_SCRIPT_EXCEPTIONflash.events.HTMLUncaughtScriptExceptionEvent 当发生未捕获的 JavaScript 异常时分派。

此事件始终异步调度。此事件的事件处理函数可以调用此控件或其内部 htmlLoader 的任何方法或访问它们的任何属性。

locationChange 当 location 属性发生变化时分派。flash.events.Event.LOCATION_CHANGEflash.events.Eventlocation 属性发生变化时分派。

此事件始终异步调度。此事件的事件处理函数可以调用此控件或其内部 htmlLoader 的任何方法或访问它们的任何属性。

htmlRender 当首次呈示此控件的 HTML 内容时以及以后每次重新呈示该内容时分派。flash.events.Event.HTML_RENDERflash.events.Event 当首次呈示此控件的 HTML 内容时以及以后每次重新呈示该内容时分派。

因为 HTML 控件可以分派这些事件中的许多事件,所以应避免在 render 处理函数中进行可能对性能产生重大负面影响的处理。

htmlDOMInitialize 在初始化 HTML DOM 后分派,以响应由于设置 location 或 htmlText 属性而导致的加载操作。flash.events.Event.HTML_DOM_INITIALIZEflash.events.Event 在初始化 HTML DOM 后分派,以响应由于设置 locationhtmlText 属性而导致的加载操作。

分派此事件时,尚未执行任何 JavaScript 方法。存在 domWindowdomWindow.document 对象,但其他 DOM 对象可能不存在。您可以使用此事件将这些属性设置在 domWindowdomWindow.document 对象上,供 JavaScript 方法以后访问。

此事件的处理函数不应设置任何属性或调用任何方法,因为这会启动另一个加载操作或影响当前加载操作的 URL;这样做会导致 ActionScript 或 JavaScript 异常。

locationhtmlText
complete 当由设置 location 或 htmlText 属性引发的最后一个加载操作完成后分派。flash.events.Event.COMPLETEflash.events.Event 当由设置 locationhtmlText 属性引发的最后一个加载操作完成后分派。

在 HTML DOM 中分派 JavaScriptload 事件后,始终异步分派此事件。

此事件的事件处理函数可以调用此控件或其内部 htmlLoader 的任何方法或访问它们的任何属性。

locationhtmlText
HTML 构造函数。 构造函数。 cancelLoad 取消正在进行的任何加载操作。 取消正在进行的任何加载操作。

如果在创建组件的内部 HTMLLoader(htmlLoader 属性)之前调用此方法,则此方法不会执行任何操作。

getHistoryAt 返回位于此控件的历史记录列表中指定位置的 HTMLHistoryItem。位于指定位置的历史记录条目的 HTMLHistoryItem 对象。 position历史记录列表中的位置。 返回位于此控件的历史记录列表中指定位置的 HTMLHistoryItem。

如果在创建此组件的内部 HTMLLoader(htmlLoader 属性)之前调用此方法,则此方法将返回 null

historyPosition
historyBack 如果可能,在此控件的历史记录列表中向后导航。 如果可能,在此控件的历史记录列表中向后导航。

调用 HTMLLoader 对象的此方法与在 HTML 内容中调用 JavaScript 的 window.history 属性的 back() 方法效果相同。

如果在创建组件的内部 HTMLLoader(htmlLoader 属性)之前调用此方法,则此方法不会执行任何操作。

historyPositionhistoryForward()
historyForward 如果可能,在此控件的历史记录列表中向前导航。 如果可能,在此控件的历史记录列表中向前导航。

调用 HTMLLoader 对象的此方法与在 HTML 内容中调用 JavaScript 的 window.history 属性的 forward() 方法效果相同。

此函数不引发错误。

如果在创建组件的内部 HTMLLoader(htmlLoader 属性)之前调用此方法,则此方法不会执行任何操作。

historyPositionhistoryBack()
historyGo 在此控件的历史记录列表中导航指定数目的步骤。steps历史记录列表中要向前移动(正数)或向后移动(负数)的步骤数。 在此控件的历史记录列表中导航指定数目的步骤。

如果步骤数为正数,则此方法向前导航;如果为负数,则向后导航。导航零个步骤与调用 reload() 等效。

此方法与在 HTML 内容中调用 JavaScript 的 window.history 属性的 go() 方法等效。

如果在创建组件的内部 HTMLLoader(htmlLoader 属性)之前调用此方法,则此方法不会执行任何操作。

reload 从当前位置重新加载 HTML 内容。 从当前 location 重新加载 HTML 内容。

如果在创建组件的内部 HTMLLoader(htmlLoader 属性)之前调用此方法,则此方法不会执行任何操作。

htmlLoader 呈示此控件的 HTML 内容的内部 HTMLLoader 对象。 呈示此控件的 HTML 内容的内部 HTMLLoader 对象。 contentHeight HTML 内容的高度(以像素为单位)。 HTML 内容的高度(以像素为单位)。 contentWidth HTML 内容的宽度(以像素为单位)。 HTML 内容的宽度(以像素为单位)。 data 用于在项呈示器或项目编辑器中使用组件时将值传递给该组件。null 用于在项呈示器或项目编辑器中使用组件时将值传递给该组件。您通常使用数据绑定将 data 属性的字段绑定到此组件的某个属性。

将控件用作嵌入式项呈示器或嵌入式项目编辑器时,Flex 自动将项目的当前值写入此控件的 text 属性。

无法在 MXML 中设置此属性。

mx.core.IDataRenderer
domWindow 表示此控件中 HTML DOM 的根帧的 JavaScript window 对象。null 表示此控件中 HTML DOM 的根帧的 JavaScriptwindow 对象。

在分派 htmlDOMInitialize 事件之前,此属性为 null

historyLength 历史记录列表的总长度,包括向后和向前的条目。 历史记录列表的总长度,包括向后和向前的条目。此属性与 HTML 内容的 window.history.lengthJavaScript 属性具有相同的值。 historyPositionhistoryPosition 历史记录列表中的当前位置。0 历史记录列表中的当前位置。

历史记录列表与 HTML 内容的 window.history 对象对应。低于当前位置的条目为“向前”列表,高于当前位置的条目为“向后”列表。尝试将该位置设置到末尾以外会将此位置设置到末尾处。

htmlHost HTMLHost 对象用于处理 HTML 内容中某些用户界面元素(如 window.document.title 属性)的更改。null HTMLHost 对象用于处理 HTML 内容中某些用户界面元素(如 window.document.title 属性)的更改。

若要覆盖 HTMLLoader 的默认行为,请创建 HTMLHost 类的子类,覆盖其成员函数以处理 HTML 内容中的各种用户界面更改,并将此属性设置为子类的实例。

htmlLoaderFactory IFactory,可创建要用作 htmlLoader 的由 HTMLLoader 派生的实例。 IFactory,可创建要用作 htmlLoader 的由 HTMLLoader 派生的实例。

默认值是 HTMLLoader 的 IFactory。

htmlText 指定该控件显示的 HTML 格式的 String。"" 指定该控件显示的 HTML 格式的 String。

如果设置此属性,location 属性也会同时被设置为 null,反之亦然。

通过 htmlText 属性添加的内容放置在应用程序安全沙箱中。如果 AIR 应用程序包括位于应用程序沙箱中的 HTML 控件,且通过设置 htmlText 属性将远程 HTML 代码直接添加到控件中,则在应用程序沙箱中将执行 HTML 文本中包含的任何脚本。

location
imeMode 指定 IME(输入法编辑器)模式。null 指定 IME(输入法编辑器)模式。IME 使用户能够用中文、日文和韩文输入文本。当控件获得焦点时,Flex 设置指定的 IME 模式;当该控件失去焦点时,则将其设置回为先前的值。

flash.system.IMEConversionMode 类定义此属性的有效值的常量。您还可以指定 null 不指定任何 IME 模式。

flash.system.IMEConversionMode
listData 使用组件作为嵌入式项呈示器或嵌入式项目编辑器时,Flex 将使用 List 控件中的相应数据初始化该组件的 listData 属性。null 使用组件作为嵌入式项呈示器或嵌入式项目编辑器时,Flex 将使用 List 控件中的相应数据初始化该组件的 listData 属性。然后,组件可使用 listData 属性初始化嵌入式项呈示器或嵌入式项目编辑器的 data 属性。

您无需在 MXML 或 ActionScript 中设置此属性;将组件用作嵌入式项呈示器或嵌入式项目编辑器时,Flex 会对其进行设置。

mx.controls.listClasses.IDropInListItemRenderer
loaded 一个标志,指示是否已将对应于先前加载操作的 JavaScript load 事件传递到此控件的 HTML DOM 中。false 一个标志,指示是否已将对应于先前加载操作的 JavaScriptload 事件传递到此控件的 HTML DOM 中。

在分派 complete 事件之前,此属性为 true

此属性可能永远不会变为 true。在这种情况下,也从不会分派 complete 事件。

location 此控件将显示的 HTML 页的 URL。"" 此控件将显示的 HTML 页的 URL。

如果设置此属性,htmlText 属性也会同时被设置为 null,反之亦然。

htmlText
paintsDefaultBackground 此控件的 HTML 内容背景是否为默认的不透明白色。false; 此控件的 HTML 内容背景是否为默认的不透明白色。

如果此属性为 false,则为此 Flex 控件指定的背景(如果存在)将显示在 HTML 内容后面。

但是,如果任何 HTML 元素具有自己的不透明背景颜色(例如,由 style="background-color:gray" 指定),则该背景将显示在该元素后面。

pdfCapability 用户系统上的 PDF 支持类型,它被定义为整数代码值。 用户系统上的 PDF 支持类型,它被定义为整数代码值。

只有在此属性的计算结果为 PDFCapability.STATUS_OK 时,HTML 对象才能显示 PDF 内容。PDFCapability 类定义用作 pdfCapability 属性的可能值的常数,如下所示:

PDFCapability 常量意义 STATUS_OK 已检测到足够高版本的 Acrobat Reader(8.1 或更高版本),可以在 HTML 对象中加载 PDF 内容。

注意:在 Windows 上,如果用户系统上当前正在运行 Acrobat 或 Acrobat Reader 7.x 或更高版本,则即使安装了支持加载 PDF(HTML 对象中已加载)的更高版本,也会使用该版本。在这种情况下,如果 pdfCampability 属性的值为 PDFCapability.STATUS_OK,则当 AIR 应用程序尝试将 PDF 内容加载到 HTML 对象时,Acrobat 或 Reader 的较早版本会显示警告,而不出现显示 AIR 运行时的错误消息。如果您的最终用户可能会遇到这种情况,您可以考虑向他们提供说明,以在运行应用程序时关闭 Acrobat。如果 PDF 内容在可以接受的时间范围内未加载,则您可以考虑显示这些说明。

ERROR_INSTALLED_READER_NOT_FOUND 未检测到任何 Acrobat Reader 版本。HTML 对象无法显示 PDF 内容。 ERROR_INSTALLED_READER_TOO_OLD 已检测到 Acrobat Reader,但版本太旧。HTML 对象无法显示 PDF 内容。 ERROR_PREFERED_READER_TOO_OLD 已检测到适用版本的 Acrobat Reader(8.1 或更高版本),但设置用于处理 PDF 内容的 Acrobat Reader 版本低于 Reader 8.1。HTML 对象无法显示 PDF 内容。
runtimeApplicationDomain 用于 HTML 的 window.runtime 脚本的 ApplicationDomain。null 用于 HTML 的 window.runtime 脚本的 ApplicationDomain。

如果此属性为 null,或它指定了与 HTML 内容位于不同安全域中的 ApplicationDomain,则 HTML 页将使用此页的域中的默认 ApplicationDomain

userAgent 此控件的内容请求中使用的用户代理字符串。null 此控件的内容请求中使用的用户代理字符串。

通过设置静态 URLRequestDefaults.userAgent 属性,您可以设置供应用程序域中所有 HTML 控件使用的默认用户代理字符串。如果未为 userAgent 属性设置任何值(或将其值设置为 null),则用户代理字符串的值将设置为 URLRequestDefaults.userAgent

如果既未设置此控件的 userAgent 属性值,也未设置 URLRequestDefaults.userAgent 属性值,则用户代理字符串将采用默认值。此默认值随着运行时操作系统(如 Mac OS 或 Windows)、运行时语言和运行时版本而变化,如下面两个示例所示:

      "Mozilla/5.0 (Macintosh; U; PPC Mac OS X; en) AppleWebKit/420+ (KHTML, like Gecko) AdobeAIR/1.0"
      "Mozilla/5.0 (Windows; U; en) AppleWebKit/420+ (KHTML, like Gecko) AdobeAIR/1.0"
      
flash.net.URLRequest.userAgentflash.net.URLRequestDefaults.userAgent
FlexNativeMenu FlexNativeMenu 组件为 AIR 的 NativeMenu 类提供包装。The <mx:FlexNativeMenu> tag supports the following tag attributes:

  <mx:FlexNativeMenu
    Properties
    dataDescriptor="mx.controls.treeClasses.DefaultDataDescriptor"
    dataProvider="undefined"
    keyEquivalentField="keyEquivalent"
    keyEquivalentFunction="undefined"
    keyEquivalentModifiersFunction="undefined"
    labelField="label"
    labelFunction="undefined"
    mnemonicIndexField="mnemonicIndex"
    mnemonicIndexFunction="undefined"
    showRoot="true"
 
    Events
    itemClick="No default"
    menuShow="No default"
  />
  
]]>
mx.managers:ILayoutManagerClientmx.controls:IFlexContextMenumx.automation:IAutomationObjectflash.events:EventDispatcher FlexNativeMenu 组件为 AIR 的 NativeMenu 类提供包装。FlexNativeMenu 提供了一种使用 Flex 开发人员熟悉且与其他 Flex 菜单组件一致的技术定义本机操作系统菜单(如窗口、应用程序和上下文菜单)的方法,如使用 MXML 和数据提供程序指定菜单结构。然而,与 Flex 菜单组件不同,FlexNativeMenu 组件定义的菜单由主机操作系统作为 AIR 应用程序的一部分呈示,而不是由 Flex 作为可视组件创建。

与其他 Flex 菜单组件相同的是,要定义由 FlexNativeMenu 组件表示的菜单的结构,需要创建一个数据提供程序(如 XML 层次结构或对象数组),其中包含要用于定义该菜单的数据。可以设置多个属性来定义如何解释数据提供程序数据,如 labelField 属性指定用于菜单项标签的数据字段,keyEquivalentField 属性指定定义菜单项的键盘等效快捷方式的字段,mnemonicIndexField 属性指定标签中用作菜单项助记键字符的索引位置的字段。

FlexNativeMenu 项目的数据提供程序可以指定几个属性来确定项目的显示方式和行为方式,如以下 XML 数据提供程序所示:

   <mx:XML format="e4x" id="myMenuData">
     <root>
        <menuitem label="MenuItem A">
            <menuitem label="SubMenuItem A-1" enabled="False"/>
            <menuitem label="SubMenuItem A-2"/>
        </menuitem>
        <menuitem label="MenuItem B" type="check" toggled="true"/>
        <menuitem label="MenuItem C" type="check" toggled="false"/>
        <menuitem type="separator"/>
        <menuitem label="MenuItem D">
            <menuitem label="SubMenuItem D-1"/>
            <menuitem label="SubMenuItem D-2"/>
            <menuitem label="SubMenuItem D-3"/>
        </menuitem>
    </root>
 </mx:XML>

下表列出了您可以指定的属性及其数据类型、目的,以及数据提供程序表示它们必须采取的方式(如果菜单使用 DefaultDataDescriptor 类分析数据提供程序):

属性类型说明 altKey Boolean 指定是否需要使用 Alt 键作为此项目等效键的一部分。 cmdKey Boolean 注意:从 Flex 3.2 起不再推荐使用此属性。请改用 commandKey。指定是否需要使用 Command 键作为此项目等效键的一部分。 commandKey Boolean 指定是否需要使用 Command 键作为此项目等效键的一部分。 controlKey Boolean 指定是否需要使用 Ctrl 键作为此项目等效键的一部分。 ctrlKey Boolean 注意:从 Flex 3.2 起不再推荐使用此属性。请改用 controlKey。指定是否需要使用 Ctrl 键作为此项目等效键的一部分。 enabled Boolean 指定用户可以选择菜单项 (true),还是不可以选择菜单项 (false)。如果未指定,则 Flex 将假定该值为 true 来处理此项目。如果您使用默认数据说明符,则数据提供程序必须使用 enabledXML 属性或对象字段来指定此特征。 keyEquivalent String 指定一个键盘字符,当按下该字符时会像选择菜单项一样触发事件。菜单的 keyEquivalentFieldkeyEquivalentFunction 属性确定数据中指定等效键的字段名称,或确定等效键的函数。(如果数据提供程序采用 E4X XML 格式,则必须指定其中一个属性以分配等效键。) label String 指定控件中显示的文本。此项目适用于除 separator 之外的所有菜单项类型。菜单的 labelFieldlabelFunction 属性确定数据中指定标签的字段名称,或确定标签的函数。(如果数据提供程序采用 E4X XML 格式,则必须指定其中一个属性以显示标签。)如果数据提供程序是字符串数组,则 Flex 使用字符串值作为标签。 mnemonicIndex 整型 指定标签中用作菜单项助记键的字符的索引位置。菜单的 mnemonicIndexFieldmnemonicIndexFunction 属性确定数据中指定助记键索引的字段名称,或确定助记键索引的函数。(如果数据提供程序采用 E4X XML 格式,则必须指定这些属性之一,以便指定数据中的助记键索引。)此外,您可以紧挨着某个字符在其左侧添加下划线,以此指示标签中的该字符是菜单项的助记键。 shiftKey Boolean 指定是否需要使用 Shift 键作为此项目等效键的一部分。 toggled Boolean 指定是否选择了检查项目。如果未指定,则 Flex 处理该项目的方式将视同该值为 false 一样,并且该项目是不选中的。如果您使用默认数据说明符,则数据提供程序必须使用 toggledXML 属性或对象字段来指定此特征。 type String 指定菜单项的类型。有效值为 separatorcheck。Flex 将其他所有值或无类型条目的节点视为常规菜单条目。如果您使用默认数据说明符,则数据提供程序必须使用 typeXML 属性或对象字段来指定此特征。

要创建窗口菜单,请将 FlexNativeMenu 设置为窗口的 menu 属性,或者应在其上显示菜单的 WindowedApplication 实例。要创建应用程序菜单,请分配 FlexNativeMenu 作为应用程序的 WindowedApplication 的 menu 属性。要分配 FlexNativeMenu 作为部分用户界面的上下文菜单,请调用 FlexNativeMenu 实例的 setContextMenu() 方法,而将 UI 对象作为参数传递。调用 FlexNativeMenu 组件的 display() 方法,将该菜单显示为应用程序的任一窗口中的弹出菜单。

要检测何时会触发菜单项命令,请为 itemClick 事件注册侦听器。您还可以为 menuShow 事件注册侦听器以确定何时打开任何菜单或子菜单。

flash.display.NativeMenumx.events.FlexNativeMenuEventitemClick 选择菜单项时分派。mx.events.FlexNativeMenuEvent.ITEM_CLICKmx.events.FlexNativeMenuEvent 选择菜单项时分派。 menuShow 显示菜单或子菜单前分派。mx.events.FlexNativeMenuEvent.MENU_SHOWmx.events.FlexNativeMenuEvent 显示菜单或子菜单前分派。 FlexNativeMenu 构造函数。 构造函数。 commitProperties 处理对组件设置的属性。 处理对组件设置的属性。 mx.core.UIComponent.commitProperties()createAutomationIDPartWithRequiredProperties childproperties createAutomationIDPart child display 在指定位置弹出此菜单。stage要显示此菜单的 Stage 对象。 x相对于要显示此菜单的舞台原点的水平像素数。 y相对于要显示此菜单的舞台原点的垂直像素数。 在指定位置弹出此菜单。 getAutomationChildAt index getAutomationChildren invalidateProperties itemToKeyEquivalentModifiers 基于 keyEquivalentModifiersFunction 属性返回给定数据对象的等效功能键。基于数据的等效功能键数组. data要显示的对象。 基于 keyEquivalentModifiersFunction 属性,返回给定数据对象的等效功能键。如果这种方法无法将此参数转换为功能键 Array,则返回一个空 Array。 itemToKeyEquivalent 基于 keyEquivalentField 和 keyEquivalentFunction 属性返回给定数据对象的等效键。基于数据的等效键。 data要显示的对象。 基于 keyEquivalentFieldkeyEquivalentFunction 属性返回给定数据对象的等效键。如果该方法无法将参数转换为字符串,则会返回一个空字符串。 itemToLabel 基于 labelField 和 labelFunction 属性,返回用作给定数据对象的菜单项标签的 String。根据数据要显示的字符串。 data要显示的对象。 基于 labelFieldlabelFunction 属性返回用作给定数据对象的菜单项标签的 String。如果该方法无法将参数转换为 String,则会返回一个空格。 itemToMnemonicIndex 基于 mnemonicIndexField 和 mnemonicIndexFunction 属性,返回给定数据对象的助记键索引。基于数据的助记键索引。 data要显示的对象。 基于 mnemonicIndexFieldmnemonicIndexFunction 属性返回给定数据对象的助记键索引。如果这种方法无法将此参数转换为整数,则返回 -1。 parseLabelToMnemonicIndex 根据是否存在下划线字符从标签中提取助记键索引。索引。 data要对其进行分析以提取索引的数据。 根据是否存在下划线字符从标签中提取助记键索引。如果存在前导下划线字符,则查找该字符并将其用作索引。 parseLabelToString 确定用于 NativeMenuItem 的实际标签,方法为删除下划线字符,然后转换转义下划线字符(如果存在)。标签。 data要对其进行分析以提取标签的数据。 确定用于 NativeMenuItem 的实际标签,方法为删除下划线字符,然后转换转义下划线字符(如果存在)。 replayAutomatableEvent event resolveAutomationIDPart criteria setContextMenu 将 InteractiveObject 的上下文菜单设置为基础本机菜单。component交互式对象。 将 InteractiveObject 的上下文菜单设置为基础本机菜单。 unsetContextMenu 取消对已设为基础本机菜单的 InteractiveObject 上下文菜单的设置。component交互式对象。 取消对已设为基础本机菜单的 InteractiveObject 上下文菜单的设置。 validateDisplayList validateNow 验证并更新此对象的属性和布局,并重绘该对象(如果需要)。 验证并更新此对象的属性和布局,并重绘该对象(如果需要)。 validateProperties validateSize recursivefalse automationDelegate 处理自动化相关功能的委托对象。 处理自动化相关功能的委托对象。 automationEnabled automationName automationOwner automationParent automationTabularData automationValue automationVisible dataDescriptor 访问并处理数据提供程序中数据的对象。 访问并处理数据提供程序中数据的对象。FlexNativeMenu 控件委托数据描述符提供其数据的相关信息。然后,这些数据用于分析和移动数据源。为 FlexNativeMenu 定义的数据描述符可供其所有子菜单和下级菜单使用。

如果要将此属性指定为 MXML 中的某个属性,则必须使用对数据描述符的引用,而不是描述符的字符串名称。请使用下列格式设置此属性:

<mx:FlexNativeMenu id="flexNativeMenu" dataDescriptor="{new MyCustomDataDescriptor()}"/>

或者,您可以在 MXML 中将该属性指定为嵌套子标签,如下例所示:

<mx:FlexNativeMenu>
      <mx:dataDescriptor>
         <myCustomDataDescriptor>
      </mx:dataDescriptor>
      ...

默认值为 DefaultDataDescriptor 类的内部实例。

dataProvider 用于定义 NativeMenu 中菜单项结构的对象的层次结构。"undefined" 用于定义 NativeMenu 中菜单项结构的对象的层次结构。各个数据对象定义菜单项,项目及其子项将成为菜单和子菜单。

FlexNativeMenu 控件按如下方式处理源数据对象:

  • 包含有效 XML 文本的 String 将转化为 XML 对象。
  • XMLNode 将转化为 XML 对象。
  • 将 XMLList 转换为 XMLListCollection。
  • 将实现 ICollectionView 接口的任何对象转换为 ICollectionView。
  • 将 Array 转换为 ArrayCollection。
  • 将任何其它类型的对象作为 Array 的唯一条目纳入该 Array 中。
hasRoot initialized keyEquivalentField 数据提供程序中的字段名称,用以确定每个菜单项的等效键。"keyEquivalent" 数据提供程序中的字段名称,用以确定每个菜单项的等效键。采用的一系列值在 Keyboard 类中以 KEYNAME_XXXX 常量定义。例如,查阅该列表了解控制字符(如 Home、Insert 等)的值。

设置 keyEquivalentFunction 属性将导致此属性被忽略。

flash.ui.Keyboard
keyEquivalentFunction 确定每个菜单项等效键的函数。"undefined" 确定每个菜单项等效键的函数。如果省略此属性,则 Flex 将使用 keyEquivalentField 属性指定的字段或属性的内容。如果指定了此属性,则 Flex 将忽略任何 keyEquivalentField 属性值。

keyEquivalentFunction 属性适用于处理格式化、本地化和平台独立性。

等效功能键函数必须采用一个参数,该参数是数据提供程序中的项目,并且必须返回一个 String。

myKeyEquivalentFunction(item:Object):String
flash.ui.Keyboard
keyEquivalentModifiersFunction 确定每个菜单项的等效功能键的函数。"undefined" 确定每个菜单项的等效功能键的函数。如果省略此属性,则 Flex 将使用其自身默认的函数来确定功能键的 Array,具体方法是在数据提供者数据中确定是否存在以下(布尔型)字段:altKeycommandKeycontrolKeyshiftKey

keyEquivalentModifiersFunction 属性适用于处理格式化、本地化和平台独立性。

等效功能键函数必须采用一个参数,该参数是数据提供程序中的项目,并且必须返回一个功能键名称数组。

myKeyEquivalentModifiersFunction(item:Object):Array
labelField 数据提供程序中的字段名称,用以确定每个菜单项的显示文本。"label" 数据提供程序中的字段名称,用以确定每个菜单项的显示文本。如果数据提供程序是一个字符串 Array,则 Flex 会将每个字符串值作为标签使用。如果数据提供程序是一个 E4X XML 对象,则必须显式设置此属性。例如,如果 E4X XML 对象中的每个 XML 元素都包含一个“label”属性,其中包含每个菜单项的显示文本,则请将 labelField 设置为 "@label"

在标签中,您可以通过在字符前添加下划线指定将该字符用作助记键索引。例如,"C_ut" 标签值将助记键索引设置为 1。只有显示的第一个下划线具有此功能。若要在标签中显示文字下划线字符,您可以使用一条双下划线对其进行转义。例如,"C__u_t" 标签值可能会生成标签为“C_ut”、助记键索引为 3(“t”字符)的菜单项。如果存在由 mnemonicIndexField 属性定义的字段,并且设置为大于零的值,则此值将优先于任何用下划线指定的助记键索引值。

设置 labelFunction 属性将导致此属性被忽略。

labelFunction 用于确定每个菜单项的显示文本的函数。"undefined" 用于确定每个菜单项的显示文本的函数。标签函数必须在数据提供程序中查找一个或多个相应的字段,并返回一个可显示的字符串。

如果省略此属性,Flex 将使用 labelField 属性指定的字段或属性的内容。如果指定了此属性,则 Flex 将忽略任何 labelField 属性值。

labelFunction 属性有助于处理格式化、本地化和平台独立性。

标签函数必须采用一个参数,该参数是数据提供程序中的项目,并且必须返回一个字符串。

myLabelFunction(item:Object):String
mnemonicIndexField 数据提供程序中的字段名称,用以确定每个菜单项的助记键索引。"mnemonicIndex" 数据提供程序中的字段名称,用以确定每个菜单项的助记键索引。

如果此属性指定的字段中包含大于零的数值,则助记键索引将优先于标签中用下划线指定的索引。

设置 mnemonicIndexFunction 属性将导致此属性被忽略。

labelField
mnemonicIndexFunction 确定每个菜单项的助记键索引的函数。"undefined" 确定每个菜单项的助记键索引的函数。

如果省略此属性,Flex 将使用 mnemonicIndexField 属性指定的字段或属性的内容。如果指定了此属性,则 Flex 将忽略任何 mnemonicIndexField 属性值。

如果已定义此属性,并且该函数针对数据项目返回大于零的数值,则返回的助记键索引将优先于标签中用下划线指定的索引。

mnemonicIndexFunction 属性适用于处理格式化、本地化和平台独立性。

助记键索引函数必须采用一个参数,该参数是数据提供程序中的项目,并且必须返回一个常量。

myMnemonicIndexFunction(item:Object):int
nativeMenu 返回由此对象管理的 flash.display.NativeMenu;如果不存在,则返回 null。 返回由此对象管理的 flash.display.NativeMenu;如果不存在,则返回 null。如果更改菜单或基础数据提供程序,则可能会丢失直接对基础 NativeMenu 实例所做的任何更改。 nestLevel numAutomationChildren processedDescriptors showInAutomationHierarchy showRoot 指定是否显示数据提供程序的根节点的布尔值标志。true 指定是否显示数据提供程序的根节点的布尔值标志。

如果数据提供程序具有根节点,但 showRoot 属性设置为 false,则 FlexNativeMenu 控件显示的顶级菜单项与根节点的直接子节点对应。

在使用没有根节点的数据提供程序(如 List 或 Array)时,此标志不起任何作用。

hasRoot
updateCompletePendingFlag 一个标志,确定某个对象是否已通过所有三个阶段的布局验证(假设需要通过所有验证)。 一个标志,确定某个对象是否已通过所有三个阶段的布局验证(假设需要通过所有验证)。
FileSystemHistoryButton FileSystemHistoryButton 控件定义包含两个按钮的单个控件:左侧的主按钮和右侧的辅助按钮。The <mx:FileSystemHistoryButton> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <mx:FileSystemHistoryButton
    Properties
    dataProvider="undefined"
 
    Events
    itemClick="No default"
  />
  
]]>
mx.controls:PopUpButton FileSystemHistoryButton 控件定义包含两个按钮的单个控件:左侧的主按钮和右侧的辅助按钮。

主按钮上可以包含一个文本标签、一个图标,或者两者都包含。当用户单击主按钮时,控件将分派 click 事件。

单击辅助(右侧)按钮显示一个下拉菜单,该菜单通过 dataProvider 属性填充。当用户从下拉菜单中选择项目时,控件分派 itemClick 事件。

通常,使用两个 FileSystemHistoryButton 和一个 FileSystemList 或 FileSystemDataGrid 实现“后退”或“前进”控件,使用户在 FileSystemList 或 FileSystemDataGrid 的导航历史记录中后退或前进。要填充 FileSystemHistoryButton 控件的 dataProvider 属性,请使用数据绑定将其 dataProvider 属性设置为 FileSystemList 或 FileSystemDataGrid 控件的 backHistory 属性或 forwardHistory 属性。若要启用或禁用它,请将其 enabled 属性绑定到 FileSystemList 或 FileSystemDataGrid 控件的 canNavigateBackcanNavigateForward 属性。如果使用数据绑定设置这些属性,则当用户在 FileSystemList 或 FileSystemDataGrid 控件中导航时 Flex 会自动更新它们。

按钮自身不导致导航发生。您必须编写响应 clickitemClick 事件的事件侦听器以便发挥按钮的作用。通常,代码调用 FileSystemList 或 FileSystemDataGrid 控件的 navigateBack()navigateForward() 方法导航控件。对于 click 事件,不需要向这些方法传递参数。对于 itemClick 事件,传递 event.index

mx.controls.FileSystemListmx.controls.FileSystemDataGriditemClick 当用户从弹出菜单中选择项目时分派。mx.events.MenuEvent.ITEM_CLICKmx.events.MenuEvent 当用户从弹出菜单中选择项目时分派。 FileSystemHistoryButton 构造函数。 构造函数。 dataProvider FileSystemHistoryButton 控件的数据提供程序。 FileSystemHistoryButton 控件的数据提供程序。这应该是包含目录位置的 File 对象集合 — 通常是 FileSystemList 或 FileSystemDataGrid 控件的 backHistoryforwardHistory 属性。
FileSystemComboBox FileSystemComboBox 控件定义组合框控件,用以从文件系统中的指定目录沿始祖目录链向上导航。The <mx:FileSystemComboBox> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <mx:FileSystemComboBox
    Properties
    directory="null"
    indent="8"
    showIcons="true"
 
    Styles
    computerIcon="null"
    directoryIcon="TreeNodeIcon"
 
    Events
    directoryChange="No default"
  />
  
]]>
mx.controls:ComboBox FileSystemComboBox 控件定义组合框控件,用以从文件系统中的指定目录沿始祖目录链向上导航。此控件通常与 FileSystemList 和 FileSystemTree 控件一起使用,用于更改这些控件显示的当前目录。

与标准的 ComboBox 控件不同,要填充 FileSystemComboBox 控件的 dataProvider 属性,需要设置 directory 属性。然后,此控件会自动将 dataProvider 属性设为 File 对象的 ArrayCollection,其中包含指定目录的所有始祖目录:从 COMPUTER File 开始,到指定目录结束。

当从下拉列表中选择某个条目时,此控件将分派 change 事件。分派此事件后,数据提供程序及因此而改变的下拉列表中都将包含所选目录的始祖目录。

flash.filesystem.Filemx.controls.FileSystemListmx.controls.FileSystemTreedirectoryChange 当此控件显示的选定目录由于某种原因发生更改时分派此事件。mx.events.FileEvent.DIRECTORY_CHANGEmx.events.FileEvent 当此控件显示的选定目录由于某种原因发生更改时分派此事件。 FileSystemComboBox 构造函数。 构造函数。 COMPUTER 一个可用作 directory 属性值的常量,代表名为“Computer”的伪顶级目录。unknown 一个可用作 directory 属性值的常量,代表名为“Computer”的伪顶级目录。这个伪目录中包含根目录(如 Windows 上的 C:\ 和 D:\,或 Macintosh 上的 /)。 directory 一个代表目录的 File 对象,其始祖目录将显示在此控件中。null 一个代表目录的 File 对象,其始祖目录将显示在此控件中。控件将各个始祖目录作为下拉列表中的单独条目来显示。 indent 下拉列表中的各个条目需要缩进的像素数目。8 下拉列表中的各个条目需要缩进的像素数目。 showIcons 一个标志,确定在下拉列表中的目录名称前是否显示标记。true 一个标志,确定在下拉列表中的目录名称前是否显示标记。
FileSystemEnumerationMode FileSystemEnumerationMode 类为 FileSystemList、FileSystemDataGrid 和 FileSystemTree 类的 enumerationMode 属性定义常数值。Object FileSystemEnumerationMode 类为 FileSystemList、FileSystemDataGrid 和 FileSystemTree 类的 enumerationMode 属性定义常量值。 mx.controls.FileSystemList.enumerationModemx.controls.FileSystemDataGrid.enumerationModemx.controls.FileSystemTree.enumerationModeDIRECTORIES_FIRST 指定先显示目录,再显示文件。directoriesFirst 指定先显示目录,再显示文件。 DIRECTORIES_ONLY 指定显示目录,而不显示文件。directoriesOnly 指定显示目录,而不显示文件。 FILES_AND_DIRECTORIES 指定文件和目录混合在一起显示。filesAndDirectories 指定文件和目录混合在一起显示。 FILES_FIRST 指定先显示文件,再显示目录。filesFirst 指定先显示文件,再显示目录。 FILES_ONLY 指定显示文件,而不显示目录。filesOnly 指定显示文件,而不显示目录。