<apiPackage id="mx.controls"><apiName>mx.controls</apiName><apiDetail/><apiClassifier id="mx.controls:FileSystemDataGrid"><apiName>FileSystemDataGrid</apiName><shortdesc>
  The FileSystemDataGrid control lets you display the contents of a
  single file system directory in a data grid format.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion><styles><style format="EmbeddedFile" inherit="no" name="fileIcon" owner="mx.controls:FileSystemDataGrid" playerVersion="AIR1.1" type="Class">
<description>
  Specifies the icon that indicates a file.
  The default icon is located in the Assets.swf file.
  In MXML, you can use the following syntax to set this property:
  <codeph>fileIcon="@Embed(source='fileIcon.jpg');"</codeph>
 
  </description>
<default>TreeNodeIcon
  
  </default>

	<prolog><asCustoms><langversion>3.0
  </langversion><productversion>Flex 3
 </productversion></asCustoms></prolog></style><style format="EmbeddedFile" inherit="no" name="directoryIcon" owner="mx.controls:FileSystemDataGrid" playerVersion="AIR1.1" type="Class">
<description>
  Specifies the icon that indicates a directory.
  The default icon is located in the Assets.swf file.
  In MXML, you can use the following syntax to set this property:
  <codeph>directoryIcon="@Embed(source='directoryIcon.jpg');"</codeph>
 
  </description>
<default>TreeNodeIcon
  
  </default>

	<prolog><asCustoms><langversion>3.0
  </langversion><productversion>Flex 3
 </productversion></asCustoms></prolog></style></styles><DefaultProperty name="dataProvider"/></asMetadata><asCustoms><mxml><![CDATA[
 
  <p>The <code>&lt;mx:FileSystemDataGrid&gt;</code> tag inherits all of the tag
  attributes of its superclass and adds the following tag attributes:</p>
 
  <pre>
  &lt;mx:FileSystemDataGrid
    <strong>Properties</strong>
    dateFormatString=""
    directory="<i>null</i>"
    enumerationMode="directoriesFirst"
    extensions="<i>null</i>"
    filterFunction="<i>null</i>"
    nameCompareFunction="<i>null</i>"
    selectedPath="<i>null</i>"
    selectedPaths="<i>null</i>"
    showExtensions="true"
    showHidden="false"
    showIcons="true"
 
    <strong>Styles</strong>
    directoryIcon="<i>TreeNodeIcon</i>"
    fileIcon="<i>TreeNodeIcon</i>"
 
    <strong>Events</strong>
    directoryChange="<i>No default</i>"
    directoryChanging="<i>No default</i>"
    fileChoose="<i>No default</i>"
  /&gt;
  </pre>
 
  ]]></mxml></asCustoms></prolog><apiClassifierDetail><apiClassifierDef><apiAccess value="public"/><apiStatic/><apiBaseClassifier>mx.controls:DataGrid</apiBaseClassifier></apiClassifierDef><apiDesc>
  The FileSystemDataGrid control lets you display the contents of a
  single file system directory in a data grid format.
 
  <p>The information displayed for each item consists of its name
  (with optional generic icon), type, size, creation date,
  and modification date.
  To do this, FileSystemDataGrid automatically creates five columns
  (DataGridColumn instances) -- <codeph>nameColumn</codeph>, <codeph>typeColumn</codeph>,
  <codeph>sizeColumn</codeph>, <codeph>creationDateColumn</codeph>,
  and <codeph>modificationDateColumn</codeph> -- and sets
  the <codeph>columns</codeph> property to an array of these five instances.
  Each column instance is automatically configured to have an
  appropriate <codeph>labelFunction</codeph>,
  <codeph>sortCompareFunction</codeph>, etc.
  If you don't want all five columns, or if you want to change the
  order, reset the <codeph>columns</codeph> property.
  If you want to customize a column, such as by changing its
  <codeph>labelFunction</codeph>, simply reassign that property
  on the appropriate column object.</p>
 
  <p>To change the displayed data, rather than using the <codeph>dataProvider</codeph> property,
  you set the <codeph>directory</codeph> property.
  The control then automatically populates the <codeph>dataProvider</codeph>
  property by enumerating the contents of that directory.
  You should not set the <codeph>dataProvider</codeph> yourself.</p>
 
  <p>You set the <codeph>directory</codeph> property to a File instance,
  as the following example shows:</p>
  <pre>&lt;mx:FileSystemDataGrid directory="{File.desktopDirectory}"/&gt;</pre>
 
  <p>You can set the <codeph>enumerationMode</codeph> property to specify
  whether to show files, subdirectories, or both.
  There are three ways to show both: directories first,
  files first, or intermixed.</p>
 
  <p>You can set the <codeph>extensions</codeph> property
  to filter the displayed items so that only files
  with the specified extensions appear.
  The <codeph>showHidden</codeph> property determines whether the control
  displays files and subdirectories that the operating system
  normally hides.
  You can specify an additional <codeph>filterFunction</codeph>
  to perform custom filtering, and a <codeph>nameCompareFunction</codeph>
  to perform custom sorting.</p>
 
  <p>Because AIR does not support file system notifications,
  this control does not automatically refresh if a file or
  subdirectory is created, deleted, moved, or renamed;
  in other words, it can display an out-of-date view of the file system.
  However, you can call <codeph>refresh()</codeph> to re-enumerate
  the current <codeph>directory</codeph>.
  You could, for example, choose to do this when you have
  performed a file operation that you know causes the control's
  view to become out-of-date, or when the user deactivates
  and reactivates your application.</p>
 
  <p>You can use the <codeph>showIcons</codeph> property
  to show or hide icons, and the <codeph>showExtensions</codeph>
  property to show or hide file extensions.</p>
 
  <p>The control provides two methods, <codeph>findItem()</codeph>
  and <codeph>findIndex()</codeph>, which you can use to search the
  displayed files and subdirectories to find the one
  with a specified <codeph>nativePath</codeph>.</p>
 
  <p>Two properties, <codeph>selectedPath</codeph>
  and <codeph>selectedPaths</codeph>, work similarly
  to <codeph>selectedItem</codeph> and <codeph>selectedItems</codeph>
  or <codeph>selectedIndex</codeph> and <codeph>selectedIndices</codeph>,
  but let you specify the selection via <codeph>nativePath</codeph>
  strings.
  These are very useful if you need to display a directory
  with particular items preselected, since in this case
  you don't yet have the File items that the control will create
  when it enumerates the directory, and you don't know what
  their indices will be.</p>
 
  <p>The control allows the user to navigate to other directories
  using the mouse or keyboard.
  The user can try to change the directory
  by double-clicking a subdirectory,
  by pressing Enter or Ctrl-Down when a subdirectory is selected,
  by pressing Ctrl-Up when the control isn't displaying
  the COMPUTER directory, by pressing Ctrl-Left when there is
  a "previous" directory to navigate back to, or by pressing Ctrl-Right
  when there is a "next" directory to navigate forward to.
  If the user attempts to change the directory being displayed,
  the control dispatches a cancelable <codeph>directoryChanging</codeph> event.
  If you don't cancel this event by calling
  <codeph>event.preventDefault()</codeph>, the control displays the
  contents of the new directory and the <codeph>directory</codeph>
  property changes.
  Whenever the <codeph>directory</codeph> property changes, for any reason,
  the controls dispatches a <codeph>directoryChange</codeph> event
  to let you know.</p>
 
  <p>In order to support "Up" and "Down" controls, the FileSystemList
  has <codeph>canNavigateUp</codeph> and <codeph>canNavigateDown</codeph>
  properties and <codeph>navigateUp()</codeph> and <codeph>navigateDown()</codeph>
  methods. There is also a <codeph>navigateTo()</codeph> for navigating
  to an arbitrary directory.</p>
 
  <p>The control keeps track of the directories to which the user
  has navigated, in order to make it easy for you to support
  "Back" and "Forward" controls.
  For more information, see the <codeph>backHistory</codeph>,
  <codeph>forwardHistory</codeph>, <codeph>canNavigateBack</codeph>,
  and <codeph>canNavigateForward</codeph> properties, and the
  <codeph>navigateBack()</codeph> and <codeph>navigateForward()</codeph> methods.</p>
 
  <p>Note: The icons displayed for each item are generic file and directory
  icons which you can set using the <codeph>fileIcon</codeph>
  and <codeph>directoryIcon</codeph> styles.
  Flex's list-based controls currently support displaying
  only embedded icons, not icons read at runtime.
  Therefore the actual file system icons displayed in the operating system
  are not displayed in a FileSystemDataGrid, even though they are
  accessible in AIR via the <codeph>icon</codeph> property of a File.</p>
 
  </apiDesc></apiClassifierDetail><related-links><link href="" invalidHref="flash.filesystem.File.xml"><linktext>flash.filesystem.File</linktext></link></related-links><adobeApiEvent id="mx.controls:FileSystemDataGrid_mx.events.FileEvent.FILE_CHOOSE_fileChoose"><apiName>fileChoose</apiName><shortdesc>
  Dispatched when the user chooses a file by double-clicking it
  or by selecting it and pressing Enter.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><adobeApiEventDetail><adobeApiEventDef><apiEventType>mx.events.FileEvent.FILE_CHOOSE</apiEventType><adobeApiEventClassifier>mx.events.FileEvent</adobeApiEventClassifier><apiGeneratedEvent/></adobeApiEventDef><apiDesc>
  Dispatched when the user chooses a file by double-clicking it
  or by selecting it and pressing Enter.
 
  </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="mx.controls:FileSystemDataGrid_mx.events.FileEvent.DIRECTORY_OPENING_directoryChanging"><apiName>directoryChanging</apiName><shortdesc>
  Dispatched when the user tries to change
  the directory displayed by this control.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><adobeApiEventDetail><adobeApiEventDef><apiEventType>mx.events.FileEvent.DIRECTORY_OPENING</apiEventType><adobeApiEventClassifier>mx.events.FileEvent</adobeApiEventClassifier><apiGeneratedEvent/></adobeApiEventDef><apiDesc>
  Dispatched when the user tries to change
  the directory displayed by this control.
 
  <p>The user can try to change the directory
  by double-clicking a subdirectory,
  by pressing Enter or Ctrl-Down when a subdirectory is selected,
  by pressing Ctrl-Up when the control isn't displaying
  the COMPUTER directory,
  by pressing Ctrl-Left when there is a previous directory
  in the history list to navigate back to,
  or by pressing Ctrl-Right when there is a next directory
  in the history list to navigate forward to.</p>
 
  <p>This event is cancelable.
  If you call <codeph>event.preventDefault()</codeph>,
  the directory is not changed.</p>
 
  <p>After the <codeph>directory</codeph> property has changed
  and the <codeph>dataProvider</codeph> contains File instances
  for the items in the new directory,
  the <codeph>directoryChange</codeph> event is dispatched.</p>
 
  </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="mx.controls:FileSystemDataGrid_mx.events.FileEvent.DIRECTORY_CHANGE_directoryChange"><apiName>directoryChange</apiName><shortdesc>
  Dispatched when the selected directory displayed by this control
  changes for any reason.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><adobeApiEventDetail><adobeApiEventDef><apiEventType>mx.events.FileEvent.DIRECTORY_CHANGE</apiEventType><adobeApiEventClassifier>mx.events.FileEvent</adobeApiEventClassifier><apiGeneratedEvent/></adobeApiEventDef><apiDesc>
  Dispatched when the selected directory displayed by this control
  changes for any reason.
 
  </apiDesc></adobeApiEventDetail></adobeApiEvent><apiConstructor id="mx.controls:FileSystemDataGrid:FileSystemDataGrid"><apiName>FileSystemDataGrid</apiName><shortdesc>
      Constructor.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiConstructorDetail><apiConstructorDef><apiAccess value="public"/></apiConstructorDef><apiDesc>
      Constructor.
      
      </apiDesc></apiConstructorDetail></apiConstructor><apiOperation id="mx.controls:FileSystemDataGrid:clear"><apiName>clear</apiName><shortdesc conref="mx.controls.FileSystemList#clear()">
      </shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiOperationDetail><apiOperationDef><apiAccess value="public"/><apiReturn><apiType value="void"/></apiReturn></apiOperationDef><apiDesc conref="mx.controls.FileSystemList#clear()">
      </apiDesc></apiOperationDetail></apiOperation><apiOperation id="mx.controls:FileSystemDataGrid:findIndex"><apiName>findIndex</apiName><shortdesc conref="mx.controls.FileSystemList#findIndex()">
      </shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiOperationDetail><apiOperationDef><apiAccess value="public"/><apiReturn><apiType value="int"/><apiDesc>A zero-based index, or <codeph>-1</codeph>
      if no File was found with the specified path.
     
      </apiDesc></apiReturn><apiParam><apiItemName>nativePath</apiItemName><apiType value="String"/><apiDesc>A String specifying the <codeph>nativePath</codeph>
      of a File item.
     
      </apiDesc></apiParam></apiOperationDef><apiDesc conref="mx.controls.FileSystemList#findIndex()">
      </apiDesc></apiOperationDetail></apiOperation><apiOperation id="mx.controls:FileSystemDataGrid:findItem"><apiName>findItem</apiName><shortdesc conref="mx.controls.FileSystemList#findItem()">
      </shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiOperationDetail><apiOperationDef><apiAccess value="public"/><apiReturn><apiType value="flash.filesystem:File"/><apiDesc>A File instance if one was found with the specified
      <codeph>nativePath</codeph>, or <codeph>null</codeph> if none was found.
      
      </apiDesc></apiReturn><apiParam><apiItemName>nativePath</apiItemName><apiType value="String"/><apiDesc>A String specifying the <codeph>nativePath</codeph>
      of a File item.
     
      </apiDesc></apiParam></apiOperationDef><apiDesc conref="mx.controls.FileSystemList#findItem()">
      </apiDesc></apiOperationDetail></apiOperation><apiOperation id="mx.controls:FileSystemDataGrid:navigateBack"><apiName>navigateBack</apiName><shortdesc>
      Changes this control to display the contents of a previously-visited
      directory in the backHistory array.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiOperationDetail><apiOperationDef><apiAccess value="public"/><apiReturn><apiType value="void"/></apiReturn><apiParam><apiItemName>index</apiItemName><apiType value="int"/><apiData>0</apiData><apiDesc>The index in the <codeph>backHistory</codeph> array
      to navigate to.
      The default is 0, indicating the directory that is "closest back".
     
      </apiDesc></apiParam></apiOperationDef><apiDesc>
      Changes this control to display the contents of a previously-visited
      directory in the <codeph>backHistory</codeph> array.
     
      <p>If the <codeph>backHistory</codeph> array is empty, or if you specify
      an index that is not in that array, then this method does nothing.</p>
     
      <p>When this method returns, the <codeph>directory</codeph> property
      contains the File instance for the new directory.
      The <codeph>dataProvider</codeph> property is temporarily
      <codeph>null</codeph> until the new directory has been enumerated.
      After the enumeration, the <codeph>dataProvider</codeph> property
      contains an ArrayCollection of File instances
      for the new directory's contents.</p>
     
      <p>The history list is left unchanged. However, the current index
      into it changes, which affects the <codeph>backHistory</codeph>
      and <codeph>forwardHistory</codeph> properties.
      They have new values as soon as this method returns.</p>
     
      <p>The following example shows how to use this method
      along with the FileSystemHistoryButton control to create a back button:</p>
     
      <pre>
      &lt;mx:FileSystemDataGrid id="fileSystemViewer" directory="{File.desktopDirectory}"/&gt;
      &lt;mx:FileSystemHistoryButton label="Back"
          enabled="{fileSystemViewer.canNavigateBack}"
          dataProvider="{fileSystemViewer.backHistory}"
          click="fileSystemViewer.navigateBack();"
          itemClick="fileSystemViewer.navigateBack(event.index);"/&gt;</pre>
     
      </apiDesc></apiOperationDetail><related-links><link href="mx.controls.xml#FileSystemDataGrid/backHistory"><linktext>backHistory</linktext></link><link href="mx.controls.xml#FileSystemDataGrid/canNavigateBack"><linktext>canNavigateBack</linktext></link></related-links></apiOperation><apiOperation id="mx.controls:FileSystemDataGrid:navigateDown"><apiName>navigateDown</apiName><shortdesc>
      Changes this control to display the contents
      of the selected subdirectory.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiOperationDetail><apiOperationDef><apiAccess value="public"/><apiReturn><apiType value="void"/></apiReturn></apiOperationDef><apiDesc>
      Changes this control to display the contents
      of the selected subdirectory.
     
      <p>If a subdirectory is not selected, this method does nothing.</p>
     
      <p>When this method returns, the <codeph>directory</codeph> property
      contains the File instance for the new directory.
      The <codeph>dataProvider</codeph> property is temporarily
      <codeph>null</codeph> until the new directory has been enumerated.
      After the enumeration, the <codeph>dataProvider</codeph> property
      contains an ArrayCollection of File instances
      for the new directory's contents.</p>
     
      <p>The following example shows how to use this method
      along with the Button control to create an open button:</p>
     
      <pre>
      &lt;mx:FileSystemDataGrid id="fileSystemViewer" directory="{File.desktopDirectory}"/&gt;
      &lt;mx:Button label="Open"
          enabled="{fileSystemViewer.canNavigateDown}"
          click="fileSystemViewer.navigateDown();"/&gt;</pre>
     
      </apiDesc></apiOperationDetail><related-links><link href="mx.controls.xml#FileSystemDataGrid/canNavigateDown"><linktext>canNavigateDown</linktext></link></related-links></apiOperation><apiOperation id="mx.controls:FileSystemDataGrid:navigateForward"><apiName>navigateForward</apiName><shortdesc>
      Changes this control to display the contents of a previously-visited
      directory in the forwardHistory array.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiOperationDetail><apiOperationDef><apiAccess value="public"/><apiReturn><apiType value="void"/></apiReturn><apiParam><apiItemName>index</apiItemName><apiType value="int"/><apiData>0</apiData><apiDesc>The index in the <codeph>forwardHistory</codeph> array
      to navigate to.
      The default is 0, indicating the directory that is "closest forward".
     
      </apiDesc></apiParam></apiOperationDef><apiDesc>
      Changes this control to display the contents of a previously-visited
      directory in the <codeph>forwardHistory</codeph> array.
     
      <p>If the <codeph>forwardHistory</codeph> array is empty, or if you specify
      an index that is not in that array, then this method does nothing.</p>
     
      <p>When this method returns, the <codeph>directory</codeph> property
      contains the File instance for the new directory.
      The <codeph>dataProvider</codeph> property is temporarily
      <codeph>null</codeph> until the new directory has been enumerated.
      After the enumeration, the <codeph>dataProvider</codeph> property
      contains an ArrayCollection of File instances
      for the new directory's contents.</p>
     
      <p>The history list is left unchanged. However, the current index
      into it changes, which affects the <codeph>backHistory</codeph>
      and <codeph>forwardHistory</codeph> properties.
      They have new values as soon as this method returns.</p>
     
      <p>The following example shows how to use this method
      along with the FileSystemHistoryButton control to create a forward button:</p>
     
      <pre>
      &lt;mx:FileSystemDataGrid id="fileSystemViewer" directory="{File.desktopDirectory}"/&gt;
      &lt;mx:FileSystemHistoryButton label="Forward"
          enabled="{fileSystemViewer.canNavigateForward}"
          dataProvider="{fileSystemViewer.forwardHistory}"
          click="fileSystemViewer.navigateForward();"
          itemClick="fileSystemViewer.navigateForward(event.index);"/&gt;</pre>
     
      </apiDesc></apiOperationDetail><related-links><link href="mx.controls.xml#FileSystemDataGrid/canNavigateForward"><linktext>canNavigateForward</linktext></link><link href="mx.controls.xml#FileSystemDataGrid/forwardHistory"><linktext>forwardHistory</linktext></link></related-links></apiOperation><apiOperation id="mx.controls:FileSystemDataGrid:navigateTo"><apiName>navigateTo</apiName><shortdesc conref="mx.controls.FileSystemList#navigateTo()">
      </shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiOperationDetail><apiOperationDef><apiAccess value="public"/><apiReturn><apiType value="void"/></apiReturn><apiParam><apiItemName>directory</apiItemName><apiType value="flash.filesystem:File"/><apiDesc>A file object representing a file or directory.
      
      </apiDesc></apiParam></apiOperationDef><apiDesc conref="mx.controls.FileSystemList#navigateTo()">
      </apiDesc></apiOperationDetail></apiOperation><apiOperation id="mx.controls:FileSystemDataGrid:navigateUp"><apiName>navigateUp</apiName><shortdesc>
      Changes this control to display the contents of the next directory
      up in the hierarchy.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiOperationDetail><apiOperationDef><apiAccess value="public"/><apiReturn><apiType value="void"/></apiReturn></apiOperationDef><apiDesc>
      Changes this control to display the contents of the next directory
      up in the hierarchy.
     
      <p>If this control is currently displaying root directories
      (such as C: and D: on Microsoft Windows), this method does nothing.</p>
     
      <p>When this method returns, the <codeph>directory</codeph> property
      contains the File instance for the new directory.
      The <codeph>dataProvider</codeph> property is temporarily
      <codeph>null</codeph> until the new directory has been enumerated.
      After the enumeration, the <codeph>dataProvider</codeph> property
      contains an ArrayCollection of File instances
      for the new directory's contents.</p>
     
      <p>The following example shows how to use this property
      along with the Button control to create an up button:</p>
     
      <pre>
      &lt;mx:FileSystemDataGrid id="fileSystemViewer" directory="{File.desktopDirectory}"/&gt;
      &lt;mx:Button label="Up"
          enabled="{fileSystemViewer.canNavigateUp}"
          click="fileSystemViewer.navigateUp();"/&gt;</pre>
     
      </apiDesc></apiOperationDetail><related-links><link href="mx.controls.xml#FileSystemDataGrid/canNavigateUp"><linktext>canNavigateUp</linktext></link></related-links></apiOperation><apiOperation id="mx.controls:FileSystemDataGrid:refresh"><apiName>refresh</apiName><shortdesc conref="mx.controls.FileSystemList#refresh()">
      </shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiOperationDetail><apiOperationDef><apiAccess value="public"/><apiReturn><apiType value="void"/></apiReturn></apiOperationDef><apiDesc conref="mx.controls.FileSystemList#refresh()">
      </apiDesc></apiOperationDetail></apiOperation><apiValue id="mx.controls:FileSystemDataGrid:COMPUTER"><apiName>COMPUTER</apiName><shortdesc conref="mx.controls.FileSystemList#COMPUTER">
      </shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiAccess value="public"/><apiStatic/><apiData>unknown</apiData><apiType value="flash.filesystem:File"/></apiValueDef><apiDesc conref="mx.controls.FileSystemList#COMPUTER">
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FileSystemDataGrid:creationDateColumn"><apiName>creationDateColumn</apiName><shortdesc>
      The DataGridColumn representing the Created column.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiType value="mx.controls.dataGridClasses:DataGridColumn"/></apiValueDef><apiDesc>
      The DataGridColumn representing the Created column.
      The FileSystemDataGrid control automatically creates this column.
     
      <p>You can set properties such as
      <codeph>creationDateColumn.width</codeph> to customize this column.
      To remove this column entirely, or to change the column order,
      set the <codeph>columns</codeph> property to an array such as
      <codeph>[ nameColumn, modificationDateColumn, sizeColumn ]</codeph>.</p>
      
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FileSystemDataGrid:modificationDateColumn"><apiName>modificationDateColumn</apiName><shortdesc>
      The DataGridColumn representing the Modified column.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiType value="mx.controls.dataGridClasses:DataGridColumn"/></apiValueDef><apiDesc>
      The DataGridColumn representing the Modified column.
      The FileSystemDataGrid control automatically creates this column.
     
      <p>You can set properties such as
      <codeph>modificationDateColumn.width</codeph> to customize this column.
      To remove this column entirely, or to change the column order,
      set the <codeph>columns</codeph> property to an array such as
      <codeph>[ nameColumn, modificationDateColumn, sizeColumn ]</codeph>.</p>
      
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FileSystemDataGrid:nameColumn"><apiName>nameColumn</apiName><shortdesc>
      The DataGridColumn representing the Name column.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiType value="mx.controls.dataGridClasses:DataGridColumn"/></apiValueDef><apiDesc>
      The DataGridColumn representing the Name column.
      The FileSystemDataGrid control automatically creates this column.
     
      <p>You can set properties such as <codeph>nameColumn.width</codeph>
      to customize this column.
      To remove this column entirely, or to change the column order,
      set the <codeph>columns</codeph> property to an array such as
      <codeph>[ nameColumn, modificationDateColumn, sizeColumn ]</codeph>.</p>
      
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FileSystemDataGrid:sizeColumn"><apiName>sizeColumn</apiName><shortdesc>
      The DataGridColumn representing the Size column.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiType value="mx.controls.dataGridClasses:DataGridColumn"/></apiValueDef><apiDesc>
      The DataGridColumn representing the Size column.
      The FileSystemDataGrid control automatically creates this column.
     
      <p>You can set properties such as <codeph>sizeColumn.width</codeph>
      to customize this column.
      To remove this column entirely, or to change the column order,
      set the <codeph>columns</codeph> property to an array such as
      <codeph>[ nameColumn, modificationDateColumn, sizeColumn ]</codeph>.</p>
      
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FileSystemDataGrid:typeColumn"><apiName>typeColumn</apiName><shortdesc>
      The DataGridColumn representing the Type column.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiType value="mx.controls.dataGridClasses:DataGridColumn"/></apiValueDef><apiDesc>
      The DataGridColumn representing the Type column.
      The FileSystemDataGrid control automatically creates this column.
     
      <p>You can set properties such as <codeph>typeColumn.width</codeph>
      to customize this column.
      To remove this column entirely, or to change the column order,
      set the <codeph>columns</codeph> property to an array such as
      <codeph>[ nameColumn, modificationDateColumn, sizeColumn ]</codeph>.</p>
      
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FileSystemDataGrid:backHistory:get"><apiName>backHistory</apiName><shortdesc>
      An Array of File objects representing directories
      to which the user can navigate backward.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty isBindable="true"/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="read"/><apiType value="Array"/><apiDefaultValue>[]
     
      </apiDefaultValue></apiValueDef><apiDesc>
      An Array of File objects representing directories
      to which the user can navigate backward.
     
      <p>The first item in this Array is the next directory backward
      in the history list.
      The last item is the directory furthest backward
      in the history list.</p>
     
      <p>This Array may contain a <codeph>null</codeph> item, which represents
      the non-existent directory whose contents are root directories
      such as C:\ and D:\ on Microsoft Windows.</p>
     
      <p>The following example shows how to use this property
      along with the FileSystemHistoryButton control
      to implement a back button:</p>
     
      <pre>
      &lt;mx:FileSystemDataGrid id="fileSystemViewer" directory="{File.desktopDirectory}"/&gt;
      &lt;mx:FileSystemHistoryButton label="Back"
         enabled="{fileSystemViewer.canNavigateBack}"
         dataProvider="{fileSystemViewer.backHistory}"
         click="fileSystemViewer.navigateBack();"
         itemClick="fileSystemViewer.navigateBack(event.index);"/&gt;</pre>
     
      </apiDesc></apiValueDetail><related-links><link href="mx.controls.xml#FileSystemDataGrid/canNavigateBack"><linktext>canNavigateBack</linktext></link><link href="mx.controls.xml#FileSystemDataGrid/navigateBack()"><linktext>navigateBack()</linktext></link><link href="mx.controls.xml#FileSystemHistoryButton"><linktext>mx.controls.FileSystemHistoryButton</linktext></link></related-links></apiValue><apiValue id="mx.controls:FileSystemDataGrid:canNavigateBack:get"><apiName>canNavigateBack</apiName><shortdesc>
      A flag which is true if there is at least one directory
      in the history list to which the user can navigate backward.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty isBindable="true"/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="read"/><apiType value="Boolean"/><apiDefaultValue>false
     
      </apiDefaultValue></apiValueDef><apiDesc>
      A flag which is <codeph>true</codeph> if there is at least one directory
      in the history list to which the user can navigate backward.
     
      <p>The following example shows how to use this property
      along with the FileSystemHistoryButton control
      to implement a back button:</p>
     
      <pre>
      &lt;mx:FileSystemDataGrid id="fileSystemViewer" directory="{File.desktopDirectory}"/&gt;
      &lt;mx:FileSystemHistoryButton label="Back"
          enabled="{fileSystemViewer.canNavigateBack}"
          dataProvider="{fileSystemViewer.backHistory}"
          click="fileSystemViewer.navigateBack();"
          itemClick="fileSystemViewer.navigateBack(event.index);"/&gt;</pre>
     
      </apiDesc></apiValueDetail><related-links><link href="mx.controls.xml#FileSystemDataGrid/backHistory"><linktext>backHistory</linktext></link><link href="mx.controls.xml#FileSystemDataGrid/navigateBack()"><linktext>navigateBack()</linktext></link></related-links></apiValue><apiValue id="mx.controls:FileSystemDataGrid:canNavigateDown:get"><apiName>canNavigateDown</apiName><shortdesc>
      A flag which is true if the user can navigate down
      into a selected directory.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty isBindable="true"/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="read"/><apiType value="Boolean"/><apiDefaultValue>false
     
      </apiDefaultValue></apiValueDef><apiDesc>
      A flag which is <codeph>true</codeph> if the user can navigate down
      into a selected directory.
      This flag is <codeph>false</codeph> when there is no selected item
      or when the selected item is a file rather than a directory.
     
      <p>The following example shows how to use this property
      along with the Button control:</p>
     
      <pre>
      &lt;mx:FileSystemDataGrid id="fileSystemViewer" directory="{File.desktopDirectory}"/&gt;
      &lt;mx:Button label="Open"
          enabled="{fileSystemViewer.canNavigateDown}"
          click="fileSystemViewer.navigateDown();"/&gt;</pre>
     
      </apiDesc></apiValueDetail><related-links><link href="mx.controls.xml#FileSystemDataGrid/navigateDown()"><linktext>navigateDown()</linktext></link></related-links></apiValue><apiValue id="mx.controls:FileSystemDataGrid:canNavigateForward:get"><apiName>canNavigateForward</apiName><shortdesc>
      A flag which is true if there is at least one directory
      in the history list to which the user can navigate forward.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty isBindable="true"/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="read"/><apiType value="Boolean"/><apiDefaultValue>false
     
      </apiDefaultValue></apiValueDef><apiDesc>
      A flag which is <codeph>true</codeph> if there is at least one directory
      in the history list to which the user can navigate forward.
     
      <p>The following example shows how to use this property
      along with the FileSystemHistoryButton control
      to implement a forward button:</p>
     
      <pre>
      &lt;mx:FileSystemDataGrid id="fileSystemViewer" directory="{File.desktopDirectory}"/&gt;
      &lt;mx:FileSystemHistoryButton label="Forward"
          enabled="{fileSystemViewer.canNavigateForward}"
          dataProvider="{fileSystemViewer.forwardHistory}"
          click="fileSystemViewer.navigateForward();"
          itemClick="fileSystemViewer.navigateForward(event.index);"/&gt;</pre>
     
      </apiDesc></apiValueDetail><related-links><link href="mx.controls.xml#FileSystemDataGrid/forwardHistory"><linktext>forwardHistory</linktext></link><link href="mx.controls.xml#FileSystemDataGrid/navigateForward()"><linktext>navigateForward()</linktext></link></related-links></apiValue><apiValue id="mx.controls:FileSystemDataGrid:canNavigateUp:get"><apiName>canNavigateUp</apiName><shortdesc>
      A flag which is true if the user can navigate up
      to a parent directory.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty isBindable="true"/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="read"/><apiType value="Boolean"/><apiDefaultValue>false
     
      </apiDefaultValue></apiValueDef><apiDesc>
      A flag which is <codeph>true</codeph> if the user can navigate up
      to a parent directory.
      This flag is only <codeph>false</codeph> when this control is
      displaying the root directories such as C:\ and D:\ on Microsoft Windows.
      (This is the case in which the <codeph>directory</codeph>
      property is <codeph>COMPUTER</codeph>.)
     
      <p>The following example shows how to use this property
      along with the Button control:</p>
     
      <pre>
      &lt;mx:FileSystemDataGrid id="fileSystemViewer" directory="{File.desktopDirectory}"/&gt;
      &lt;mx:Button label="Up"
          enabled="{fileSystemViewer.canNavigateUp}"
          click="fileSystemViewer.navigateUp();"/&gt;</pre>
     
      </apiDesc></apiValueDetail><related-links><link href="mx.controls.xml#FileSystemDataGrid/navigateUp()"><linktext>navigateUp()</linktext></link></related-links></apiValue><apiValue id="mx.controls:FileSystemDataGrid:dateFormatString:get"><apiName>dateFormatString</apiName><shortdesc>
      A String that determines how dates in the Created and Modified
      columns are formatted.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="String"/></apiValueDef><apiDesc>
      A String that determines how dates in the Created and Modified
      columns are formatted.
      Setting this property sets the <codeph>formatString</codeph>
      of an internal DateFormatter that this control creates.
     
      </apiDesc></apiValueDetail><related-links><link href="" invalidHref="mx.formatters.xml#DateFormatter/formatString"><linktext>mx.formatters.DateFormatter.formatString</linktext></link></related-links></apiValue><apiValue id="mx.controls:FileSystemDataGrid:directory:get"><apiName>directory</apiName><shortdesc conref="mx.controls.FileSystemList#directory">
      </shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty isBindable="true"/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="flash.filesystem:File"/></apiValueDef><apiDesc conref="mx.controls.FileSystemList#directory">
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FileSystemDataGrid:enumerationMode:get"><apiName>enumerationMode</apiName><shortdesc conref="mx.controls.FileSystemList#enumerationMode">
      </shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="String"/><apiDefaultValue>FileSystemEnumerationMode.DIRECTORIES_FIRST
     
      </apiDefaultValue></apiValueDef><apiDesc conref="mx.controls.FileSystemList#enumerationMode">
      </apiDesc></apiValueDetail><related-links><link href="mx.controls.xml#FileSystemEnumerationMode"><linktext>mx.controls.FileSystemEnumerationMode</linktext></link></related-links></apiValue><apiValue id="mx.controls:FileSystemDataGrid:extensions:get"><apiName>extensions</apiName><shortdesc conref="mx.controls.FileSystemList#extensions">
      </shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="Array"/><apiDefaultValue>null
      
      </apiDefaultValue></apiValueDef><apiDesc conref="mx.controls.FileSystemList#extensions">
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FileSystemDataGrid:filterFunction:get"><apiName>filterFunction</apiName><shortdesc conref="mx.controls.FileSystemList#filterFunction">
      </shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="Function"/><apiDefaultValue>null
      
      </apiDefaultValue></apiValueDef><apiDesc conref="mx.controls.FileSystemList#filterFunction">
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FileSystemDataGrid:forwardHistory:get"><apiName>forwardHistory</apiName><shortdesc>
      An Array of File objects representing directories
      to which the user can navigate forward.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty isBindable="true"/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="read"/><apiType value="Array"/><apiDefaultValue>[]
     
     </apiDefaultValue></apiValueDef><apiDesc>
      An Array of File objects representing directories
      to which the user can navigate forward.
     
      <p>The first item in this Array is the next directory forward
      in the history list.
      The last item is the directory furthest forward
      in the history list.</p>
     
      <p>This Array may contain a <codeph>null</codeph> item, which represents
      the non-existent directory whose contents are root directories
      such as C:\ and D:\ on Windows.</p>
     
      <p>The following example shows how to use this property
      along with the FileSystemHistoryButton control to implement a forward button:</p>
     
      <pre>
      &lt;mx:FileSystemDataGrid id="fileSystemViewer" directory="{File.desktopDirectory}"/&gt;
      &lt;mx:FileSystemHistoryButton label="Forward"
          enabled="{fileSystemViewer.canNavigateForward}"
          dataProvider="{fileSystemViewer.forwardHistory}"
          click="fileSystemViewer.navigateForward();"
          itemClick="fileSystemViewer.navigateForward(event.index);"/&gt;</pre>
     
      </apiDesc></apiValueDetail><related-links><link href="mx.controls.xml#FileSystemHistoryButton"><linktext>mx.controls.FileSystemHistoryButton</linktext></link></related-links></apiValue><apiValue id="mx.controls:FileSystemDataGrid:nameCompareFunction:get"><apiName>nameCompareFunction</apiName><shortdesc conref="mx.controls.FileSystemList#nameCompareFunction">
      </shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="Function"/><apiDefaultValue>null
      
      </apiDefaultValue></apiValueDef><apiDesc conref="mx.controls.FileSystemList#nameCompareFunction">
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FileSystemDataGrid:selectedPath:get"><apiName>selectedPath</apiName><shortdesc conref="mx.controls.FileSystemList#selectedPath">
      </shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty isBindable="true"/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="String"/><apiDefaultValue>null
     
      </apiDefaultValue></apiValueDef><apiDesc conref="mx.controls.FileSystemList#selectedPath">
      </apiDesc></apiValueDetail><related-links><link href="" invalidHref="mx.controls.listClasses.xml#ListBase/selectedIndex"><linktext>mx.controls.listClasses.ListBase.selectedIndex</linktext></link><link href="" invalidHref="mx.controls.listClasses.xml#ListBase/selectedItem"><linktext>mx.controls.listClasses.ListBase.selectedItem</linktext></link></related-links></apiValue><apiValue id="mx.controls:FileSystemDataGrid:selectedPaths:get"><apiName>selectedPaths</apiName><shortdesc conref="mx.controls.FileSystemList#selectedPaths">
      </shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty isBindable="true"/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="Array"/><apiDefaultValue>[]
     
      </apiDefaultValue></apiValueDef><apiDesc conref="mx.controls.FileSystemList#selectedPaths">
      </apiDesc></apiValueDetail><related-links><link href="" invalidHref="mx.controls.listClasses.xml#ListBase/selectedIndex"><linktext>mx.controls.listClasses.ListBase.selectedIndex</linktext></link><link href="" invalidHref="mx.controls.listClasses.xml#ListBase/selectedItem"><linktext>mx.controls.listClasses.ListBase.selectedItem</linktext></link></related-links></apiValue><apiValue id="mx.controls:FileSystemDataGrid:showExtensions:get"><apiName>showExtensions</apiName><shortdesc conref="mx.controls.FileSystemList#showExtensions">
      </shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="Boolean"/></apiValueDef><apiDesc conref="mx.controls.FileSystemList#showExtensions">
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FileSystemDataGrid:showHidden:get"><apiName>showHidden</apiName><shortdesc conref="mx.controls.FileSystemList#showHidden">
      </shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="Boolean"/></apiValueDef><apiDesc conref="mx.controls.FileSystemList#showHidden">
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FileSystemDataGrid:showIcons:get"><apiName>showIcons</apiName><shortdesc conref="mx.controls.FileSystemList#showIcons">
      </shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="Boolean"/></apiValueDef><apiDesc conref="mx.controls.FileSystemList#showIcons">
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FileSystemDataGrid:sizeDisplayMode:get"><apiName>sizeDisplayMode</apiName><shortdesc>
      A String specifying whether the Size column displays file sizes
      in bytes or rounded up to the nearest kilobyte,
      where a kilobyte is 1024 bytes.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="String"/></apiValueDef><apiDesc>
      A String specifying whether the Size column displays file sizes
      in bytes or rounded up to the nearest kilobyte,
      where a kilobyte is 1024 bytes.
      The possible values are specified
      by the FileSystemSizeDisplayMode class.
     
      </apiDesc></apiValueDetail><related-links><link href="mx.controls.xml#FileSystemSizeDisplayMode"><linktext>mx.controls.FileSystemSizeDisplayMode</linktext></link></related-links></apiValue></apiClassifier><apiClassifier id="mx.controls:FileSystemTree"><apiName>FileSystemTree</apiName><shortdesc>
  The FileSystemTree control displays the contents of a
  file system directory as a tree.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion><DefaultProperty name="dataProvider"/></asMetadata><asCustoms><mxml><![CDATA[
 
  <p>The <code>&lt;mx:FileSystemTree&gt;</code> tag inherits all of the tag
  attributes of its superclass and adds the following tag attributes:</p>
 
  <pre>
  &lt;mx:FileSystemTree
    <strong>Properties</strong>
    directory="<i>null</i>"
    enumerationMode="directoriesFirst"
    extensions="<i>null</i>"
    filterFunction="<i>null</i>"
    nameCompareFunction="<i>null</i>"
    openPaths="<i>null</i>"
    selectedPath="<i>null</i>"
    selectedPaths="<i>null</i>"
    showExtensions="true"
    showHidden="false"
    showIcons="true"
 
    <strong>Events</strong>
    directoryChange="<i>No default</i>"
    directoryClosing="<i>No default</i>"
    directoryOpening="<i>No default</i>"
    fileChoose="<i>No default</i>"
  /&gt;
  </pre>
 
  ]]></mxml></asCustoms></prolog><apiClassifierDetail><apiClassifierDef><apiAccess value="public"/><apiStatic/><apiBaseClassifier>mx.controls:Tree</apiBaseClassifier></apiClassifierDef><apiDesc>
  The FileSystemTree control displays the contents of a
  file system directory as a tree.
 
  <p>You specify the directory whose content is displayed by setting
  the <codeph>directory</codeph> property to an instance
  of the flash.filesystem.File class.
  (File instances can represent directories as well as files.)
  Whenever this property changes for any reason, the control
  dispatches a <codeph>directoryChange</codeph> event.</p>
 
  <p>You can set the <codeph>enumerationMode</codeph> property to specify
  whether to show this directory's files, its subdirectories, or both.
  There are three ways to show both files and subdirectories within
  each tree node: directories first, files first, or intermixed.</p>
 
  <p>You can set the <codeph>extensions</codeph> property to filter the list
  so that only files with the specified extensions are displayed.
  (Extensions on directories are ignored.)
  You can also specify an additional filtering function of your own
  by setting the <codeph>filterFunction</codeph> property.</p>
 
  <p>You can use the <codeph>showExtensions</codeph> property to show
  or hide file extensions, and the <codeph>showIcons</codeph> property
  to show or hide icons.</p>
 
  <p>You can do custom-sorting within each tree node by setting
  the <codeph>nameCompareFunction</codeph> property to a function
  that compares two file or directory names.</p>
 
  <p>If the user double-clicks a closed directory node,
  or clicks its disclosure icon,
  this control dispatches a <codeph>directoryOpening</codeph> event.
  If the user double-clicks an open directory node,
  or clicks its disclosure icon,
  this control dispatches a <codeph>directoryClosing</codeph> event.
  A handler can cancel either event by calling
  <codeph>event.preventDefault()</codeph> in which case the node doesn't open.</p>
 
  <p>If the user double-clicks a file node,
  this control dispatches a <codeph>select</codeph> event.</p>
 
  </apiDesc></apiClassifierDetail><related-links><link href="" invalidHref="flash.filesystem.File.xml"><linktext>flash.filesystem.File</linktext></link></related-links><adobeApiEvent id="mx.controls:FileSystemTree_mx.events.FileEvent.FILE_CHOOSE_fileChoose"><apiName>fileChoose</apiName><shortdesc>
  Dispatched when the user chooses a file by double-clicking it
  or by selecting it and pressing Enter.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><adobeApiEventDetail><adobeApiEventDef><apiEventType>mx.events.FileEvent.FILE_CHOOSE</apiEventType><adobeApiEventClassifier>mx.events.FileEvent</adobeApiEventClassifier><apiGeneratedEvent/></adobeApiEventDef><apiDesc>
  Dispatched when the user chooses a file by double-clicking it
  or by selecting it and pressing Enter.
 
  </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="mx.controls:FileSystemTree_mx.events.FileEvent.DIRECTORY_OPENING_directoryOpening"><apiName>directoryOpening</apiName><shortdesc>
  Dispatched when the user opens a directory node
  using the mouse or keyboard.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><adobeApiEventDetail><adobeApiEventDef><apiEventType>mx.events.FileEvent.DIRECTORY_OPENING</apiEventType><adobeApiEventClassifier>mx.events.FileEvent</adobeApiEventClassifier><apiGeneratedEvent/></adobeApiEventDef><apiDesc>
  Dispatched when the user opens a directory node
  using the mouse or keyboard.
 
  <p>This is a cancelable event.
  If you call <codeph>event.preventDefault()</codeph>,
  this control continues to display the current directory
  rather than changing to display the subdirectory which was
  double-clicked.</p>
 
  </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="mx.controls:FileSystemTree_mx.events.FileEvent.DIRECTORY_CLOSING_directoryClosing"><apiName>directoryClosing</apiName><shortdesc>
  Dispatched when the user closes an open directory node
  using the mouse of keyboard.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><adobeApiEventDetail><adobeApiEventDef><apiEventType>mx.events.FileEvent.DIRECTORY_CLOSING</apiEventType><adobeApiEventClassifier>mx.events.FileEvent</adobeApiEventClassifier><apiGeneratedEvent/></adobeApiEventDef><apiDesc>
  Dispatched when the user closes an open directory node
  using the mouse of keyboard.
 
  </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="mx.controls:FileSystemTree_mx.events.FileEvent.DIRECTORY_CHANGE_directoryChange"><apiName>directoryChange</apiName><shortdesc>
  Dispatched whenever the directory property changes
  for any reason.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><adobeApiEventDetail><adobeApiEventDef><apiEventType>mx.events.FileEvent.DIRECTORY_CHANGE</apiEventType><adobeApiEventClassifier>mx.events.FileEvent</adobeApiEventClassifier><apiGeneratedEvent/></adobeApiEventDef><apiDesc>
  Dispatched whenever the <codeph>directory</codeph> property changes
  for any reason.
 
  </apiDesc></adobeApiEventDetail></adobeApiEvent><apiConstructor id="mx.controls:FileSystemTree:FileSystemTree"><apiName>FileSystemTree</apiName><shortdesc>
      Constructor.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiConstructorDetail><apiConstructorDef><apiAccess value="public"/></apiConstructorDef><apiDesc>
      Constructor.
      
      </apiDesc></apiConstructorDetail></apiConstructor><apiOperation id="mx.controls:FileSystemTree:clear"><apiName>clear</apiName><shortdesc>
      Clears the list.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiOperationDetail><apiOperationDef><apiAccess value="public"/><apiReturn><apiType value="void"/></apiReturn></apiOperationDef><apiDesc>
      Clears the list.
     
      <p>This method sets the <codeph>dataProvider</codeph> to <codeph>null</codeph>
      but leaves the <codeph>directory</codeph> property unchanged.
      You can call <codeph>refresh</codeph> to populate the list again.</p>
      
      </apiDesc></apiOperationDetail></apiOperation><apiOperation id="mx.controls:FileSystemTree:closeSubdirectory"><apiName>closeSubdirectory</apiName><shortdesc>
      Closes a subdirectory specified by a native file system path.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiOperationDetail><apiOperationDef><apiAccess value="public"/><apiReturn><apiType value="void"/></apiReturn><apiParam><apiItemName>nativePath</apiItemName><apiType value="String"/><apiDesc>A String specifying the <codeph>nativePath</codeph>
      of a File item.
      
      </apiDesc></apiParam></apiOperationDef><apiDesc>
      Closes a subdirectory specified by a native file system path.
     
      <p>If the <codeph>nativePath</codeph> doesn't specify
      a directory being displayed within this control,
      then this method does nothing.</p>
     
      </apiDesc></apiOperationDetail></apiOperation><apiOperation id="mx.controls:FileSystemTree:findIndex"><apiName>findIndex</apiName><shortdesc conref="mx.controls.FileSystemList#findIndex()">
      </shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiOperationDetail><apiOperationDef><apiAccess value="public"/><apiReturn><apiType value="int"/><apiDesc>A zero-based index, or <codeph>-1</codeph>
      if no File was found with the specified path.
     
      </apiDesc></apiReturn><apiParam><apiItemName>nativePath</apiItemName><apiType value="String"/><apiDesc>A String specifying the <codeph>nativePath</codeph>
      of a File item.
     
      </apiDesc></apiParam></apiOperationDef><apiDesc conref="mx.controls.FileSystemList#findIndex()">
      </apiDesc></apiOperationDetail></apiOperation><apiOperation id="mx.controls:FileSystemTree:findItem"><apiName>findItem</apiName><shortdesc conref="mx.controls.FileSystemList#findItem()">
      </shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiOperationDetail><apiOperationDef><apiAccess value="public"/><apiReturn><apiType value="flash.filesystem:File"/><apiDesc>A File instance if one was found with the specified
      <codeph>nativePath</codeph>, or <codeph>null</codeph> if none was found.
      
      </apiDesc></apiReturn><apiParam><apiItemName>nativePath</apiItemName><apiType value="String"/><apiDesc>A String specifying the <codeph>nativePath</codeph>
      of a File item.
     
      </apiDesc></apiParam></apiOperationDef><apiDesc conref="mx.controls.FileSystemList#findItem()">
      </apiDesc></apiOperationDetail></apiOperation><apiOperation id="mx.controls:FileSystemTree:openSubdirectory"><apiName>openSubdirectory</apiName><shortdesc>
      Opens a subdirectory specified by a native file system path.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiOperationDetail><apiOperationDef><apiAccess value="public"/><apiReturn><apiType value="void"/></apiReturn><apiParam><apiItemName>nativePath</apiItemName><apiType value="String"/><apiDesc>A String specifying the <codeph>nativePath</codeph>
      of a File item.
      
      </apiDesc></apiParam></apiOperationDef><apiDesc>
      Opens a subdirectory specified by a native file system path.
     
      <p>This method automatically opens all intervening directories
      required to reach the specified directory.</p>
     
      <p>If the <codeph>nativePath</codeph> doesn't specify
      an existing file system directory, or if that
      directory isn't within the directory that this control
      is displaying, then this method does nothing.</p>
     
      </apiDesc></apiOperationDetail></apiOperation><apiOperation id="mx.controls:FileSystemTree:refresh"><apiName>refresh</apiName><shortdesc>
      Re-enumerates the current directory being displayed by this control.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiOperationDetail><apiOperationDef><apiAccess value="public"/><apiReturn><apiType value="void"/></apiReturn></apiOperationDef><apiDesc>
      Re-enumerates the current directory being displayed by this control.
     
      <p>When this method returns, the <codeph>directory</codeph> property
      contains the File instance for the same directory as before.
      The <codeph>dataProvider</codeph> property is temporarily
      <codeph>null</codeph> until the directory is re-enumerated.
      After the enumeration, the <codeph>dataProvider</codeph> property
      contains an ArrayCollection of File instances
      for the directory's contents.</p>
      
      </apiDesc></apiOperationDetail></apiOperation><apiValue id="mx.controls:FileSystemTree:COMPUTER"><apiName>COMPUTER</apiName><shortdesc conref="mx.controls.FileSystemList#COMPUTER">
      </shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiAccess value="public"/><apiStatic/><apiData>unknown</apiData><apiType value="flash.filesystem:File"/></apiValueDef><apiDesc conref="mx.controls.FileSystemList#COMPUTER">
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FileSystemTree:directory:get"><apiName>directory</apiName><shortdesc>
      The directory whose contents this control displays.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty isBindable="true"/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="flash.filesystem:File"/><apiDefaultValue>COMPUTER
      
      </apiDefaultValue></apiValueDef><apiDesc>
      The directory whose contents this control displays.
     
      <p>If you set this property to a File object representing
      an existing directory, the <codeph>dataProvider</codeph>
      immediately becomes <codeph>null</codeph>.
      Later, when this control is revalidated by the LayoutManager,
      it performs a synchronous enumeration of that directory's
      contents and populates the <codeph>dataProvider</codeph> property
      with an ArrayCollection of the resulting File objects
      for the directory's files and subdirectories.</p>
     
      <p>Setting this to a File which does not represent
      an existing directory is an error.
      Setting this to <codeph>COMPUTER</codeph> synchronously displays
      the root directories, such as C: and D: on Windows.</p>
     
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FileSystemTree:enumerationMode:get"><apiName>enumerationMode</apiName><shortdesc conref="mx.controls.FileSystemList#enumerationMode">
      </shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="String"/><apiDefaultValue>FileSystemEnumerationMode.DIRECTORIES_FIRST
     
      </apiDefaultValue></apiValueDef><apiDesc conref="mx.controls.FileSystemList#enumerationMode">
      </apiDesc></apiValueDetail><related-links><link href="mx.controls.xml#FileSystemEnumerationMode"><linktext>mx.controls.FileSystemEnumerationMode</linktext></link></related-links></apiValue><apiValue id="mx.controls:FileSystemTree:extensions:get"><apiName>extensions</apiName><shortdesc conref="mx.controls.FileSystemList#extensions">
      </shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="Array"/><apiDefaultValue>null
      
      </apiDefaultValue></apiValueDef><apiDesc conref="mx.controls.FileSystemList#extensions">
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FileSystemTree:filterFunction:get"><apiName>filterFunction</apiName><shortdesc conref="mx.controls.FileSystemList#filterFunction">
      </shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="Function"/><apiDefaultValue>null
      
      </apiDefaultValue></apiValueDef><apiDesc conref="mx.controls.FileSystemList#filterFunction">
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FileSystemTree:nameCompareFunction:get"><apiName>nameCompareFunction</apiName><shortdesc conref="mx.controls.FileSystemList#nameCompareFunction">
      </shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="Function"/><apiDefaultValue>null
      
      </apiDefaultValue></apiValueDef><apiDesc conref="mx.controls.FileSystemList#nameCompareFunction">
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FileSystemTree:openPaths:get"><apiName>openPaths</apiName><shortdesc>
      An Array of nativePath Strings for the File items
      representing the open subdirectories.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="Array"/><apiDefaultValue>[]
      
      </apiDefaultValue></apiValueDef><apiDesc>
      An Array of <codeph>nativePath</codeph> Strings for the File items
      representing the open subdirectories.
      This Array is empty if no subdirectories are open.
     
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FileSystemTree:selectedPath:get"><apiName>selectedPath</apiName><shortdesc conref="mx.controls.FileSystemList#selectedPath">
      </shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty isBindable="true"/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="String"/><apiDefaultValue>null
     
      </apiDefaultValue></apiValueDef><apiDesc conref="mx.controls.FileSystemList#selectedPath">
      </apiDesc></apiValueDetail><related-links><link href="" invalidHref="mx.controls.listClasses.xml#ListBase/selectedIndex"><linktext>mx.controls.listClasses.ListBase.selectedIndex</linktext></link><link href="" invalidHref="mx.controls.listClasses.xml#ListBase/selectedItem"><linktext>mx.controls.listClasses.ListBase.selectedItem</linktext></link></related-links></apiValue><apiValue id="mx.controls:FileSystemTree:selectedPaths:get"><apiName>selectedPaths</apiName><shortdesc conref="mx.controls.FileSystemList#selectedPaths">
      </shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty isBindable="true"/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="Array"/><apiDefaultValue>[]
     
      </apiDefaultValue></apiValueDef><apiDesc conref="mx.controls.FileSystemList#selectedPaths">
      </apiDesc></apiValueDetail><related-links><link href="" invalidHref="mx.controls.listClasses.xml#ListBase/selectedIndex"><linktext>mx.controls.listClasses.ListBase.selectedIndex</linktext></link><link href="" invalidHref="mx.controls.listClasses.xml#ListBase/selectedItem"><linktext>mx.controls.listClasses.ListBase.selectedItem</linktext></link></related-links></apiValue><apiValue id="mx.controls:FileSystemTree:showExtensions:get"><apiName>showExtensions</apiName><shortdesc conref="mx.controls.FileSystemList#showExtensions">
      </shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="Boolean"/><apiDefaultValue>true
      
      </apiDefaultValue></apiValueDef><apiDesc conref="mx.controls.FileSystemList#showExtensions">
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FileSystemTree:showHidden:get"><apiName>showHidden</apiName><shortdesc conref="mx.controls.FileSystemList#showHidden">
      </shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="Boolean"/><apiDefaultValue>false
      
      </apiDefaultValue></apiValueDef><apiDesc conref="mx.controls.FileSystemList#showHidden">
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FileSystemTree:showIcons:get"><apiName>showIcons</apiName><shortdesc conref="mx.controls.FileSystemList#showIcons">
      </shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="Boolean"/><apiDefaultValue>true
      
      </apiDefaultValue></apiValueDef><apiDesc conref="mx.controls.FileSystemList#showIcons">
      </apiDesc></apiValueDetail></apiValue></apiClassifier><apiClassifier id="mx.controls:FileSystemList"><apiName>FileSystemList</apiName><shortdesc>
  The FileSystemList control lets you display the contents of a
  single file system directory, in a list format.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion><styles><style format="EmbeddedFile" inherit="no" name="fileIcon" owner="mx.controls:FileSystemList" playerVersion="AIR1.1" type="Class">
<description>
  Specifies the icon that indicates a file.
  The default icon is located in the Assets.swf file.
  In MXML, you can use the following syntax to set this property:
  <codeph>fileIcon="@Embed(source='fileIcon.jpg');"</codeph>
 
  </description>
<default>TreeNodeIcon
  
  </default>

	<prolog><asCustoms><langversion>3.0
  </langversion><productversion>Flex 3
 </productversion></asCustoms></prolog></style><style format="EmbeddedFile" inherit="no" name="directoryIcon" owner="mx.controls:FileSystemList" playerVersion="AIR1.1" type="Class">
<description>
  Specifies the icon that indicates a directory.
  The default icon is located in the Assets.swf file.
  In MXML, you can use the following syntax to set this property:
  <codeph>directoryIcon="@Embed(source='directoryIcon.jpg');"</codeph>
 
  </description>
<default>TreeNodeIcon
  
  </default>

	<prolog><asCustoms><langversion>3.0
  </langversion><productversion>Flex 3
 </productversion></asCustoms></prolog></style></styles><DefaultProperty name="dataProvider"/></asMetadata><asCustoms><mxml><![CDATA[
 
  <p>The <code>&lt;mx:FileSystemList&gt;</code> tag inherits all of the tag
  attributes of its superclass and adds the following tag attributes:</p>
 
  <pre>
  &lt;mx:FileSystemList
    <strong>Properties</strong>
    directory="<i>null</i>"
    enumerationMode="directoriesFirst"
    extensions="<i>null</i>"
    filterFunction="<i>null</i>"
    nameCompareFunction="<i>null</i>"
    selectedPath="<i>null</i>"
    selectedPaths="<i>null</i>"
    showExtensions="true"
    showHidden="false"
    showIcons="true"
 
    <strong>Styles</strong>
    directoryIcon="<i>TreeNodeIcon</i>"
    fileIcon="<i>TreeNodeIcon</i>"
 
    <strong>Events</strong>
    directoryChange="<i>No default</i>"
    directoryChanging="<i>No default</i>"
    fileChoose="<i>No default</i>"
  /&gt;
  </pre>
 
  ]]></mxml></asCustoms></prolog><apiClassifierDetail><apiClassifierDef><apiAccess value="public"/><apiStatic/><apiBaseClassifier>mx.controls:List</apiBaseClassifier></apiClassifierDef><apiDesc>
  The FileSystemList control lets you display the contents of a
  single file system directory, in a list format.
 
  <p>To change the displayed data, rather than using the <codeph>dataProvider</codeph> property,
  you set the <codeph>directory</codeph> property.
  The control then automatically populates the <codeph>dataProvider</codeph>
  property by enumerating the contents of that directory.
  You should not set the <codeph>dataProvider</codeph> yourself.</p>
 
  <p>You set the <codeph>directory</codeph> property to a File instance,
  as the following example shows: </p>
  <pre>
    &lt;mx:FileSystemList directory="{File.desktopDirectory}"/&gt;</pre>
 
  <p>You can set the <codeph>enumerationMode</codeph> property to specify
  whether to show files, subdirectories, or both.
  There are three ways to show both: directories first,
  files first, or intermixed.</p>
 
  <p>You can set the <codeph>extensions</codeph> property
  to filter the displayed items so that only files
  with the specified extensions appear.
  The <codeph>showHidden</codeph> determines whether the control
  displays files and subdirectories that the operating system
  normally hides.
  You can specify an additional <codeph>filterFunction</codeph>
  to perform custom filtering, and a <codeph>nameCompareFunction</codeph>
  to perform custom sorting.</p>
 
  <p>Because AIR does not support file system notifications,
  this control does not automatically refresh if a file or
  subdirectory is created, deleted, moved, or renamed;
  in other words, it can display an out-of-date view of the file system.
  However, you can call <codeph>refresh()</codeph> to re-enumerate
  the current <codeph>directory</codeph>.
  You could, for example, choose to do this when you have
  performed a file operation that you know causes the control's
  view to become out-of-date, or when the user deactivates
  and reactivates your application.</p>
 
  <p>You can use the <codeph>showIcons</codeph> property
  to show or hide icons, and the <codeph>showExtensions</codeph>
  property to show or hide file extensions.</p>
 
  <p>The control provides two methods, <codeph>findItem()</codeph>
  and <codeph>findIndex()</codeph>, which you can use to search the
  displayed files and subdirectories to find the one
  with a specified <codeph>nativePath</codeph>.</p>
 
  <p>Two properties, <codeph>selectedPath</codeph>
  and <codeph>selectedPaths</codeph>, work similarly
  to <codeph>selectedItem</codeph> and <codeph>selectedItems</codeph>
  or <codeph>selectedIndex</codeph> and <codeph>selectedIndices</codeph>,
  but let you specify the selection via <codeph>nativePath</codeph>
  strings.
  These are very useful if you need to display a directory
  with particular items preselected, since in this case
  you don't yet have the File items that the control will create
  when it enumerates the directory, and you don't know what
  their indices will be.</p>
 
  <p>The control allows the user to navigate to other directories
  using the mouse or keyboard.
  The user can try to change the directory
  by double-clicking a subdirectory,
  by pressing Enter or Ctrl-Down when a subdirectory is selected,
  by pressing Ctrl-Up when the control isn't displaying
  the COMPUTER directory, by pressing Ctrl-Left when there is
  a "previous" directory to navigate back to, or by pressing Ctrl-Right
  when there is a "next" directory to navigate forward to.
  If the user attempts to change the directory being displayed,
  the control dispatches a cancelable <codeph>directoryChanging</codeph> event.
  If you don't cancel this event by calling
  <codeph>event.preventDefault()</codeph>, the control displays the
  contents of the new directory and the <codeph>directory</codeph>
  property changes.
  Whenever the <codeph>directory</codeph> property changes, for any reason,
  the controls dispatches a <codeph>directoryChange</codeph> event
  to let you know.</p>
 
  <p>In order to support "Up" and "Down" controls, the FileSystemList
  has <codeph>canNavigateUp</codeph> and <codeph>canNavigateDown</codeph>
  properties and <codeph>navigateUp()</codeph> and <codeph>navigateDown()</codeph>
  methods. There is also a <codeph>navigateTo()</codeph> for navigating
  to an arbitrary directory.</p>
 
  <p>The control keeps track of the directories to which the user
  has navigated, in order to make it easy for you to support
  "Back" and "Forward" controls.
  For more information, see the <codeph>backHistory</codeph>,
  <codeph>forwardHistory</codeph>, <codeph>canNavigateBack</codeph>,
  and <codeph>canNavigateForward</codeph> properties, and the
  <codeph>navigateBack()</codeph> and <codeph>navigateForward()</codeph> methods.</p>
 
  <p>Note: The icons displayed for each item are generic file and directory
  icons which you can set using the <codeph>fileIcon</codeph>
  and <codeph>directoryIcon</codeph> styles.
  Flex's list-based controls currently support displaying
  only embedded icons, not icons read at runtime.
  Therefore the actual file system icons displayed in the operating system
  are not displayed in a FileSystemList, even though they are
  accessible in AIR via the <codeph>icon</codeph> property of a File.</p>
 
  </apiDesc></apiClassifierDetail><related-links><link href="" invalidHref="flash.filesystem.File.xml"><linktext>flash.filesystem.File</linktext></link></related-links><adobeApiEvent id="mx.controls:FileSystemList_mx.events.FileEvent.FILE_CHOOSE_fileChoose"><apiName>fileChoose</apiName><shortdesc>
  Dispatched when the user chooses a file by double-clicking it
  or by selecting it and pressing Enter.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><adobeApiEventDetail><adobeApiEventDef><apiEventType>mx.events.FileEvent.FILE_CHOOSE</apiEventType><adobeApiEventClassifier>mx.events.FileEvent</adobeApiEventClassifier><apiGeneratedEvent/></adobeApiEventDef><apiDesc>
  Dispatched when the user chooses a file by double-clicking it
  or by selecting it and pressing Enter.
 
  </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="mx.controls:FileSystemList_mx.events.FileEvent.DIRECTORY_OPENING_directoryChanging"><apiName>directoryChanging</apiName><shortdesc>
  Dispatched when the user tries to change
  the directory displayed by this control.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><adobeApiEventDetail><adobeApiEventDef><apiEventType>mx.events.FileEvent.DIRECTORY_OPENING</apiEventType><adobeApiEventClassifier>mx.events.FileEvent</adobeApiEventClassifier><apiGeneratedEvent/></adobeApiEventDef><apiDesc>
  Dispatched when the user tries to change
  the directory displayed by this control.
 
  <p>The user can try to change the directory
  by double-clicking a subdirectory,
  by pressing Enter or Ctrl-Down when a subdirectory is selected,
  by pressing Ctrl-Up when the control isn't displaying
  the COMPUTER directory,
  by pressing Ctrl-Left when there is a previous directory
  in the history list to navigate back to,
  or by pressing Ctrl-Right when there is a next directory
  in the history list to navigate forward to.</p>
 
  <p>This event is cancelable.
  If you call <codeph>event.preventDefault()</codeph>,
  the directory is not changed.</p>
 
  <p>After the <codeph>directory</codeph> property has changed
  and the <codeph>dataProvider</codeph> contains File instances
  for the items in the new directory,
  the <codeph>directoryChange</codeph> event is dispatched.</p>
 
  </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="mx.controls:FileSystemList_mx.events.FileEvent.DIRECTORY_CHANGE_directoryChange"><apiName>directoryChange</apiName><shortdesc>
  Dispatched when the directory displayed by this control
  has changed for any reason.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><adobeApiEventDetail><adobeApiEventDef><apiEventType>mx.events.FileEvent.DIRECTORY_CHANGE</apiEventType><adobeApiEventClassifier>mx.events.FileEvent</adobeApiEventClassifier><apiGeneratedEvent/></adobeApiEventDef><apiDesc>
  Dispatched when the directory displayed by this control
  has changed for any reason.
 
  </apiDesc></adobeApiEventDetail></adobeApiEvent><apiConstructor id="mx.controls:FileSystemList:FileSystemList"><apiName>FileSystemList</apiName><shortdesc>
      Constructor.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiConstructorDetail><apiConstructorDef><apiAccess value="public"/></apiConstructorDef><apiDesc>
      Constructor.
      
      </apiDesc></apiConstructorDetail></apiConstructor><apiOperation id="mx.controls:FileSystemList:clear"><apiName>clear</apiName><shortdesc>
      Clears this control so that it displays no items.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiOperationDetail><apiOperationDef><apiAccess value="public"/><apiReturn><apiType value="void"/></apiReturn></apiOperationDef><apiDesc>
      Clears this control so that it displays no items.
     
      <p>This method sets the <codeph>dataProvider</codeph> to <codeph>null</codeph>
      but leaves the <codeph>directory</codeph> property unchanged.
      You can call <codeph>refresh</codeph> to populate this control again.</p>
      
      </apiDesc></apiOperationDetail></apiOperation><apiOperation id="mx.controls:FileSystemList:findIndex"><apiName>findIndex</apiName><shortdesc>
      Returns the index of the File item with the specified
      native file system path.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiOperationDetail><apiOperationDef><apiAccess value="public"/><apiReturn><apiDesc>A zero-based index, or <codeph>-1</codeph>
      if no File was found with the specified path.
     
      </apiDesc><apiType value="int"/></apiReturn><apiParam><apiItemName>nativePath</apiItemName><apiType value="String"/><apiDesc>A String specifying the <codeph>nativePath</codeph>
      of a File item.
     
      </apiDesc></apiParam></apiOperationDef><apiDesc>
      Returns the index of the File item with the specified
      native file system path.
     
      <p>Items which are present in the control's collection
      but not displayed because of filtering are not searched.</p>
     
      </apiDesc></apiOperationDetail><related-links><link href="" invalidHref="flash.filesystem.xml#File/nativePath"><linktext>flash.filesystem.File.nativePath</linktext></link></related-links></apiOperation><apiOperation id="mx.controls:FileSystemList:findItem"><apiName>findItem</apiName><shortdesc>
      Searches the File instances currently displayed in this control
      and returns the one with the specified nativePathproperty.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiOperationDetail><apiOperationDef><apiAccess value="public"/><apiReturn><apiDesc>A File instance if one was found with the specified
      <codeph>nativePath</codeph>, or <codeph>null</codeph> if none was found.
      
      </apiDesc><apiType value="flash.filesystem:File"/></apiReturn><apiParam><apiItemName>nativePath</apiItemName><apiType value="String"/><apiDesc>A String specifying the <codeph>nativePath</codeph>
      of a File item.
     
      </apiDesc></apiParam></apiOperationDef><apiDesc>
      Searches the File instances currently displayed in this control
      and returns the one with the specified <codeph>nativePath</codeph>property.
     
      <p>File instances which are present in the control's collection
      but not displayed because of filtering are not searched.</p>
     
      </apiDesc></apiOperationDetail></apiOperation><apiOperation id="mx.controls:FileSystemList:navigateBack"><apiName>navigateBack</apiName><shortdesc>
      Changes this control to display the contents of a previously-visited
      directory in the backHistory array.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiOperationDetail><apiOperationDef><apiAccess value="public"/><apiReturn><apiType value="void"/></apiReturn><apiParam><apiItemName>index</apiItemName><apiType value="int"/><apiData>0</apiData><apiDesc>The index in the <codeph>backHistory</codeph> array
      to navigate to.
      The default is 0, indicating the directory that is "closest back".
     
      </apiDesc></apiParam></apiOperationDef><apiDesc>
      Changes this control to display the contents of a previously-visited
      directory in the <codeph>backHistory</codeph> array.
     
      <p>If the <codeph>backHistory</codeph> array is empty, or if you specify
      an index that is not in that array, then this method does nothing.</p>
     
      <p>When this method returns, the <codeph>directory</codeph> property
      contains the File instance for the new directory.
      The <codeph>dataProvider</codeph> property is temporarily
      <codeph>null</codeph> until the new directory has been enumerated.
      After the enumeration, the <codeph>dataProvider</codeph> property
      contains an ArrayCollection of File instances
      for the new directory's contents.</p>
     
      <p>The history list is left unchanged. However, the current index
      into it changes, which affects the <codeph>backHistory</codeph>
      and <codeph>forwardHistory</codeph> properties.
      They have new values as soon as this method returns.</p>
     
      <p>The following example shows how to use this method
      along with the FileSystemHistoryButton control to create a back button:</p>
     
      <pre>
      &lt;mx:FileSystemList id="fileSystemViewer" directory="{File.desktopDirectory}"/&gt;
      &lt;mx:FileSystemHistoryButton label="Back"
          enabled="{fileSystemViewer.canNavigateBack}"
          dataProvider="{fileSystemViewer.backHistory}"
          click="fileSystemViewer.navigateBack();"
          itemClick="fileSystemViewer.navigateBack(event.index);"/&gt;</pre>
     
      </apiDesc></apiOperationDetail><related-links><link href="mx.controls.xml#FileSystemList/backHistory"><linktext>backHistory</linktext></link><link href="mx.controls.xml#FileSystemList/canNavigateBack"><linktext>canNavigateBack</linktext></link></related-links></apiOperation><apiOperation id="mx.controls:FileSystemList:navigateDown"><apiName>navigateDown</apiName><shortdesc>
      Changes this control to display the contents
      of the selected subdirectory.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiOperationDetail><apiOperationDef><apiAccess value="public"/><apiReturn><apiType value="void"/></apiReturn></apiOperationDef><apiDesc>
      Changes this control to display the contents
      of the selected subdirectory.
     
      <p>If a subdirectory is not selected, this method does nothing.</p>
     
      <p>When this method returns, the <codeph>directory</codeph> property
      contains the File instance for the new directory.
      The <codeph>dataProvider</codeph> property is temporarily
      <codeph>null</codeph> until the new directory has been enumerated.
      After the enumeration, the <codeph>dataProvider</codeph> property
      contains an ArrayCollection of File instances
      for the new directory's contents.</p>
     
      <p>The following example shows how to use this method
      along with the Button control to create an open button:</p>
     
      <pre>
      &lt;mx:FileSystemList id="fileSystemViewer" directory="{File.desktopDirectory}"/&gt;
      &lt;mx:Button label="Open"
          enabled="{fileSystemViewer.canNavigateDown}"
          click="fileSystemViewer.navigateDown();"/&gt;</pre>
     
      </apiDesc></apiOperationDetail><related-links><link href="mx.controls.xml#FileSystemList/canNavigateDown"><linktext>canNavigateDown</linktext></link></related-links></apiOperation><apiOperation id="mx.controls:FileSystemList:navigateForward"><apiName>navigateForward</apiName><shortdesc>
      Changes this control to display the contents of a previously-visited
      directory in the forwardHistory array.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiOperationDetail><apiOperationDef><apiAccess value="public"/><apiReturn><apiType value="void"/></apiReturn><apiParam><apiItemName>index</apiItemName><apiType value="int"/><apiData>0</apiData><apiDesc>The index in the <codeph>forwardHistory</codeph> array
      to navigate to.
      The default is 0, indicating the directory that is "closest forward".
     
      </apiDesc></apiParam></apiOperationDef><apiDesc>
      Changes this control to display the contents of a previously-visited
      directory in the <codeph>forwardHistory</codeph> array.
     
      <p>If the <codeph>forwardHistory</codeph> array is empty, or if you specify
      an index that is not in that array, then this method does nothing.</p>
     
      <p>When this method returns, the <codeph>directory</codeph> property
      contains the File instance for the new directory.
      The <codeph>dataProvider</codeph> property is temporarily
      <codeph>null</codeph> until the new directory has been enumerated.
      After the enumeration, the <codeph>dataProvider</codeph> property
      contains an ArrayCollection of File instances
      for the new directory's contents.</p>
     
      <p>The history list is left unchanged. However, the current index
      into it changes, which affects the <codeph>backHistory</codeph>
      and <codeph>forwardHistory</codeph> properties.
      They have new values as soon as this method returns.</p>
     
      <p>The following example shows how to use this method
      along with the FileSystemHistoryButton control to create a forward button:</p>
     
      <pre>
      &lt;mx:FileSystemList id="fileSystemViewer" directory="{File.desktopDirectory}"/&gt;
      &lt;mx:FileSystemHistoryButton label="Forward"
          enabled="{fileSystemViewer.canNavigateForward}"
          dataProvider="{fileSystemViewer.forwardHistory}"
          click="fileSystemViewer.navigateForward();"
          itemClick="fileSystemViewer.navigateForward(event.index);"/&gt;</pre>
     
      </apiDesc></apiOperationDetail><related-links><link href="mx.controls.xml#FileSystemList/canNavigateForward"><linktext>canNavigateForward</linktext></link><link href="mx.controls.xml#FileSystemList/forwardHistory"><linktext>forwardHistory</linktext></link></related-links></apiOperation><apiOperation id="mx.controls:FileSystemList:navigateTo"><apiName>navigateTo</apiName><shortdesc>
      Changes this control to display the contents of the specified
      directory.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiOperationDetail><apiOperationDef><apiAccess value="public"/><apiReturn><apiType value="void"/></apiReturn><apiParam><apiItemName>directory</apiItemName><apiType value="flash.filesystem:File"/><apiDesc>A file object representing a file or directory.
      
      </apiDesc></apiParam></apiOperationDef><apiDesc>
      Changes this control to display the contents of the specified
      directory.
     
      </apiDesc></apiOperationDetail></apiOperation><apiOperation id="mx.controls:FileSystemList:navigateUp"><apiName>navigateUp</apiName><shortdesc>
      Changes this control to display the contents of the next directory
      up in the hierarchy.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiOperationDetail><apiOperationDef><apiAccess value="public"/><apiReturn><apiType value="void"/></apiReturn></apiOperationDef><apiDesc>
      Changes this control to display the contents of the next directory
      up in the hierarchy.
     
      <p>If this control is currently displaying root directories
      (such as C: and D: on Microsoft Windows), this method does nothing.</p>
     
      <p>When this method returns, the <codeph>directory</codeph> property
      contains the File instance for the new directory.
      The <codeph>dataProvider</codeph> property is temporarily
      <codeph>null</codeph> until the new directory has been enumerated.
      After the enumeration, the <codeph>dataProvider</codeph> property
      contains an ArrayCollection of File instances
      for the new directory's contents.</p>
     
      <p>The following example shows how to use this method
      along with the Button control to create an up button:</p>
     
      <pre>
      &lt;mx:FileSystemList id="fileSystemViewer" directory="{File.desktopDirectory}"/&gt;
      &lt;mx:Button label="Up"
          enabled="{fileSystemViewer.canNavigateUp}"
          click="fileSystemViewer.navigateUp();"/&gt;</pre>
     
      </apiDesc></apiOperationDetail><related-links><link href="mx.controls.xml#FileSystemList/canNavigateUp"><linktext>canNavigateUp</linktext></link></related-links></apiOperation><apiOperation id="mx.controls:FileSystemList:refresh"><apiName>refresh</apiName><shortdesc>
      Re-enumerates the current directory being displayed by this control.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiOperationDetail><apiOperationDef><apiAccess value="public"/><apiReturn><apiType value="void"/></apiReturn></apiOperationDef><apiDesc>
      Re-enumerates the current directory being displayed by this control.
     
      <p>Because AIR does not support file system notifications,
      this control does not automatically refresh if a file or
      subdirectory is created, deleted, moved, or renamed;
      in other words, it can display an out-of-date view of the file system.
      However, you can call <codeph>refresh()</codeph> to re-enumerate
      the current <codeph>directory</codeph> so that it is up-to-date.
      You could, for example, choose to do this when you have
      performed a file operation that you know causes the control's
      view to become stale, or when the user deactivates
      and reactivates your application.</p>
     
      <p>This method preserves any selected items (if they still exist)
      and the scroll position (if the first visible item still exists).</p>
      
      </apiDesc></apiOperationDetail></apiOperation><apiValue id="mx.controls:FileSystemList:COMPUTER"><apiName>COMPUTER</apiName><shortdesc>
      A constant that can be used as a value for the directory property,
      representing a pseudo-top level directory named "Computer".</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiAccess value="public"/><apiStatic/><apiData>unknown</apiData><apiType value="flash.filesystem:File"/></apiValueDef><apiDesc>
      A constant that can be used as a value for the <codeph>directory</codeph> property,
      representing a pseudo-top level directory named "Computer". This pseudo-directory
      contains the root directories
      (such as C:\ and D:\ on Windows or / on Macintosh).
      
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FileSystemList:backHistory:get"><apiName>backHistory</apiName><shortdesc>
      An Array of File objects representing directories
      to which the user can navigate backward.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty isBindable="true"/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="read"/><apiType value="Array"/><apiDefaultValue>[]
     
      </apiDefaultValue></apiValueDef><apiDesc>
      An Array of File objects representing directories
      to which the user can navigate backward.
     
      <p>The first item in this Array is the next directory backward
      in the history list.
      The last item is the directory furthest backward
      in the history list.</p>
     
      <p>This Array may contain a <codeph>null</codeph> item, which represents
      the non-existent directory whose contents are root directories
      such as C:\ and D:\ on Microsoft Windows.</p>
     
      <p>The following example shows how to use this property
      along with the FileSystemHistoryButton control
      to implement a back button:</p>
     
      <pre>
      &lt;mx:FileSystemList id="fileSystemViewer" directory="{File.desktopDirectory}"/&gt;
      &lt;mx:FileSystemHistoryButton label="Back"
          enabled="{fileSystemViewer.canNavigateBack}"
          dataProvider="{fileSystemViewer.backHistory}"
          click="fileSystemViewer.navigateBack();"
          itemClick="fileSystemViewer.navigateBack(event.index);"/&gt;</pre>
     
      </apiDesc></apiValueDetail><related-links><link href="mx.controls.xml#FileSystemList/canNavigateBack"><linktext>canNavigateBack</linktext></link><link href="mx.controls.xml#FileSystemList/navigateBack()"><linktext>navigateBack()</linktext></link><link href="mx.controls.xml#FileSystemHistoryButton"><linktext>mx.controls.FileSystemHistoryButton</linktext></link></related-links></apiValue><apiValue id="mx.controls:FileSystemList:canNavigateBack:get"><apiName>canNavigateBack</apiName><shortdesc>
      A flag which is true if there is at least one directory
      in the history list to which the user can navigate backward.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty isBindable="true"/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="read"/><apiType value="Boolean"/><apiDefaultValue>false
     
      </apiDefaultValue></apiValueDef><apiDesc>
      A flag which is <codeph>true</codeph> if there is at least one directory
      in the history list to which the user can navigate backward.
     
      <p>The following example shows how to use this property
      along with the FileSystemHistoryButton control
      to implement a back button:</p>
     
      <pre>
      &lt;mx:FileSystemList id="fileSystemViewer" directory="{File.desktopDirectory}"/&gt;
      &lt;mx:FileSystemHistoryButton label="Back"
          enabled="{fileSystemViewer.canNavigateBack}"
          dataProvider="{fileSystemViewer.backHistory}"
          click="fileSystemViewer.navigateBack();"
          itemClick="fileSystemViewer.navigateBack(event.index);"/&gt;</pre>
     
      </apiDesc></apiValueDetail><related-links><link href="mx.controls.xml#FileSystemList/backHistory"><linktext>backHistory</linktext></link><link href="mx.controls.xml#FileSystemList/navigateBack()"><linktext>navigateBack()</linktext></link></related-links></apiValue><apiValue id="mx.controls:FileSystemList:canNavigateDown:get"><apiName>canNavigateDown</apiName><shortdesc>
      A flag which is true if the user can navigate down
      into a selected directory.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty isBindable="true"/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="read"/><apiType value="Boolean"/><apiDefaultValue>false
     
      </apiDefaultValue></apiValueDef><apiDesc>
      A flag which is <codeph>true</codeph> if the user can navigate down
      into a selected directory.
      This flag is <codeph>false</codeph> when there is no selected item
      or when the selected item is a file rather than a directory.
     
      <p>The following example shows how to use this property
      along with the Button control:</p>
     
      <pre>
      &lt;mx:FileSystemList id="fileSystemViewer" directory="{File.desktopDirectory}"/&gt;
      &lt;mx:Button label="Open"
          enabled="{fileSystemViewer.canNavigateDown}"
          click="fileSystemViewer.navigateDown();"/&gt;</pre>
     
      </apiDesc></apiValueDetail><related-links><link href="mx.controls.xml#FileSystemList/navigateDown()"><linktext>navigateDown()</linktext></link></related-links></apiValue><apiValue id="mx.controls:FileSystemList:canNavigateForward:get"><apiName>canNavigateForward</apiName><shortdesc>
      A flag which is true if there is at least one directory
      in the history list to which the user can navigate forward.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty isBindable="true"/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="read"/><apiType value="Boolean"/><apiDefaultValue>false
     
      </apiDefaultValue></apiValueDef><apiDesc>
      A flag which is <codeph>true</codeph> if there is at least one directory
      in the history list to which the user can navigate forward.
     
      <p>The following example shows how to use this property
      along with the FileSystemHistoryButton control
      to implement a forward button:</p>
     
      <pre>
      &lt;mx:FileSystemList id="fileSystemViewer" directory="{File.desktopDirectory}"/&gt;
      &lt;mx:FileSystemHistoryButton label="Forward"
          enabled="{fileSystemViewer.canNavigateForward}"
          dataProvider="{fileSystemViewer.forwardHistory}"
          click="fileSystemViewer.navigateForward();"
          itemClick="fileSystemViewer.navigateForward(event.index);"/&gt;</pre>
     
      </apiDesc></apiValueDetail><related-links><link href="mx.controls.xml#FileSystemList/forwardHistory"><linktext>forwardHistory</linktext></link><link href="mx.controls.xml#FileSystemList/navigateForward()"><linktext>navigateForward()</linktext></link></related-links></apiValue><apiValue id="mx.controls:FileSystemList:canNavigateUp:get"><apiName>canNavigateUp</apiName><shortdesc>
      A flag which is true if the user can navigate up
      to a parent directory.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty isBindable="true"/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="read"/><apiType value="Boolean"/><apiDefaultValue>false
     
      </apiDefaultValue></apiValueDef><apiDesc>
      A flag which is <codeph>true</codeph> if the user can navigate up
      to a parent directory.
      This flag is only <codeph>false</codeph> when this control is
      displaying the root directories
      such as C:\ and D:\ on Microsoft Windows.
      (This is the case in which the <codeph>directory</codeph>
      property is <codeph>COMPUTER</codeph>.)
     
      <p>The following example shows how to use this property
      along with the Button control:</p>
     
      <pre>
      &lt;mx:FileSystemList id="fileSystemViewer" directory="{File.desktopDirectory}"/&gt;
      &lt;mx:Button label="Up"
          enabled="{fileSystemViewer.canNavigateUp}"
          click="fileSystemViewer.navigateUp();"/&gt;</pre>
     
      </apiDesc></apiValueDetail><related-links><link href="mx.controls.xml#FileSystemList/navigateUp()"><linktext>navigateUp()</linktext></link></related-links></apiValue><apiValue id="mx.controls:FileSystemList:directory:get"><apiName>directory</apiName><shortdesc>
      The directory whose contents this control displays.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty isBindable="true"/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="flash.filesystem:File"/><apiDefaultValue>COMPUTER
      
      </apiDefaultValue></apiValueDef><apiDesc>
      The directory whose contents this control displays.
     
      <p>If you set this property to a File object representing
      an existing directory, the <codeph>dataProvider</codeph>
      immediately becomes <codeph>null</codeph>.
      Later, when this control is revalidated by the LayoutManager,
      it enumerates that directory's contents
      and populates the <codeph>dataProvider</codeph> property
      with an ArrayCollection of the resulting File objects
      for the directory's files and subdirectories.</p>
     
      <p>Setting this to a File which does not represent
      an existing directory is an error.
      Setting this to <codeph>COMPUTER</codeph> synchronously displays
      the root directories, such as C: and D: on Windows.</p>
     
      <p>Setting this property deselects any previously selected items
      and causes the control to reset its scroll position
      to the upper-left corner.</p>
     
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FileSystemList:enumerationMode:get"><apiName>enumerationMode</apiName><shortdesc>
      A String specifying whether this control displays
      only files, only subdirectories, or both.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="String"/><apiDefaultValue>FileSystemEnumerationMode.DIRECTORIES_FIRST
     
      </apiDefaultValue></apiValueDef><apiDesc>
      A String specifying whether this control displays
      only files, only subdirectories, or both.
      In the case that both are displayed,
      it also specifies whether the subdirectories are displayed
      before, after, or mixed in with the files.
      The possible values are specified
      by the FileSystemEnumerationMode class.
     
      <p>This property affects which subdirectories
      and files are displayed in the control,
      and the order in which they appear.
      However, it does not affect which File instances
      are in the <codeph>dataProvider</codeph> property; it works
      by changing the behavior of the filter function
      that is applied to the <codeph>dataProvider</codeph>.
      Setting it does not cause the current <codeph>directory</codeph>
      to be re-enumerated.</p>
     
      <p>Setting this property deselects any selected items
      and causes the control to reset its scroll position
      to the upper-left corner.</p>
     
      </apiDesc></apiValueDetail><related-links><link href="mx.controls.xml#FileSystemEnumerationMode"><linktext>mx.controls.FileSystemEnumerationMode</linktext></link></related-links></apiValue><apiValue id="mx.controls:FileSystemList:extensions:get"><apiName>extensions</apiName><shortdesc>
      An Array of extensions specifying which files
      can be displayed in this control.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="Array"/><apiDefaultValue>null
      
      </apiDefaultValue></apiValueDef><apiDesc>
      An Array of extensions specifying which files
      can be displayed in this control.
      If this property is set, for example,
      to <codeph>[ ".htm", ".html" ]</codeph>,
      then only files with these extensions can be displayed.
     
      <p>Extensions are considered case-insensitive
      and the preceding dot is optional.
      For example, specifying <codeph>".HTML"</codeph>
      is equivalent to specifying <codeph>"html"</codeph>.</p>
     
      <p>Directories are not subject to extension filtering,
      even if they have names containing dots.</p>
     
      <p>The <codeph>enumerationMode</codeph> and <codeph>filterFunction</codeph>
      properties are also involved in determining which files
      appear in the control.
      For example, if this property is <codeph>[ ".htm", ".html" ]</codeph>,
      an .html file is not displayed if the
      <codeph>enumerationMode</codeph> property is
      <codeph>FileSystemEnumerationMode.DIRECTORIES_ONLY</codeph>,
      or if the <codeph>filterFunction</codeph> returns <codeph>false</codeph>
      for the file.</p>
     
      <p>If this property is <codeph>null</codeph>, no extension filtering
      occurs, and all files are displayed.
      If this property is an empty Array, all extensions are filtered out
      and no files with extensions are displayed.</p>
     
      <p>This property affects which files are displayed in the control.
      However, it does not affect which File instances
      are in the <codeph>dataProvider</codeph> property; it works
      by changing the behavior of the filter function
      that is applied to the <codeph>dataProvider</codeph>.
      Setting it does not cause the current <codeph>directory</codeph>
      to be re-enumerated.</p>
     
      <p>Setting this property deselects any selected items
      and causes the control to reset its scroll position
      to the upper-left corner.</p>
     
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FileSystemList:filterFunction:get"><apiName>filterFunction</apiName><shortdesc>
      A callback Function that you can use to perform additional filtering,
      after the enumerationMode and extensions
      properties have been applied, to determine which files
      and subdirectories are displayed and which are hidden.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="Function"/><apiDefaultValue>null
      
      </apiDefaultValue></apiValueDef><apiDesc>
      A callback Function that you can use to perform additional filtering,
      after the <codeph>enumerationMode</codeph> and <codeph>extensions</codeph>
      properties have been applied, to determine which files
      and subdirectories are displayed and which are hidden.
     
      <p>This function must have the following signature:</p>
     
      <pre>function myFilterFunction(file:File):Boolean</pre>
     
      This function should return <codeph>true</codeph> to show the specified
      file or subdirectory and <codeph>false</codeph> to hide it.
     
      <p>To ensure that every enumerated file and subdirectory is passed
      to this function, the <codeph>enumerationMode</codeph> property must
      not be <codeph>FileSystemEnumerationMode.FILES_ONLY</codeph> or
      <codeph>FileSystemEnumerationMode.DIRECTORIES_ONLY</codeph>,
      and the <codeph>extensions</codeph> property must be <codeph>null</codeph>.
      Otherwise, these properties cause pre-filtering to occur
      before this filter function is called.</p>
     
      <p>This property affects which subdirectories
      and files are displayed in the control.
      However, it does not affect which File instances
      are in the <codeph>dataProvider</codeph> property; it works
      by changing the behavior of the filter function
      that is applied to the <codeph>dataProvider</codeph>.
      Setting it does not cause the current <codeph>directory</codeph>
      to be re-enumerated.</p>
     
      <p>Setting this property deselects any selected items
      and causes the control to reset its scroll position
      to the upper-left corner.</p>
     
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FileSystemList:forwardHistory:get"><apiName>forwardHistory</apiName><shortdesc>
      An Array of File objects representing directories
      to which the user can navigate forward.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty isBindable="true"/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="read"/><apiType value="Array"/><apiDefaultValue>[]
     
      </apiDefaultValue></apiValueDef><apiDesc>
      An Array of File objects representing directories
      to which the user can navigate forward.
     
      <p>The first item in this Array is the next directory forward
      in the history list.
      The last item is the directory furthest forward
      in the history list.</p>
     
      <p>This Array may contain the special <codeph>COMPUTER</codeph> File object,
      which represents the non-existent directory whose contents
      are root directories such as C:\ and D:\ on Windows.</p>
     
      <p>The following example shows how to use this property
      along with the FileSystemHistoryButton control
      to implement a forward button:</p>
     
      <pre>
      &lt;mx:FileSystemList id="fileSystemViewer" directory="{File.desktopDirectory}"/&gt;
      &lt;mx:FileSystemHistoryButton label="Forward"
          enabled="{fileSystemViewer.canNavigateForward}"
          dataProvider="{fileSystemViewer.forwardHistory}"
          click="fileSystemViewer.navigateForward();"
          itemClick="fileSystemViewer.navigateForward(event.index);"/&gt;</pre>
     
      </apiDesc></apiValueDetail><related-links><link href="mx.controls.xml#FileSystemList/canNavigateForward"><linktext>canNavigateForward</linktext></link><link href="mx.controls.xml#FileSystemList/navigateForward()"><linktext>navigateForward()</linktext></link><link href="mx.controls.xml#FileSystemHistoryButton"><linktext>mx.controls.FileSystemHistoryButton</linktext></link></related-links></apiValue><apiValue id="mx.controls:FileSystemList:nameCompareFunction:get"><apiName>nameCompareFunction</apiName><shortdesc>
      A callback Function that you can use to change how file and subdirectory
      names are compared in order to produce the sort order.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="Function"/><apiDefaultValue>null
      
      </apiDefaultValue></apiValueDef><apiDesc>
      A callback Function that you can use to change how file and subdirectory
      names are compared in order to produce the sort order.
     
      <p>This function must have the following signature:</p>
     
      <pre>function myNameCompareFunction(name1:String, name2:String):int</pre>
     
      <p>It returns <codeph>-1</codeph> if <codeph>name1</codeph> should sort before
      <codeph>name2</codeph>, <codeph>1</codeph> if <codeph>name1</codeph> should
      sort after <codeph>name2</codeph>, and <codeph>0</codeph> if the names
      are the same.</p>
     
      <p>If you do not set this property, the control performs
      a case-insensitive, locale-dependent comparison of the two names,
      by first calling the String method <codeph>toLocaleLowerCase()</codeph>
      on each name and then comparing them with the <codeph>&lt;</codeph>
      and <codeph>&gt;</codeph> operators.</p>
     
      <p>If you have set <codeph>enumerationMode</codeph> to either
      <codeph>FileSystemEnumerationMode.FILES_FIRST</codeph> or
      <codeph>FileSystemEnumerationMode.DIRECTORIES_FIRST</codeph>,
      then this method is used to compare names only within
      the separate groups of files and directories.</p>
     
      <p>This property affects the order in which
      subdirectories and files are displayed in the control.
      However, it does not affect which File instances
      are in the <codeph>dataProvider</codeph> property; it works
      by changing the behavior of the sort
      that is applied to the <codeph>dataProvider</codeph>.
      Setting it does not cause the current <codeph>directory</codeph>
      to be re-enumerated.</p>
     
      <p>Setting this property deselects any selected items
      and causes the control to reset its scroll position
      to the upper-left corner.</p>
     
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FileSystemList:selectedPath:get"><apiName>selectedPath</apiName><shortdesc>
      The nativePath of the File item
      representing the selected subdirectory or file,
      or null if no item is selected.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty isBindable="true"/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="String"/><apiDefaultValue>null
     
      </apiDefaultValue></apiValueDef><apiDesc>
      The <codeph>nativePath</codeph> of the File item
      representing the selected subdirectory or file,
      or <codeph>null</codeph> if no item is selected.
     
      <p>If multiple items are selected, getting this property
      gives the first path in the <codeph>selectedPaths</codeph> array.</p>
     
      <p>Setting this property affects the <codeph>selectedPaths</codeph>,
      <codeph>selectedItem</codeph>, <codeph>selectedItems</codeph>,
      <codeph>selectedIndex</codeph>, and <codeph>selectedIndices</codeph>
      properties.</p>
     
      </apiDesc></apiValueDetail><related-links><link href="" invalidHref="mx.controls.listClasses.xml#ListBase/selectedIndex"><linktext>mx.controls.listClasses.ListBase.selectedIndex</linktext></link><link href="" invalidHref="mx.controls.listClasses.xml#ListBase/selectedItem"><linktext>mx.controls.listClasses.ListBase.selectedItem</linktext></link></related-links></apiValue><apiValue id="mx.controls:FileSystemList:selectedPaths:get"><apiName>selectedPaths</apiName><shortdesc>
      An Array of nativePath Strings for the File items
      representing the selected subdirectories and files.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty isBindable="true"/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="Array"/><apiDefaultValue>[]
     
      </apiDefaultValue></apiValueDef><apiDesc>
      An Array of <codeph>nativePath</codeph> Strings for the File items
      representing the selected subdirectories and files.
      This Array is empty if no items are selected.
     
      <p>Setting this property affects the <codeph>selectedPaths</codeph>,
      <codeph>selectedItem</codeph>, <codeph>selectedItems</codeph>,
      <codeph>selectedIndex</codeph>, and <codeph>selectedIndices</codeph>
      properties.</p>
     
      </apiDesc></apiValueDetail><related-links><link href="" invalidHref="mx.controls.listClasses.xml#ListBase/selectedIndex"><linktext>mx.controls.listClasses.ListBase.selectedIndex</linktext></link><link href="" invalidHref="mx.controls.listClasses.xml#ListBase/selectedItem"><linktext>mx.controls.listClasses.ListBase.selectedItem</linktext></link></related-links></apiValue><apiValue id="mx.controls:FileSystemList:showExtensions:get"><apiName>showExtensions</apiName><shortdesc>
      A flag that specifies whether extensions in file names are shown.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="Boolean"/><apiDefaultValue>true
      
      </apiDefaultValue></apiValueDef><apiDesc>
      A flag that specifies whether extensions in file names are shown.
      Set this property to <codeph>true</codeph> to show file extensions
      and to <codeph>false</codeph> to hide them.
      Extensions in directory names are always shown.
     
      <p>Setting this property does not affect which items
      are displayed, or the order in which they appear.
      It also does not affect which items are selected,
      or the scroll position.</p>
     
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FileSystemList:showHidden:get"><apiName>showHidden</apiName><shortdesc>
      A flag that specifies whether files and directories
      that the operating system considers hidden are displayed.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="Boolean"/><apiDefaultValue>false
      
      </apiDefaultValue></apiValueDef><apiDesc>
      A flag that specifies whether files and directories
      that the operating system considers hidden are displayed.
      Set this property to <codeph>true</codeph> to show hidden files
      and directories and to <codeph>false</codeph> to hide them.
     
      <p>Setting this property deselects any selected items
      and causes the control to reset its scroll position
      to the upper-left corner.</p>
     
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FileSystemList:showIcons:get"><apiName>showIcons</apiName><shortdesc>
      A flag that specifies that icons are displayed
      before the file name.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="Boolean"/><apiDefaultValue>true
      
      </apiDefaultValue></apiValueDef><apiDesc>
      A flag that specifies that icons are displayed
      before the file name.
      Set this property to <codeph>true</codeph> to show icons
      and to <codeph>false</codeph> to hide them.
     
      <p>You can set the <codeph>directoryIcon</codeph>
      and <codeph>fileIcon</codeph> styles to change the default icons.
      This control cannot display the actual icon that the operating system
      displays for a file, because Apollo M2 does not support that feature.</p>
     
      <p>Setting this property does not affect which items
      are displayed, or the order in which they appear.
      It also does not affect which items are selected,
      or the scroll position.</p>
     
      </apiDesc></apiValueDetail></apiValue></apiClassifier><apiClassifier id="mx.controls:FileSystemSizeDisplayMode"><apiName>FileSystemSizeDisplayMode</apiName><shortdesc>
  The FileSystemSizeDisplayMode class defines the constant values
  for the sizeDisplayMode property
  of the FileSystemDataGrid class.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiClassifierDetail><apiClassifierDef><apiAccess value="public"/><apiStatic/><apiFinal/><apiBaseClassifier>Object</apiBaseClassifier></apiClassifierDef><apiDesc>
  The FileSystemSizeDisplayMode class defines the constant values
  for the <codeph>sizeDisplayMode</codeph> property
  of the FileSystemDataGrid class.
 
  </apiDesc></apiClassifierDetail><related-links><link href="mx.controls.xml#FileSystemDataGrid/enumerationMode"><linktext>mx.controls.FileSystemDataGrid.enumerationMode</linktext></link></related-links><apiValue id="mx.controls:FileSystemSizeDisplayMode:BYTES"><apiName>BYTES</apiName><shortdesc>
      Specifies to show file sizes in bytes.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiAccess value="public"/><apiStatic/><apiData>bytes</apiData><apiType value="String"/></apiValueDef><apiDesc>
      Specifies to show file sizes in bytes.
      
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FileSystemSizeDisplayMode:KILOBYTES"><apiName>KILOBYTES</apiName><shortdesc>
      Specifies to show file sizes in kilobytes.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiAccess value="public"/><apiStatic/><apiData>kilobytes</apiData><apiType value="String"/></apiValueDef><apiDesc>
      Specifies to show file sizes in kilobytes.
      
      </apiDesc></apiValueDetail></apiValue></apiClassifier><apiClassifier id="mx.controls:HTML"><apiName>HTML</apiName><shortdesc>
  The HTML control lets you display HTML content in your application.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion><styles><style format="Length" inherit="no" name="paddingTop" owner="mx.controls:HTML" playerVersion="AIR1.1" type="Number">
<description>
  The number of pixels between the top edge of this control
  and the top edge of its HTML content area.
 
  </description>
<default>0
  
  </default>

	<prolog><asCustoms><langversion>3.0
  </langversion><productversion>Flex 3
 </productversion></asCustoms></prolog></style><style format="Length" inherit="no" name="paddingRight" owner="mx.controls:HTML" playerVersion="AIR1.1" type="Number">
<description>
  The number of pixels between the right edge of this control
  and the right edge of its HTML content area.
 
  </description>
<default>0
  
  </default>

	<prolog><asCustoms><langversion>3.0
  </langversion><productversion>Flex 3
 </productversion></asCustoms></prolog></style><style format="Length" inherit="no" name="paddingLeft" owner="mx.controls:HTML" playerVersion="AIR1.1" type="Number">
<description>
  The number of pixels between the left edge of this control
  and the left edge of its HTML content area.
 
  </description>
<default>0
  
  </default>

	<prolog><asCustoms><langversion>3.0
  </langversion><productversion>Flex 3
 </productversion></asCustoms></prolog></style><style format="Length" inherit="no" name="paddingBottom" owner="mx.controls:HTML" playerVersion="AIR1.1" type="Number">
<description>
  The number of pixels between the bottom edge of this control
  and the bottom edge of its HTML content area.
 
  </description>
<default>0
  
  </default>

	<prolog><asCustoms><langversion>3.0
  </langversion><productversion>Flex 3
 </productversion></asCustoms></prolog></style></styles></asMetadata><asCustoms><mxml><![CDATA[
 
  <p>The <code>&lt;mx:HTML&gt;</code> tag inherits all of the tag
  attributes of its superclass and adds the following tag attributes:</p>
 
  <pre>
  &lt;mx:HTML
    <strong>Properties</strong>
    data="<i>null</i>"
    historyPosition="0"
    htmlHost="<i>null</i>"
    htmlLoaderFactory="mx.core.ClassFactory"
    htmlText=""
    listData="<i>null</i>"
    location=""
    paintsDefaultBackground="false"
    runtimeApplicationDomain="<i>null</i>"
    userAgent="<i>null</i>"
 
    <strong>Styles</strong>
    paddingBottom="0"
    paddingLeft="0"
    paddingRight="0"
    paddingTop="0"
 
    <strong>Events</strong>
    complete="<i>No default</i>"
    htmlDOMInitialize="<i>No default</i>"
    htmlRender="<i>No default</i>"
    locationChange="<i>No default</i>"
    uncaughtScriptException="<i>No default</i>"
  /&gt;
  </pre>
 
  ]]></mxml></asCustoms></prolog><apiClassifierDetail><apiClassifierDef><apiAccess value="public"/><apiStatic/><apiBaseInterface>mx.core:IDataRenderer</apiBaseInterface><apiBaseInterface>mx.controls.listClasses:IDropInListItemRenderer</apiBaseInterface><apiBaseInterface>mx.controls.listClasses:IListItemRenderer</apiBaseInterface><apiBaseInterface>mx.managers:IFocusManagerComponent</apiBaseInterface><apiBaseClassifier>mx.core:ScrollControlBase</apiBaseClassifier></apiClassifierDef><apiDesc>
  The HTML control lets you display HTML content in your application.
 
  <p>You use the <codeph>location</codeph> property to specify the URL
  of an HTML page whose content is displayed in the control, or you
  can set the <codeph>htmlText</codeph> property to specify a String
  containing HTML-formatted text that is rendered in the control.</p>
 
  </apiDesc></apiClassifierDetail><related-links><link href="../../flash/html/HTMLLoader.html"><linktext>HTMLLoader</linktext></link></related-links><adobeApiEvent id="mx.controls:HTML_flash.events.HTMLUncaughtScriptExceptionEvent.UNCAUGHT_SCRIPT_EXCEPTION_uncaughtScriptException"><apiName>uncaughtScriptException</apiName><shortdesc>
  Dispatched when an uncaught JavaScript exception occurs.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><adobeApiEventDetail><adobeApiEventDef><apiEventType>flash.events.HTMLUncaughtScriptExceptionEvent.UNCAUGHT_SCRIPT_EXCEPTION</apiEventType><adobeApiEventClassifier>flash.events.HTMLUncaughtScriptExceptionEvent</adobeApiEventClassifier><apiGeneratedEvent/></adobeApiEventDef><apiDesc>
  Dispatched when an uncaught JavaScript exception occurs.
 
  <p>This event is always dispatched asynchronously.
  An event handler for this event may call any method
  or access any property of this control
  or its internal <codeph>htmlLoader</codeph>.</p>
 
  </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="mx.controls:HTML_flash.events.Event.LOCATION_CHANGE_locationChange"><apiName>locationChange</apiName><shortdesc>
  Dispatched when the location property changes.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><adobeApiEventDetail><adobeApiEventDef><apiEventType>flash.events.Event.LOCATION_CHANGE</apiEventType><adobeApiEventClassifier>flash.events.Event</adobeApiEventClassifier><apiGeneratedEvent/></adobeApiEventDef><apiDesc>
  Dispatched when the <codeph>location</codeph> property changes.
 
  <p>This event is always dispatched asynchronously.
  An event handler for this event may call any method
  or access any property of this control
  or its internal <codeph>htmlLoader</codeph>.</p>
 
  </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="mx.controls:HTML_flash.events.Event.HTML_RENDER_htmlRender"><apiName>htmlRender</apiName><shortdesc>
  Dispatched when this control's HTML content initially renders,
  and each time that it re-renders.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><adobeApiEventDetail><adobeApiEventDef><apiEventType>flash.events.Event.HTML_RENDER</apiEventType><adobeApiEventClassifier>flash.events.Event</adobeApiEventClassifier><apiGeneratedEvent/></adobeApiEventDef><apiDesc>
  Dispatched when this control's HTML content initially renders,
  and each time that it re-renders.
 
  <p>Because an HTML control can dispatch many of these events,
  you should avoid significant processing in a <codeph>render</codeph>
  handler that might negatively impact performance.</p>
 
  </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="mx.controls:HTML_flash.events.Event.HTML_DOM_INITIALIZE_htmlDOMInitialize"><apiName>htmlDOMInitialize</apiName><shortdesc>
  Dispatched after the HTML DOM has been initialized
  in response to a loading operation caused by
  setting the location or htmlText property.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><adobeApiEventDetail><adobeApiEventDef><apiEventType>flash.events.Event.HTML_DOM_INITIALIZE</apiEventType><adobeApiEventClassifier>flash.events.Event</adobeApiEventClassifier><apiGeneratedEvent/></adobeApiEventDef><apiDesc>
  Dispatched after the HTML DOM has been initialized
  in response to a loading operation caused by
  setting the <codeph>location</codeph> or <codeph>htmlText</codeph> property.
 
  <p>When this event is dispatched,
  no JavaScript methods have yet executed.
  The <codeph>domWindow</codeph>and <codeph>domWindow.document</codeph>
  objects exist, but other DOM objects may not.
  You can use this event to set properties
  onto the <codeph>domWindow</codeph> and <codeph>domWindow.document</codeph>
  objects for JavaScript methods to later access.</p>
 
  <p>A handler for this event should not set any properties
  or call any methods which start another loading operation
  or which affect the URL for the current loading operation;
  doing so causes either an ActionScript or a JavaScript exception.</p>
 
  </apiDesc></adobeApiEventDetail><related-links><link href="" invalidHref="mx.controls.location.xml"><linktext>location</linktext></link><link href="" invalidHref="mx.controls.htmlText.xml"><linktext>htmlText</linktext></link></related-links></adobeApiEvent><adobeApiEvent id="mx.controls:HTML_flash.events.Event.COMPLETE_complete"><apiName>complete</apiName><shortdesc>
  Dispatched after the last loading operation caused by
  setting the location or htmlText
  property has completed.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><adobeApiEventDetail><adobeApiEventDef><apiEventType>flash.events.Event.COMPLETE</apiEventType><adobeApiEventClassifier>flash.events.Event</adobeApiEventClassifier><apiGeneratedEvent/></adobeApiEventDef><apiDesc>
  Dispatched after the last loading operation caused by
  setting the <codeph>location</codeph> or <codeph>htmlText</codeph>
  property has completed.
 
  <p>This event is always dispatched asynchronously,
  after the JavaScript <codeph>load</codeph> event
  has been dispatched in the HTML DOM.</p>
 
  <p>An event handler for this event may call any method
  or access any property of this control
  or its internal <codeph>htmlLoader</codeph>.</p>
 
  </apiDesc></adobeApiEventDetail><related-links><link href="" invalidHref="mx.controls.location.xml"><linktext>location</linktext></link><link href="" invalidHref="mx.controls.htmlText.xml"><linktext>htmlText</linktext></link></related-links></adobeApiEvent><apiConstructor id="mx.controls:HTML:HTML"><apiName>HTML</apiName><shortdesc>
      Constructor.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiConstructorDetail><apiConstructorDef><apiAccess value="public"/></apiConstructorDef><apiDesc>
      Constructor.
      
      </apiDesc></apiConstructorDetail></apiConstructor><apiOperation id="mx.controls:HTML:cancelLoad"><apiName>cancelLoad</apiName><shortdesc>
      Cancels any load operation in progress.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiOperationDetail><apiOperationDef><apiAccess value="public"/><apiReturn><apiType value="void"/></apiReturn></apiOperationDef><apiDesc>
      Cancels any load operation in progress.
     
      <p>This method does nothing if it is called before this component's
      internal HTMLLoader (the <codeph>htmlLoader</codeph> property) has been created.</p>
      
      </apiDesc></apiOperationDetail></apiOperation><apiOperation id="mx.controls:HTML:getHistoryAt"><apiName>getHistoryAt</apiName><shortdesc>
      Returns the HTMLHistoryItem at the specified position
      in this control's history list.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiOperationDetail><apiOperationDef><apiAccess value="public"/><apiReturn><apiDesc>A HTMLHistoryItem object
      for the history entry  at the specified position.
     
      </apiDesc><apiType value="flash.html:HTMLHistoryItem"/></apiReturn><apiParam><apiItemName>position</apiItemName><apiType value="int"/><apiDesc>The position in the history list.
     
      </apiDesc></apiParam></apiOperationDef><apiDesc>
      Returns the HTMLHistoryItem at the specified position
      in this control's history list.
     
      <p>This method returns <codeph>null</codeph> if it is called before this
      component's internal HTMLLoader (the <codeph>htmlLoader</codeph> property) has been created.</p>
     
      </apiDesc></apiOperationDetail><related-links><link href="" invalidHref="mx.controls.historyPosition.xml"><linktext>historyPosition</linktext></link></related-links></apiOperation><apiOperation id="mx.controls:HTML:historyBack"><apiName>historyBack</apiName><shortdesc>
      Navigates back in this control's history list, if possible.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiOperationDetail><apiOperationDef><apiAccess value="public"/><apiReturn><apiType value="void"/></apiReturn></apiOperationDef><apiDesc>
      Navigates back in this control's history list, if possible.
     
      <p>Calling this method of the HTMLLoader object
      has the same effect as calling the <codeph>back()</codeph> method
      of the <codeph>window.history</codeph> property in JavaScript
      in the HTML content.</p>
     
      <p>This method does nothing if it is called before this component's
      internal HTMLLoader (the <codeph>htmlLoader</codeph> property) has been created.</p>
     
      </apiDesc></apiOperationDetail><related-links><link href="mx.controls.xml#HTML/historyPosition"><linktext>historyPosition</linktext></link><link href="mx.controls.xml#HTML/historyForward()"><linktext>historyForward()</linktext></link></related-links></apiOperation><apiOperation id="mx.controls:HTML:historyForward"><apiName>historyForward</apiName><shortdesc>
      Navigates forward in this control's history list, if possible.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiOperationDetail><apiOperationDef><apiAccess value="public"/><apiReturn><apiType value="void"/></apiReturn></apiOperationDef><apiDesc>
      Navigates forward in this control's history list, if possible.
     
      <p>Calling this method of the HTMLLoader object
      has the same effect as calling the <codeph>forward()</codeph> method
      of the <codeph>window.history</codeph> property in JavaScript
      in the HTML content.</p>
     
      <p>This function throws no errors.</p>
     
      <p>This method does nothing if it is called before this component's
      internal HTMLLoader (the <codeph>htmlLoader</codeph> property) has been created.</p>
     
      </apiDesc></apiOperationDetail><related-links><link href="mx.controls.xml#HTML/historyPosition"><linktext>historyPosition</linktext></link><link href="mx.controls.xml#HTML/historyBack()"><linktext>historyBack()</linktext></link></related-links></apiOperation><apiOperation id="mx.controls:HTML:historyGo"><apiName>historyGo</apiName><shortdesc>
      Navigates the specified number of steps in this control's history list.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiOperationDetail><apiOperationDef><apiAccess value="public"/><apiReturn><apiType value="void"/></apiReturn><apiParam><apiItemName>steps</apiItemName><apiType value="int"/><apiDesc>The number of steps in the history list
      to move forward (positive) or backward (negative).
      
      </apiDesc></apiParam></apiOperationDef><apiDesc>
      Navigates the specified number of steps in this control's history list.
     
      <p>This method navigates forward if the number of steps
      is positive and backward if it is negative.
      Navigation by zero steps is equivalent
      to calling <codeph>reload()</codeph>.</p>
     
      <p>This method is equivalent to calling the <codeph>go()</codeph> method
      of the <codeph>window.history</codeph> property in JavaScript
      in the HTML content.</p>
     
      <p>This method does nothing if it is called before this component's
      internal HTMLLoader (the <codeph>htmlLoader</codeph> property) has been created.</p>
     
      </apiDesc></apiOperationDetail></apiOperation><apiOperation id="mx.controls:HTML:reload"><apiName>reload</apiName><shortdesc>
      Reloads the HTML content from the current location.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiOperationDetail><apiOperationDef><apiAccess value="public"/><apiReturn><apiType value="void"/></apiReturn></apiOperationDef><apiDesc>
      Reloads the HTML content from the current <codeph>location</codeph>.
     
      <p>This method does nothing if it is called before this component's
      internal HTMLLoader (the <codeph>htmlLoader</codeph> property) has been created.</p>
      
      </apiDesc></apiOperationDetail></apiOperation><apiValue id="mx.controls:HTML:htmlLoader"><apiName>htmlLoader</apiName><shortdesc>
      The internal HTMLLoader object that renders
      the HTML content for this control.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiType value="flash.html:HTMLLoader"/></apiValueDef><apiDesc>
      The internal HTMLLoader object that renders
      the HTML content for this control.
      
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:HTML:contentHeight:get"><apiName>contentHeight</apiName><shortdesc>
      The height, in pixels, of the HTML content.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="read"/><apiType value="Number"/></apiValueDef><apiDesc>
      The height, in pixels, of the HTML content.
      
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:HTML:contentWidth:get"><apiName>contentWidth</apiName><shortdesc>
      The width, in pixels, of the HTML content.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="read"/><apiType value="Number"/></apiValueDef><apiDesc>
      The width, in pixels, of the HTML content.
      
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:HTML:data:get"><apiName>data</apiName><shortdesc>
      Lets you pass a value to the component
      when you use it in an item renderer or item editor.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty isBindable="true"/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="Object"/><apiDefaultValue>null
      </apiDefaultValue></apiValueDef><apiDesc>
      Lets you pass a value to the component
      when you use it in an item renderer or item editor.
      You typically use data binding to bind a field of the <codeph>data</codeph>
      property to a property of this component.
     
      <p>When you use the control as a drop-in item renderer or drop-in
      item editor, Flex automatically writes the current value of the item
      to the <codeph>text</codeph> property of this control.</p>
     
      <p>You cannot set this property in MXML.</p>
     
      </apiDesc></apiValueDetail><related-links><link href="" invalidHref="mx.core.IDataRenderer.xml"><linktext>mx.core.IDataRenderer</linktext></link></related-links></apiValue><apiValue id="mx.controls:HTML:domWindow:get"><apiName>domWindow</apiName><shortdesc>
      The JavaScript window object
      for the root frame of the HTML DOM inside this control.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="read"/><apiType value="Object"/><apiDefaultValue>null
      
      </apiDefaultValue></apiValueDef><apiDesc>
      The JavaScript <codeph>window</codeph> object
      for the root frame of the HTML DOM inside this control.
     
      <p>This property is <codeph>null</codeph> until the
      <codeph>htmlDOMInitialize</codeph> event has been dispatched.</p>
     
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:HTML:historyLength:get"><apiName>historyLength</apiName><shortdesc>
      The overall length of the history list,
      including back and forward entries.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="read"/><apiType value="int"/></apiValueDef><apiDesc>
      The overall length of the history list,
      including back and forward entries.
     
      This property has the same value
      as the <codeph>window.history.length</codeph>
      JavaScript property of the the HTML content.
     
      </apiDesc></apiValueDetail><related-links><link href="mx.controls.xml#HTML/historyPosition"><linktext>historyPosition</linktext></link></related-links></apiValue><apiValue id="mx.controls:HTML:historyPosition:get"><apiName>historyPosition</apiName><shortdesc>
      The current position in the history list.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="int"/><apiDefaultValue>0
      
      </apiDefaultValue></apiValueDef><apiDesc>
      The current position in the history list.
     
      <p>The history list corresponds to the <codeph>window.history</codeph>
      object of the HTML content.
      Entries less than the current position are the "back" list;
      entries greater are "forward."
      Attempting to set the position beyond the end sets it to the end.</p>
     
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:HTML:htmlHost:get"><apiName>htmlHost</apiName><shortdesc>
      The HTMLHost object is used to handle changes
      to certain user interface elements in the HTML content,
      such as the window.document.title property.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="flash.html:HTMLHost"/><apiDefaultValue>null
      
      </apiDefaultValue></apiValueDef><apiDesc>
      The HTMLHost object is used to handle changes
      to certain user interface elements in the HTML content,
      such as the <codeph>window.document.title</codeph> property.
     
      <p>To override default behaviors for the HTMLLoader,
      create a subclass of the HTMLHost class,
      override its member functions
      to handle various user interface changes in the HTML content,
      and set this property to an instance of your subclass.</p>
     
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:HTML:htmlLoaderFactory:get"><apiName>htmlLoaderFactory</apiName><shortdesc>
      The IFactory that creates an HTMLLoader-derived instance
      to use as the htmlLoader.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty isBindable="true"/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="mx.core:IFactory"/></apiValueDef><apiDesc>
      The IFactory that creates an HTMLLoader-derived instance
      to use as the htmlLoader.
     
      <p>The default value is an IFactory for HTMLLoader.</p>
      
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:HTML:htmlText:get"><apiName>htmlText</apiName><shortdesc>
      Specifies an HTML-formatted String for display by the control.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty isBindable="true"/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="String"/><apiDefaultValue>""
     
      </apiDefaultValue></apiValueDef><apiDesc>
      Specifies an HTML-formatted String for display by the control.
     
      <p>Setting this property has the side effect of setting
      the <codeph>location</codeph> property to <codeph>null</codeph>,
      and vice versa.</p>
     
      <p>Content added via the <codeph>htmlText</codeph> property is put in the 
      application security sandbox. If an AIR application includes an HTML 
      control located in the application sandbox, and remote HTML code is 
      directly added into the control by setting the  <codeph>htmlText</codeph> 
      property, any script contained in the HTML text is executed in the 
      application sandbox.</p>
     
      </apiDesc></apiValueDetail><related-links><link href="mx.controls.xml#HTML/location"><linktext>location</linktext></link></related-links></apiValue><apiValue id="mx.controls:HTML:listData:get"><apiName>listData</apiName><shortdesc>
      When a component is used as a drop-in item renderer or drop-in
      item editor, Flex initializes the listData property
      of the component with the appropriate data from the List control.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty isBindable="true"/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="mx.controls.listClasses:BaseListData"/><apiDefaultValue>null
      </apiDefaultValue></apiValueDef><apiDesc>
      When a component is used as a drop-in item renderer or drop-in
      item editor, Flex initializes the <codeph>listData</codeph> property
      of the component with the appropriate data from the List control.
      The component can then use the <codeph>listData</codeph> property
      to initialize the <codeph>data</codeph> property of the drop-in
      item renderer or drop-in item editor.
     
      <p>You do not set this property in MXML or ActionScript;
      Flex sets it when the component is used as a drop-in item renderer
      or drop-in item editor.</p>
     
      </apiDesc></apiValueDetail><related-links><link href="" invalidHref="mx.controls.listClasses.IDropInListItemRenderer.xml"><linktext>mx.controls.listClasses.IDropInListItemRenderer</linktext></link></related-links></apiValue><apiValue id="mx.controls:HTML:loaded:get"><apiName>loaded</apiName><shortdesc>
      A flag which indicates whether the JavaScript load event
      corresponding to the previous loading operation
      has been delivered to the HTML DOM in this control.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="read"/><apiType value="Boolean"/><apiDefaultValue>false
      
      </apiDefaultValue></apiValueDef><apiDesc>
      A flag which indicates whether the JavaScript <codeph>load</codeph> event
      corresponding to the previous loading operation
      has been delivered to the HTML DOM in this control.
     
      <p>This property is <codeph>true</codeph>
      before the <codeph>complete</codeph> event is dispatched.</p>
     
      <p>It is possible that this property
      never becomes <codeph>true</codeph>.
      This happens in the same cases
      in which the <codeph>complete</codeph> event is never dispatched.</p>
     
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:HTML:location:get"><apiName>location</apiName><shortdesc>
      The URL of an HTML page to be displayed by this control.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty isBindable="true"/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="String"/><apiDefaultValue>""
     
      </apiDefaultValue></apiValueDef><apiDesc>
      The URL of an HTML page to be displayed by this control.
     
      <p>Setting this property has the side effect of setting
      the <codeph>htmlText</codeph> property to <codeph>null</codeph>,
      and vice versa.</p>
     
      </apiDesc></apiValueDetail><related-links><link href="mx.controls.xml#HTML/htmlText"><linktext>htmlText</linktext></link></related-links></apiValue><apiValue id="mx.controls:HTML:paintsDefaultBackground:get"><apiName>paintsDefaultBackground</apiName><shortdesc>
      Whether this control's HTML content
      has a default opaque white background or not.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="Boolean"/><apiDefaultValue>false;
      
      </apiDefaultValue></apiValueDef><apiDesc>
      Whether this control's HTML content
      has a default opaque white background or not.
     
      <p>If this property is <codeph>false</codeph>,
      then the background specified for this Flex control, if any,
      appears behind the HTML content.</p>
     
      <p>However, if any HTML element has its own opaque background color
      (specified by style="background-color:gray", for instance),
      then that background appears behind that element.</p>
     
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:HTML:pdfCapability:get"><apiName>pdfCapability</apiName><shortdesc>
      The type of PDF support on the user's system,
      defined as an integer code value.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiStatic/><apiValueAccess value="read"/><apiType value="int"/></apiValueDef><apiDesc>
      The type of PDF support on the user's system,
      defined as an integer code value.
     
      <p>An HTML object can display PDF content only if this property
      evaluates to <codeph>PDFCapability.STATUS_OK</codeph>.
      The PDFCapability class defines constants for possible values
      of the <codeph>pdfCapability</codeph> property, as follows:</p>
     
      <adobetable class="innertable">
        
        
        
        
        
      <tgroup cols="2"><thead><row><entry>PDFCapability constant</entry><entry>Meaning</entry></row></thead><tbody><row>
         <entry><codeph>STATUS_OK</codeph></entry>
         <entry>A sufficient version (8.1 or later) of Acrobat Reader
             is detected and PDF content can be loaded in an HTML object.
           <p><i>Note:</i> On Windows, if a Acrobat Acrobat
             or Acrobat Reader version 7.x or above
           is currently running on the user's system,
             that version is used even if a later version
           that supports loading PDF loaded in an HTML object is installed.
             In this case, if the the value of the
             <codeph>pdfCampability</codeph> property is
           <codeph>PDFCapability.STATUS_OK</codeph>,
             when an AIR application attempts to load PDF content
          into an HTML object, the older version of Acrobat or Reader
             displays an alert, without an error message displayed the AIR runtime.
             If this is a possible situation for your end users,
             you may consider providing them with instructions to close Acrobat
          while running your application.
             You may consider displaying these instructions if the PDF
          content does not load within an acceptable timeframe.</p></entry>
        </row><row>
         <entry><codeph>ERROR_INSTALLED_READER_NOT_FOUND</codeph></entry>
         <entry>No version of Acrobat Reader is detected.
             An HTML object cannot display PDF content.</entry>
        </row><row>
         <entry><codeph>ERROR_INSTALLED_READER_TOO_OLD</codeph></entry>
         <entry>Acrobat Reader has been detected, but the version is too old.
             An HTML object cannot display PDF content.</entry>
        </row><row>
         <entry><codeph>ERROR_PREFERED_READER_TOO_OLD</codeph></entry>
         <entry>A sufficient version (8.1 or later) of Acrobat Reader is detected,
             but the the version of Acrobat Reader that is setup
             to handle PDF content is older than Reader 8.1.
             An HTML object cannot display PDF content.</entry>
        </row></tbody></tgroup></adobetable>
      
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:HTML:runtimeApplicationDomain:get"><apiName>runtimeApplicationDomain</apiName><shortdesc>
      The ApplicationDomain to use for HTML's window.runtime
      scripting.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="flash.system:ApplicationDomain"/><apiDefaultValue>null
      
      </apiDefaultValue></apiValueDef><apiDesc>
      The ApplicationDomain to use for HTML's <codeph>window.runtime</codeph>
      scripting.
     
      <p>If this property is <codeph>null</codeph>, or if it specifies
      an ApplicationDomain from a different security domain
      than the HTML content, the HTML page uses a default
      <codeph>ApplicationDomain</codeph> for the page's domain.</p>
     
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:HTML:userAgent:get"><apiName>userAgent</apiName><shortdesc>
      The user agent string to be used in content requests
      from this control.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="String"/><apiDefaultValue>null
     
      </apiDefaultValue></apiValueDef><apiDesc>
      The user agent string to be used in content requests
      from this control.
     
      <p>You can set the default user agent string used by all
      HTML controls in an application domain by setting the
      static <codeph>URLRequestDefaults.userAgent</codeph> property.
      If no value is set for the <codeph>userAgent</codeph> property
      (or if the value is set to <codeph>null</codeph>),
      the user agent string is set to the value of
      <codeph>URLRequestDefaults.userAgent</codeph>.</p>
     
      <p>If neither the <codeph>userAgent</codeph> property
      of this control nor for <codeph>URLRequestDefaults.userAgent</codeph>,
      has a value set, a default value is used as the user agent string.
      This default value varies depending on the runtime
      operating system (such as Mac OS or Windows),
      the runtime language, and the runtime version,
      as in the following two examples:</p>
     
      <pre>
      "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"
      </pre>
     
      </apiDesc></apiValueDetail><related-links><link href="" invalidHref="flash.net.xml#URLRequest/userAgent"><linktext>flash.net.URLRequest.userAgent</linktext></link><link href="" invalidHref="flash.net.xml#URLRequestDefaults/userAgent"><linktext>flash.net.URLRequestDefaults.userAgent</linktext></link></related-links></apiValue></apiClassifier><apiClassifier id="mx.controls:FlexNativeMenu"><apiName>FlexNativeMenu</apiName><shortdesc>
  The FlexNativeMenu component provides a wrapper for AIR's NativeMenu class.</shortdesc><prolog><asMetadata><apiVersion><apiPlatform description="" name="AIR" version="1.1"/></apiVersion></asMetadata><asCustoms><mxml><![CDATA[
  <p>The <code>&lt;mx:FlexNativeMenu&gt</code> tag supports the following tag attributes:</p>
 
  <pre>
  &lt;mx:FlexNativeMenu
    <b>Properties</b>
    dataDescriptor="<i>mx.controls.treeClasses.DefaultDataDescriptor</i>"
    dataProvider="<i>undefined</i>"
    keyEquivalentField="keyEquivalent"
    keyEquivalentFunction="<i>undefined</i>"
    keyEquivalentModifiersFunction="<i>undefined</i>"
    labelField="label"
    labelFunction="<i>undefined</i>"
    mnemonicIndexField="mnemonicIndex"
    mnemonicIndexFunction="<i>undefined</i>"
    showRoot="true"
 
    <b>Events</b>
    itemClick="<i>No default</i>"
    menuShow="<i>No default</i>"
  /&gt;
  </pre>
 
  ]]></mxml></asCustoms></prolog><apiClassifierDetail><apiClassifierDef><apiAccess value="public"/><apiStatic/><apiBaseInterface>mx.managers:ILayoutManagerClient</apiBaseInterface><apiBaseInterface>mx.controls:IFlexContextMenu</apiBaseInterface><apiBaseInterface>mx.automation:IAutomationObject</apiBaseInterface><apiBaseClassifier>flash.events:EventDispatcher</apiBaseClassifier></apiClassifierDef><apiDesc>
  The FlexNativeMenu component provides a wrapper for AIR's NativeMenu class. The FlexNativeMenu
  provides a way to define native operating system menus (such as window, application, and
  context menus) using techniques that are familiar to Flex developers and consistent with
  other Flex menu components, such as using MXML and data providers to specify menu structure.
  However, unlike Flex menu components, the menus that are defined by a FlexNativeMenu
  component are rendered by the host operating system as part of an AIR application, rather
  than being created as visual components by Flex.
 
  <p>Like other Flex menu components, to define the structure of a menu represented by a
  FlexNativeMenu component, you create a data provider such as an XML hierarchy or an array
  of objects containing data to be used to define the menu. Several properties can be set to
  define how the data provider data is interpreted, such as the <codeph>labelField</codeph> property
  to specify the data field that is used for the menu item label, the <codeph>keyEquivalentField</codeph>
  property to specify the field that defines a keyboard equivalent shortcut for the menu item,
  and the <codeph>mnemonicIndexField</codeph> property to specify the field that defines the index
  position of the character in the label that is used as the menu item's mnemonic.</p>
 
  <p>The data provider for FlexNativeMenu items can specify several attributes that determine how
  the item is displayed and behaves, as the following XML data provider shows:</p>
  <pre>
   &lt;mx:XML format="e4x" id="myMenuData"&gt;
     &lt;root&gt;
        &lt;menuitem label="MenuItem A"&gt;
            &lt;menuitem label="SubMenuItem A-1" enabled="False"/&gt;
            &lt;menuitem label="SubMenuItem A-2"/&gt;
        &lt;/menuitem&gt;
        &lt;menuitem label="MenuItem B" type="check" toggled="true"/&gt;
        &lt;menuitem label="MenuItem C" type="check" toggled="false"/&gt;
        &lt;menuitem type="separator"/&gt;
        &lt;menuitem label="MenuItem D"&gt;
            &lt;menuitem label="SubMenuItem D-1"/&gt;
            &lt;menuitem label="SubMenuItem D-2"/&gt;
            &lt;menuitem label="SubMenuItem D-3"/&gt;
        &lt;/menuitem&gt;
    &lt;/root&gt;
 &lt;/mx:XML&gt;</pre>
 
  <p>The following table lists the attributes you can specify,
  their data types, their purposes, and how the data provider must represent
  them if the menu uses the DefaultDataDescriptor class to parse the data provider:</p>
 
  <adobetable class="innertable">
  
  
  
  
  
  
  
  
  
  
  
  
  
 <tgroup cols="3"><thead><row><entry>Attribute</entry><entry>Type</entry><entry>Description</entry></row></thead><tbody><row>
    <entry><codeph>altKey</codeph></entry>
    <entry>Boolean</entry>
    <entry>Specifies whether the Alt key is required as part of the key equivalent for the item.</entry>
  </row><row>
    <entry><codeph>cmdKey</codeph></entry>
    <entry>Boolean</entry>
    <entry><b>Note:</b> this attribute is deprecated as of Flex 3.2. Use 
        <codeph>commandKey</codeph> instead. Specifies whether the Command key is required as part 
        of the key equivalent for the item.</entry>
  </row><row>
    <entry><codeph>commandKey</codeph></entry>
    <entry>Boolean</entry>
    <entry>Specifies whether the Command key is required as part of the key equivalent for the item.</entry>
  </row><row>
    <entry><codeph>controlKey</codeph></entry>
    <entry>Boolean</entry>
    <entry>Specifies whether the Control key is required as part of the key equivalent for the item.</entry>
  </row><row>
    <entry><codeph>ctrlKey</codeph></entry>
    <entry>Boolean</entry>
    <entry><b>Note:</b> this attribute is deprecated as of Flex 3.2. Use 
        <codeph>controlKey</codeph> instead. Specifies whether the Control key is required as part 
        of the key equivalent for the item.</entry>
  </row><row>
    <entry><codeph>enabled</codeph></entry>
    <entry>Boolean</entry>
    <entry>Specifies whether the user can select the menu item (<codeph>true</codeph>),
      or not (<codeph>false</codeph>). If not specified, Flex treats the item as if
      the value were <codeph>true</codeph>.
      If you use the default data descriptor, data providers must use an <codeph>enabled</codeph>
      XML attribute or object field to specify this characteristic.</entry>
  </row><row>
    <entry><codeph>keyEquivalent</codeph></entry>
    <entry>String</entry>
    <entry>Specifies a keyboard character which, when pressed, triggers an event as though
        the menu item was selected. The menu's <codeph>keyEquivalentField</codeph> or
        <codeph>keyEquivalentFunction</codeph> property determines the name of the field
        in the data that specifies the key equivalent, or a function for determining
        the key equivalents. (If the data provider is in E4X XML format, you must specify
        one of these properties to assign a key equivalent.)</entry>
  </row><row>
    <entry><codeph>label</codeph></entry>
    <entry>String</entry>
    <entry>Specifies the text that appears in the control. This item is used for all
      menu item types except <codeph>separator</codeph>.
      The menu's <codeph>labelField</codeph> or <codeph>labelFunction</codeph> property
      determines the name of the field in the data that specifies the label,
      or a function for determining the labels. (If the data provider is in E4X XML format,
      you must specify one of these properties to display a label.)
      If the data provider is an Array of Strings, Flex uses the String value as the label.</entry>
  </row><row>
    <entry><codeph>mnemonicIndex</codeph></entry>
    <entry>Integer</entry>
    <entry>Specifies the index position of the character in the label that is used as the
        mnemonic for the menu item. The menu's <codeph>mnemonicIndexField</codeph> or
        <codeph>mnemonicIndexFunction</codeph> property determines the name of the field
        in the data that specifies the mnemonic index, or a function for determining
        mnemonic index. (If the data provider is in E4X XML format, you must specify
        one of these properties to specify a mnemonic index in the data.) Alternatively,
        you can indicate that a character in the label is the menu item's mnemonic by
        including an underscore immediately to the left of that character.</entry>
  </row><row>
    <entry><codeph>shiftKey</codeph></entry>
    <entry>Boolean</entry>
    <entry>Specifies whether the Shift key is required as part of the key equivalent for the item.</entry>
  </row><row>
    <entry><codeph>toggled</codeph></entry>
    <entry>Boolean</entry>
    <entry>Specifies whether a check item is selected.
      If not specified, Flex treats the item as if the value were <codeph>false</codeph>
      and the item is not selected.
      If you use the default data descriptor, data providers must use a <codeph>toggled</codeph>
      XML attribute or object field to specify this characteristic.</entry>
  </row><row>
    <entry><codeph>type</codeph></entry>
    <entry>String</entry>
    <entry>Specifies the type of menu item. Meaningful values are <codeph>separator</codeph> and
      <codeph>check</codeph>. Flex treats all other values,
      or nodes with no type entry, as normal menu entries.
      If you use the default data descriptor, data providers must use a <codeph>type</codeph>
      XML attribute or object field to specify this characteristic.</entry>
  </row></tbody></tgroup></adobetable>
 
  <p>To create a window menu, set the FlexNativeMenu as the <codeph>menu</codeph> property of the
  Window or WindowedApplication instance on which the menu should appear. To create an application
  menu, assign the FlexNativeMenu as the <codeph>menu</codeph> property of the application's
  WindowedApplication. To assign a FlexNativeMenu as the context menu for a portion of the user interface,
  call the FlexNativeMenu instance's <codeph>setContextMenu()</codeph> method, passing the UI object
  as an argument. Call the FlexNativeMenu component's <codeph>display()</codeph> method to display the
  menu as a pop-up menu anywhere on one of the application's windows.</p>
 
  <p>To detect when menu items commands are triggered, register a listener for the <codeph>itemClick</codeph>
  event. You can also register a listener for the <codeph>menuShow</codeph> event to determine when
  any menu or submenu is opened.</p>
 
  </apiDesc></apiClassifierDetail><related-links><link href="" invalidHref="flash.display.NativeMenu.xml"><linktext>flash.display.NativeMenu</linktext></link><link href="mx.events.xml#FlexNativeMenuEvent"><linktext>mx.events.FlexNativeMenuEvent</linktext></link></related-links><adobeApiEvent id="mx.controls:FlexNativeMenu_mx.events.FlexNativeMenuEvent.ITEM_CLICK_itemClick"><apiName>itemClick</apiName><shortdesc>
  Dispatched when a menu item is selected.</shortdesc><prolog/><adobeApiEventDetail><adobeApiEventDef><apiEventType>mx.events.FlexNativeMenuEvent.ITEM_CLICK</apiEventType><adobeApiEventClassifier>mx.events.FlexNativeMenuEvent</adobeApiEventClassifier><apiGeneratedEvent/></adobeApiEventDef><apiDesc>
  Dispatched when a menu item is selected.
 
  </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="mx.controls:FlexNativeMenu_mx.events.FlexNativeMenuEvent.MENU_SHOW_menuShow"><apiName>menuShow</apiName><shortdesc>
  Dispatched before a menu or submenu is displayed.</shortdesc><prolog/><adobeApiEventDetail><adobeApiEventDef><apiEventType>mx.events.FlexNativeMenuEvent.MENU_SHOW</apiEventType><adobeApiEventClassifier>mx.events.FlexNativeMenuEvent</adobeApiEventClassifier><apiGeneratedEvent/></adobeApiEventDef><apiDesc>
  Dispatched before a menu or submenu is displayed.
 
  </apiDesc></adobeApiEventDetail></adobeApiEvent><apiConstructor id="mx.controls:FlexNativeMenu:FlexNativeMenu"><apiName>FlexNativeMenu</apiName><shortdesc>
      Constructor.</shortdesc><prolog/><apiConstructorDetail><apiConstructorDef><apiAccess value="public"/></apiConstructorDef><apiDesc>
      Constructor.
     </apiDesc></apiConstructorDetail></apiConstructor><apiOperation id="mx.controls:FlexNativeMenu:protected:commitProperties"><apiName>commitProperties</apiName><shortdesc>
      Processes the properties set on the component.</shortdesc><prolog/><apiOperationDetail><apiOperationDef><apiAccess value="protected"/><apiReturn><apiType value="void"/></apiReturn></apiOperationDef><apiDesc>
      Processes the properties set on the component.
     
      </apiDesc></apiOperationDetail><related-links><link href="" invalidHref="mx.core.xml#UIComponent/commitProperties()"><linktext>mx.core.UIComponent.commitProperties()</linktext></link></related-links></apiOperation><apiOperation id="mx.controls:FlexNativeMenu:createAutomationIDPartWithRequiredProperties"><apiName>createAutomationIDPartWithRequiredProperties</apiName><shortdesc>
      </shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="Flash" version="10"/><apiPlatform description="" name="AIR" version="1.5"/><apiTool name="Flex" version="4"/></apiVersion></asMetadata></prolog><apiOperationDetail><apiOperationDef><apiAccess value="public"/><apiReturn><apiType value="Object"/></apiReturn><apiParam><apiItemName>child</apiItemName><apiType value="mx.automation:IAutomationObject"/></apiParam><apiParam><apiItemName>properties</apiItemName><apiType value="Array"/></apiParam></apiOperationDef><apiDesc>
      </apiDesc></apiOperationDetail></apiOperation><apiOperation id="mx.controls:FlexNativeMenu:createAutomationIDPart"><apiName>createAutomationIDPart</apiName><shortdesc>
      </shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="Flash" version="9"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="4"/></apiVersion></asMetadata></prolog><apiOperationDetail><apiOperationDef><apiAccess value="public"/><apiReturn><apiType value="Object"/></apiReturn><apiParam><apiItemName>child</apiItemName><apiType value="mx.automation:IAutomationObject"/></apiParam></apiOperationDef><apiDesc>
      </apiDesc></apiOperationDetail></apiOperation><apiOperation id="mx.controls:FlexNativeMenu:display"><apiName>display</apiName><shortdesc>
      Pops up this menu at the specified location.</shortdesc><prolog/><apiOperationDetail><apiOperationDef><apiAccess value="public"/><apiReturn><apiType value="void"/></apiReturn><apiParam><apiItemName>stage</apiItemName><apiType value="flash.display:Stage"/><apiDesc>The Stage object on which to display this menu. 
     
      </apiDesc></apiParam><apiParam><apiItemName>x</apiItemName><apiType value="int"/><apiDesc>The number of horizontal pixels, relative to the origin of stage, 
      at which to display this menu. 
     
      </apiDesc></apiParam><apiParam><apiItemName>y</apiItemName><apiType value="int"/><apiDesc>The number of vertical pixels, relative to the origin of stage, 
      at which to display this menu. 
     </apiDesc></apiParam></apiOperationDef><apiDesc>
      Pops up this menu at the specified location. 
     
      </apiDesc></apiOperationDetail></apiOperation><apiOperation id="mx.controls:FlexNativeMenu:getAutomationChildAt"><apiName>getAutomationChildAt</apiName><shortdesc>
      </shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="Flash" version="9"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="4"/></apiVersion></asMetadata></prolog><apiOperationDetail><apiOperationDef><apiAccess value="public"/><apiReturn><apiType value="mx.automation:IAutomationObject"/></apiReturn><apiParam><apiItemName>index</apiItemName><apiType value="int"/></apiParam></apiOperationDef><apiDesc>
      </apiDesc></apiOperationDetail></apiOperation><apiOperation id="mx.controls:FlexNativeMenu:getAutomationChildren"><apiName>getAutomationChildren</apiName><shortdesc>
      </shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="Flash" version="10"/><apiPlatform description="" name="AIR" version="1.5"/><apiTool name="Flex" version="4"/></apiVersion></asMetadata></prolog><apiOperationDetail><apiOperationDef><apiAccess value="public"/><apiReturn><apiType value="Array"/></apiReturn></apiOperationDef><apiDesc>
      </apiDesc></apiOperationDetail></apiOperation><apiOperation id="mx.controls:FlexNativeMenu:invalidateProperties"><apiName>invalidateProperties</apiName><shortdesc conref="mx.core.UIComponent#invalidateProperties()">
      </shortdesc><prolog/><apiOperationDetail><apiOperationDef><apiAccess value="public"/><apiReturn><apiType value="void"/></apiReturn></apiOperationDef><apiDesc conref="mx.core.UIComponent#invalidateProperties()">
      </apiDesc></apiOperationDetail></apiOperation><apiOperation id="mx.controls:FlexNativeMenu:protected:itemToKeyEquivalentModifiers"><apiName>itemToKeyEquivalentModifiers</apiName><shortdesc>
      Returns the key equivalent modifiers for the given data object
      based on the keyEquivalentModifiersFunction property.</shortdesc><prolog/><apiOperationDetail><apiOperationDef><apiAccess value="protected"/><apiReturn><apiDesc>The array of key equivalent modifiers based on the data
     </apiDesc><apiType value="Array"/></apiReturn><apiParam><apiItemName>data</apiItemName><apiType value="Object"/><apiDesc>Object to be displayed.
     
      </apiDesc></apiParam></apiOperationDef><apiDesc>
      Returns the key equivalent modifiers for the given data object
      based on the <codeph>keyEquivalentModifiersFunction</codeph> property.
      If the method cannot convert the parameter to an Array of modifiers,
      it returns an empty Array.
     
      </apiDesc></apiOperationDetail></apiOperation><apiOperation id="mx.controls:FlexNativeMenu:protected:itemToKeyEquivalent"><apiName>itemToKeyEquivalent</apiName><shortdesc>
      Returns the key equivalent for the given data object
      based on the keyEquivalentField and keyEquivalentFunction
      properties.</shortdesc><prolog/><apiOperationDetail><apiOperationDef><apiAccess value="protected"/><apiReturn><apiDesc>The key equivalent based on the data.
     </apiDesc><apiType value="String"/></apiReturn><apiParam><apiItemName>data</apiItemName><apiType value="Object"/><apiDesc>Object to be displayed.
     
      </apiDesc></apiParam></apiOperationDef><apiDesc>
      Returns the key equivalent for the given data object
      based on the <codeph>keyEquivalentField</codeph> and <codeph>keyEquivalentFunction</codeph>
      properties. If the method cannot convert the parameter to a String, it returns an
      empty string.
     
      </apiDesc></apiOperationDetail></apiOperation><apiOperation id="mx.controls:FlexNativeMenu:protected:itemToLabel"><apiName>itemToLabel</apiName><shortdesc>
      Returns the String to use as the menu item label for the given data
      object, based on the labelField and labelFunction
      properties.</shortdesc><prolog/><apiOperationDetail><apiOperationDef><apiAccess value="protected"/><apiReturn><apiDesc>The string to be displayed based on the data.
     </apiDesc><apiType value="String"/></apiReturn><apiParam><apiItemName>data</apiItemName><apiType value="Object"/><apiDesc>Object to be displayed.
     
      </apiDesc></apiParam></apiOperationDef><apiDesc>
      Returns the String to use as the menu item label for the given data
      object, based on the <codeph>labelField</codeph> and <codeph>labelFunction</codeph>
      properties.
      If the method cannot convert the parameter to a String, it returns a
      single space.
     
      </apiDesc></apiOperationDetail></apiOperation><apiOperation id="mx.controls:FlexNativeMenu:protected:itemToMnemonicIndex"><apiName>itemToMnemonicIndex</apiName><shortdesc>
      Returns the mnemonic index for the given data object
      based on the mnemonicIndexField and mnemonicIndexFunction
      properties.</shortdesc><prolog/><apiOperationDetail><apiOperationDef><apiAccess value="protected"/><apiReturn><apiDesc>The mnemonic index based on the data.
     </apiDesc><apiType value="int"/></apiReturn><apiParam><apiItemName>data</apiItemName><apiType value="Object"/><apiDesc>Object to be displayed.
     
      </apiDesc></apiParam></apiOperationDef><apiDesc>
      Returns the mnemonic index for the given data object
      based on the <codeph>mnemonicIndexField</codeph> and <codeph>mnemonicIndexFunction</codeph>
      properties. If the method cannot convert the parameter to an integer, it returns -1.
     
      </apiDesc></apiOperationDetail></apiOperation><apiOperation id="mx.controls:FlexNativeMenu:protected:parseLabelToMnemonicIndex"><apiName>parseLabelToMnemonicIndex</apiName><shortdesc>
      Extracts the mnemonic index from a label based on the presence of
      an underscore character.</shortdesc><prolog/><apiOperationDetail><apiOperationDef><apiAccess value="protected"/><apiReturn><apiType value="int"/></apiReturn><apiParam><apiItemName>data</apiItemName><apiType value="String"/></apiParam></apiOperationDef><apiDesc>
      Extracts the mnemonic index from a label based on the presence of
      an underscore character. It finds the leading underscore character if
      there is one and uses that as the index.
     </apiDesc></apiOperationDetail></apiOperation><apiOperation id="mx.controls:FlexNativeMenu:protected:parseLabelToString"><apiName>parseLabelToString</apiName><shortdesc>
      Determines the actual label to be used for the NativeMenuItem
      by removing underscore characters and converting escaped underscore
      characters, if there are any.</shortdesc><prolog/><apiOperationDetail><apiOperationDef><apiAccess value="protected"/><apiReturn><apiType value="String"/></apiReturn><apiParam><apiItemName>data</apiItemName><apiType value="String"/></apiParam></apiOperationDef><apiDesc>
      Determines the actual label to be used for the NativeMenuItem
      by removing underscore characters and converting escaped underscore
      characters, if there are any.
     </apiDesc></apiOperationDetail></apiOperation><apiOperation id="mx.controls:FlexNativeMenu:replayAutomatableEvent"><apiName>replayAutomatableEvent</apiName><shortdesc>
      </shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="Flash" version="9"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="4"/></apiVersion></asMetadata></prolog><apiOperationDetail><apiOperationDef><apiAccess value="public"/><apiReturn><apiType value="Boolean"/></apiReturn><apiParam><apiItemName>event</apiItemName><apiType value="flash.events:Event"/></apiParam></apiOperationDef><apiDesc>
      </apiDesc></apiOperationDetail></apiOperation><apiOperation id="mx.controls:FlexNativeMenu:resolveAutomationIDPart"><apiName>resolveAutomationIDPart</apiName><shortdesc>
      </shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="Flash" version="9"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="4"/></apiVersion></asMetadata></prolog><apiOperationDetail><apiOperationDef><apiAccess value="public"/><apiReturn><apiType value="Array"/></apiReturn><apiParam><apiItemName>criteria</apiItemName><apiType value="Object"/></apiParam></apiOperationDef><apiDesc>
      </apiDesc></apiOperationDetail></apiOperation><apiOperation id="mx.controls:FlexNativeMenu:setContextMenu"><apiName>setContextMenu</apiName><shortdesc>
      Sets the context menu of the InteractiveObject to the underlying native menu.</shortdesc><prolog/><apiOperationDetail><apiOperationDef><apiAccess value="public"/><apiReturn><apiType value="void"/></apiReturn><apiParam><apiItemName>component</apiItemName><apiType value="flash.display:InteractiveObject"/></apiParam></apiOperationDef><apiDesc>
      Sets the context menu of the InteractiveObject to the underlying native menu.
     </apiDesc></apiOperationDetail></apiOperation><apiOperation id="mx.controls:FlexNativeMenu:unsetContextMenu"><apiName>unsetContextMenu</apiName><shortdesc>
      Unsets the context menu of the InteractiveObject that has been set to
      the underlying native menu.</shortdesc><prolog/><apiOperationDetail><apiOperationDef><apiAccess value="public"/><apiReturn><apiType value="void"/></apiReturn><apiParam><apiItemName>component</apiItemName><apiType value="flash.display:InteractiveObject"/></apiParam></apiOperationDef><apiDesc>
      Unsets the context menu of the InteractiveObject that has been set to
      the underlying native menu.
     </apiDesc></apiOperationDetail></apiOperation><apiOperation id="mx.controls:FlexNativeMenu:validateDisplayList"><apiName>validateDisplayList</apiName><shortdesc>
      </shortdesc><prolog/><apiOperationDetail><apiOperationDef><apiAccess value="public"/><apiReturn><apiType value="void"/></apiReturn></apiOperationDef><apiDesc>
      </apiDesc></apiOperationDetail></apiOperation><apiOperation id="mx.controls:FlexNativeMenu:validateNow"><apiName>validateNow</apiName><shortdesc>
      Validates and updates the properties and layout of this object
      and redraws it, if necessary.</shortdesc><prolog/><apiOperationDetail><apiOperationDef><apiAccess value="public"/><apiReturn><apiType value="void"/></apiReturn></apiOperationDef><apiDesc>
      Validates and updates the properties and layout of this object
      and redraws it, if necessary.
     </apiDesc></apiOperationDetail></apiOperation><apiOperation id="mx.controls:FlexNativeMenu:validateProperties"><apiName>validateProperties</apiName><shortdesc>
      </shortdesc><prolog/><apiOperationDetail><apiOperationDef><apiAccess value="public"/><apiReturn><apiType value="void"/></apiReturn></apiOperationDef><apiDesc>
      </apiDesc></apiOperationDetail></apiOperation><apiOperation id="mx.controls:FlexNativeMenu:validateSize"><apiName>validateSize</apiName><shortdesc>
      </shortdesc><prolog/><apiOperationDetail><apiOperationDef><apiAccess value="public"/><apiReturn><apiType value="void"/></apiReturn><apiParam><apiItemName>recursive</apiItemName><apiType value="Boolean"/><apiData>false</apiData></apiParam></apiOperationDef><apiDesc>
      </apiDesc></apiOperationDetail></apiOperation><apiValue id="mx.controls:FlexNativeMenu:automationDelegate:get"><apiName>automationDelegate</apiName><shortdesc>
      The delegate object that handles the automation-related functionality.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="Flash" version="9"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="4"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="Object"/></apiValueDef><apiDesc>
      The delegate object that handles the automation-related functionality.
      
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FlexNativeMenu:automationEnabled:get"><apiName>automationEnabled</apiName><shortdesc>
      </shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="Flash" version="9"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="4"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="read"/><apiType value="Boolean"/></apiValueDef><apiDesc>
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FlexNativeMenu:automationName:get"><apiName>automationName</apiName><shortdesc>
      </shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="Flash" version="9"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="4"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="String"/></apiValueDef><apiDesc>
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FlexNativeMenu:automationOwner:get"><apiName>automationOwner</apiName><shortdesc>
      </shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="Flash" version="9"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="4"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="flash.display:DisplayObjectContainer"/></apiValueDef><apiDesc>
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FlexNativeMenu:automationParent:get"><apiName>automationParent</apiName><shortdesc>
      </shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="Flash" version="9"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="4"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="flash.display:DisplayObjectContainer"/></apiValueDef><apiDesc>
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FlexNativeMenu:automationTabularData:get"><apiName>automationTabularData</apiName><shortdesc>
      </shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="Flash" version="9"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="4"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="read"/><apiType value="Object"/></apiValueDef><apiDesc>
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FlexNativeMenu:automationValue:get"><apiName>automationValue</apiName><shortdesc conref="mx.automation.IAutomationObject#automationValue">
      </shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="Flash" version="9"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="4"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="read"/><apiType value="Array"/></apiValueDef><apiDesc conref="mx.automation.IAutomationObject#automationValue">
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FlexNativeMenu:automationVisible:get"><apiName>automationVisible</apiName><shortdesc>
      </shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="Flash" version="9"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="4"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="read"/><apiType value="Boolean"/></apiValueDef><apiDesc>
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FlexNativeMenu:dataDescriptor:get"><apiName>dataDescriptor</apiName><shortdesc>
      The object that accesses and manipulates data in the data provider.</shortdesc><prolog/><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="mx.controls.menuClasses:IMenuDataDescriptor"/></apiValueDef><apiDesc>
      The object that accesses and manipulates data in the data provider.
      The FlexNativeMenu control delegates to the data descriptor for information
      about its data. This data is then used to parse and move about the
      data source. The data descriptor defined for the FlexNativeMenu is used for
      all child menus and submenus.
     
      <p>When you specify this property as an attribute in MXML, you must
      use a reference to the data descriptor, not the string name of the
      descriptor. Use the following format for setting the property:</p>
     
     <pre>&lt;mx:FlexNativeMenu id="flexNativeMenu" dataDescriptor="{new MyCustomDataDescriptor()}"/&gt;</pre>
     
      <p>Alternatively, you can specify the property in MXML as a nested
      subtag, as the following example shows:</p>
     
      <pre>&lt;mx:FlexNativeMenu&gt;
      &lt;mx:dataDescriptor&gt;
         &lt;myCustomDataDescriptor&gt;
      &lt;/mx:dataDescriptor&gt;
      ...</pre>
     
      <p>The default value is an internal instance of the
      DefaultDataDescriptor class.</p>
     </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FlexNativeMenu:dataProvider:get"><apiName>dataProvider</apiName><shortdesc>
      The hierarchy of objects that are used to define the structure
      of menu items in the NativeMenu.</shortdesc><prolog/><apiValueDetail><apiValueDef><apiProperty isBindable="true"/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="Object"/><apiDefaultValue>"undefined"
     </apiDefaultValue></apiValueDef><apiDesc>
      The hierarchy of objects that are used to define the structure
      of menu items in the NativeMenu. Individual data objects define
      menu items, and items with child items become menus and submenus.
     
      <p>The FlexNativeMenu control handles the source data object as follows:</p>
     
      <ul>
        <li>A String containing valid XML text is converted to an XML object.</li>
        <li>An XMLNode is converted to an XML object.</li>
        <li>An XMLList is converted to an XMLListCollection.</li>
        <li>Any object that implements the ICollectionView interface is cast to
            an ICollectionView.</li>
        <li>An Array is converted to an ArrayCollection.</li>
        <li>Any other type object is wrapped in an Array with the object as its sole
            entry.</li>
      </ul>
     
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FlexNativeMenu:hasRoot:get"><apiName>hasRoot</apiName><shortdesc conref="mx.controls.Menu#hasRoot">
      </shortdesc><prolog/><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="read"/><apiType value="Boolean"/></apiValueDef><apiDesc conref="mx.controls.Menu#hasRoot">
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FlexNativeMenu:initialized:get"><apiName>initialized</apiName><shortdesc conref="mx.core.UIComponent#initialized">
      </shortdesc><prolog/><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="Boolean"/></apiValueDef><apiDesc conref="mx.core.UIComponent#initialized">
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FlexNativeMenu:keyEquivalentField:get"><apiName>keyEquivalentField</apiName><shortdesc>
      The name of the field in the data provider that determines the
      key equivalent for each menu item.</shortdesc><prolog/><apiValueDetail><apiValueDef><apiProperty isBindable="true"/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="String"/><apiDefaultValue>"keyEquivalent"
      </apiDefaultValue></apiValueDef><apiDesc>
      The name of the field in the data provider that determines the
      key equivalent for each menu item.  The set of values is defined
      in the Keyboard class, in the <codeph>KEYNAME_XXXX</codeph> constants. For example,
      consult that list for the value for a control character such as Home, Insert, etc.
     
      <p>Setting the <codeph>keyEquivalentFunction</codeph> property causes this property to be ignored.</p>
     
      </apiDesc></apiValueDetail><related-links><link href="" invalidHref="flash.ui.Keyboard.xml"><linktext>flash.ui.Keyboard</linktext></link></related-links></apiValue><apiValue id="mx.controls:FlexNativeMenu:keyEquivalentFunction:get"><apiName>keyEquivalentFunction</apiName><shortdesc>
      The function that determines the key equivalent for each menu item.</shortdesc><prolog/><apiValueDetail><apiValueDef><apiProperty isBindable="true"/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="Function"/><apiDefaultValue>"undefined"
      </apiDefaultValue></apiValueDef><apiDesc>
      The function that determines the key equivalent for each menu item.
      If you omit this property, Flex uses the contents of the field or
      attribute specified by the <codeph>keyEquivalentField</codeph> property.
      If you specify this property, Flex ignores any <codeph>keyEquivalentField</codeph>
      property value.
     
      <p>The <codeph>keyEquivalentFunction</codeph> property is good for handling formatting,
      localization, and platform independence.</p>
     
      <p>The key equivalent function must take a single argument, which is the item
      in the data provider, and must return a String.</p>
     
      <pre><codeph>myKeyEquivalentFunction(item:Object):String</codeph></pre>
     
      </apiDesc></apiValueDetail><related-links><link href="" invalidHref="flash.ui.Keyboard.xml"><linktext>flash.ui.Keyboard</linktext></link></related-links></apiValue><apiValue id="mx.controls:FlexNativeMenu:keyEquivalentModifiersFunction:get"><apiName>keyEquivalentModifiersFunction</apiName><shortdesc>
      The function that determines the key equivalent modifiers for each menu item.</shortdesc><prolog/><apiValueDetail><apiValueDef><apiProperty isBindable="true"/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="Function"/><apiDefaultValue>"undefined"
     </apiDefaultValue></apiValueDef><apiDesc>
      The function that determines the key equivalent modifiers for each menu item.
     
      If you omit this property, Flex uses its own default function to determine the
      Array of modifiers by looking in the data provider data for the presence of
      the following (boolean) fields: <codeph>altKey</codeph>, <codeph>commandKey</codeph>,
      <codeph>controlKey</codeph>, and <codeph>shiftKey</codeph>.
     
      <p>The <codeph>keyEquivalentModifiersFunction</codeph> property is good for handling
      formatting, localization, and platform independence.</p>
     
      <p>The key equivalent modifiers function must take a single argument, which
      is the item in the data provider, and must return an array of modifier key names.</p>
     
      <pre><codeph>myKeyEquivalentModifiersFunction(item:Object):Array</codeph></pre>
     
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FlexNativeMenu:labelField:get"><apiName>labelField</apiName><shortdesc>
      The name of the field in the data provider that determines the
      text to display for each menu item.</shortdesc><prolog/><apiValueDetail><apiValueDef><apiProperty isBindable="true"/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="String"/><apiDefaultValue>"label"
     </apiDefaultValue></apiValueDef><apiDesc>
      The name of the field in the data provider that determines the
      text to display for each menu item. If the data provider is an Array of
      Strings, Flex uses each string value as the label. If the data
      provider is an E4X XML object, you must set this property explicitly.
      For example, if each XML elementin an E4X XML Object includes a "label"
      attribute containing the text to display for each menu item, set
      the labelField to <codeph>"@label"</codeph>.
     
      <p>In a label, you can specify the character to be used as the mnemonic index
      by preceding it with an underscore. For example, a label value of <codeph>"C_ut"</codeph>
      sets the mnemonic index to 1. Only the first underscore present is used for this
      purpose.  To display a literal underscore character in the label, you can escape it
      using a double underscore. For example, a label value of <codeph>"C__u_t"</codeph> would
      result in a menu item with the label "C_ut" and a mnemonic index of 3 (the "t"
      character). If the field defined in the <codeph>mnemonicIndexField</codeph> property
      is present and set to a value greater than zero, that value takes precedence over
      any underscore-specified mnemonic index value.</p>
     
      <p>Setting the <codeph>labelFunction</codeph> property causes this property to be ignored.</p>
     
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FlexNativeMenu:labelFunction:get"><apiName>labelFunction</apiName><shortdesc>
      The function that determines the text to display for each menu item.</shortdesc><prolog/><apiValueDetail><apiValueDef><apiProperty isBindable="true"/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="Function"/><apiDefaultValue>"undefined"
     </apiDefaultValue></apiValueDef><apiDesc>
      The function that determines the text to display for each menu item.
      The label function must find the appropriate field or fields in the
      data provider and return a displayable string.
     
      <p>If you omit this property, Flex uses the contents of the field or
      attribute specified by the <codeph>labelField</codeph> property.
      If you specify this property, Flex ignores any <codeph>labelField</codeph>
      property value.</p>
     
      <p>The <codeph>labelFunction</codeph> property can be helpful for handling formatting,
      localization, and platform-independence.</p>
     
      <p>The label function must take a single argument, which is the item
      in the data provider, and must return a String.</p>
     
      <pre><codeph>myLabelFunction(item:Object):String</codeph></pre>
     
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FlexNativeMenu:mnemonicIndexField:get"><apiName>mnemonicIndexField</apiName><shortdesc>
      The name of the field in the data provider that determines the
      mnemonic index for each menu item.</shortdesc><prolog/><apiValueDetail><apiValueDef><apiProperty isBindable="true"/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="String"/><apiDefaultValue>"mnemonicIndex"
     
      </apiDefaultValue></apiValueDef><apiDesc>
      The name of the field in the data provider that determines the
      mnemonic index for each menu item.
     
      <p>If the field specified by this property contains a number greater
      than zero, that mnemonic index
      takes precedence over one specified by an underscore in the label.</p>
     
      <p>Setting the <codeph>mnemonicIndexFunction</codeph> property causes
      this property to be ignored.</p>
     
      </apiDesc></apiValueDetail><related-links><link href="mx.controls.xml#FlexNativeMenu/labelField"><linktext>labelField</linktext></link></related-links></apiValue><apiValue id="mx.controls:FlexNativeMenu:mnemonicIndexFunction:get"><apiName>mnemonicIndexFunction</apiName><shortdesc>
      The function that determines the mnemonic index for each menu item.</shortdesc><prolog/><apiValueDetail><apiValueDef><apiProperty isBindable="true"/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="Function"/><apiDefaultValue>"undefined"
     </apiDefaultValue></apiValueDef><apiDesc>
      The function that determines the mnemonic index for each menu item.
     
      <p>If you omit this property, Flex uses the contents of the field or
      attribute specified by the <codeph>mnemonicIndexField</codeph> property.
      If you specify this property, Flex ignores any <codeph>mnemonicIndexField</codeph>
      property value.</p>
     
      <p>If this property is defined and the function returns a number greater than
      zero for a data item, the returned mnemonic index
      takes precedence over one specified by an underscore in the label.</p>
     
      <p>The <codeph>mnemonicIndexFunction</codeph> property is good for handling formatting,
      localization, and platform independence.</p>
     
      <p>The mnemonic index function must take a single argument which is the item
      in the data provider and return an int.</p>
     
      <pre><codeph>myMnemonicIndexFunction(item:Object):int</codeph></pre>
     
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FlexNativeMenu:nativeMenu:get"><apiName>nativeMenu</apiName><shortdesc>
       Returns the flash.display.NativeMenu managed by this object,
       or null if there is not one.</shortdesc><prolog/><apiValueDetail><apiValueDef><apiProperty isBindable="true"/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="read"/><apiType value="flash.display:NativeMenu"/></apiValueDef><apiDesc>
       Returns the flash.display.NativeMenu managed by this object,
       or null if there is not one.
      
       Any changes made directly to the underlying NativeMenu instance
       may be lost when changes are made to the menu or the underlying
       data provider.
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FlexNativeMenu:nestLevel:get"><apiName>nestLevel</apiName><shortdesc conref="mx.core.UIComponent#nestLevel">
      </shortdesc><prolog/><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="int"/></apiValueDef><apiDesc conref="mx.core.UIComponent#nestLevel">
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FlexNativeMenu:numAutomationChildren:get"><apiName>numAutomationChildren</apiName><shortdesc>
      </shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="Flash" version="9"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="4"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="read"/><apiType value="int"/></apiValueDef><apiDesc>
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FlexNativeMenu:processedDescriptors:get"><apiName>processedDescriptors</apiName><shortdesc conref="mx.core.UIComponent#processedDescriptors">
      </shortdesc><prolog/><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="Boolean"/></apiValueDef><apiDesc conref="mx.core.UIComponent#processedDescriptors">
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FlexNativeMenu:showInAutomationHierarchy:get"><apiName>showInAutomationHierarchy</apiName><shortdesc>
      </shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="Flash" version="9"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="4"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="Boolean"/></apiValueDef><apiDesc>
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FlexNativeMenu:showRoot:get"><apiName>showRoot</apiName><shortdesc>
      A Boolean flag that specifies whether to display the data provider's
      root node.</shortdesc><prolog/><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="Boolean"/><apiDefaultValue>true
      </apiDefaultValue></apiValueDef><apiDesc>
      A Boolean flag that specifies whether to display the data provider's
      root node.
     
      <p>If the data provider has a root node, and the <codeph>showRoot</codeph> property
      is set to <codeph>false</codeph>, the top-level menu items displayed by the
      FlexNativeMenu control correspond to the immediate descendants of the root node.</p>
     
      <p>This flag has no effect when using a data provider without a root nodes,
      such as a List or Array.</p>
     
      </apiDesc></apiValueDetail><related-links><link href="mx.controls.xml#FlexNativeMenu/hasRoot"><linktext>hasRoot</linktext></link></related-links></apiValue><apiValue id="mx.controls:FlexNativeMenu:updateCompletePendingFlag:get"><apiName>updateCompletePendingFlag</apiName><shortdesc>
      A flag that determines if an object has been through all three phases
      of layout validation (provided that any were required).</shortdesc><prolog/><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="Boolean"/></apiValueDef><apiDesc>
      A flag that determines if an object has been through all three phases
      of layout validation (provided that any were required).
     </apiDesc></apiValueDetail></apiValue></apiClassifier><apiClassifier id="mx.controls:FileSystemHistoryButton"><apiName>FileSystemHistoryButton</apiName><shortdesc>
  The FileSystemHistoryButton control defines a single control
  with two buttons: a main button on the left
  and a secondary button on the right.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata><asCustoms><mxml><![CDATA[
 
  <p>The <code>&lt;mx:FileSystemHistoryButton&gt;</code> tag inherits all of the tag
  attributes of its superclass and adds the following tag attributes:</p>
 
  <pre>
  &lt;mx:FileSystemHistoryButton
    <strong>Properties</strong>
    dataProvider="<i>undefined</i>"
 
    <strong>Events</strong>
    itemClick="<i>No default</i>"
  /&gt;
  </pre>
 
  ]]></mxml></asCustoms></prolog><apiClassifierDetail><apiClassifierDef><apiAccess value="public"/><apiStatic/><apiBaseClassifier>mx.controls:PopUpButton</apiBaseClassifier></apiClassifierDef><apiDesc>
  The FileSystemHistoryButton control defines a single control
  with two buttons: a main button on the left
  and a secondary button on the right.
 
  <p>The main button can have a text label, an icon, or both on its face.
  When a user clicks the main button,
  the control dispatches a <codeph>click</codeph> event.</p>
 
  <p>Clicking on the secondary (right) button drops down a menu
  populated through the <codeph>dataProvider</codeph> property.
  When a user selects an item from the drop-down menu,
  the control dispatches an <codeph>itemClick</codeph> event.</p>
 
  <p>Typically, you use two FileSystemHistoryButtons
  with a FileSystemList or FileSystemDataGrid
  to implement a "Back" or "Forward" control
  which lets the user move backward or forward
  through the navigation history
  of the FileSystemList or FileSystemDataGrid.
  To populate the <codeph>dataProvider</codeph> property
  of a FileSystemHistoryButton control,
  use data binding to set its <codeph>dataProvider</codeph> property
  to either the <codeph>backHistory</codeph>
  or the <codeph>forwardHistory</codeph> property
  of the FileSystemList or FileSystemDataGrid control.
  To enable or disable it, bind its <codeph>enabled</codeph> property
  to either the <codeph>canNavigateBack</codeph>
  or the <codeph>canNavigateForward</codeph> property
  of the FileSystemList or FileSystemDataGrid control.
  If you use data binding to set these properties,
  Flex automatically updates them as the user navigates
  within the the FileSystemList or FileSystemDataGrid control.</p>
 
  <p>The button does not cause navigation to occur by itself. You must write
  event listeners that respond to the <codeph>click</codeph> and <codeph>itemClick</codeph> events
  in order to make the button functional. Typically your code
  calls either the <codeph>navigateBack()</codeph>
  or the <codeph>navigateForward()</codeph> method of the FileSystemList
  or FileSystemDataGrid control to navigate the control.
  For a <codeph>click</codeph> event, you do not need to pass an argument
  to these methods.
  For an <codeph>itemClick</codeph> event, pass <codeph>event.index</codeph>.</p>
 
  </apiDesc></apiClassifierDetail><related-links><link href="mx.controls.xml#FileSystemList"><linktext>mx.controls.FileSystemList</linktext></link><link href="mx.controls.xml#FileSystemDataGrid"><linktext>mx.controls.FileSystemDataGrid</linktext></link></related-links><adobeApiEvent id="mx.controls:FileSystemHistoryButton_mx.events.MenuEvent.ITEM_CLICK_itemClick"><apiName>itemClick</apiName><shortdesc>
  Dispatched when a user selects an item from the pop-up menu.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><adobeApiEventDetail><adobeApiEventDef><apiEventType>mx.events.MenuEvent.ITEM_CLICK</apiEventType><adobeApiEventClassifier>mx.events.MenuEvent</adobeApiEventClassifier><apiGeneratedEvent/></adobeApiEventDef><apiDesc>
  Dispatched when a user selects an item from the pop-up menu.
 
  </apiDesc></adobeApiEventDetail></adobeApiEvent><apiConstructor id="mx.controls:FileSystemHistoryButton:FileSystemHistoryButton"><apiName>FileSystemHistoryButton</apiName><shortdesc>
      Constructor.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiConstructorDetail><apiConstructorDef><apiAccess value="public"/></apiConstructorDef><apiDesc>
      Constructor.
      
      </apiDesc></apiConstructorDetail></apiConstructor><apiValue id="mx.controls:FileSystemHistoryButton:dataProvider:get"><apiName>dataProvider</apiName><shortdesc>
      The data provider for the FileSystemHistoryButton control.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="Object"/></apiValueDef><apiDesc>
      The data provider for the FileSystemHistoryButton control. This should
      be a collection of File objects containing directory locations -- commonly
      the <codeph>backHistory</codeph> or <codeph>forwardHistory</codeph> property of
      a FileSystemList or FileSystemDataGrid control.
      
      </apiDesc></apiValueDetail></apiValue></apiClassifier><apiClassifier id="mx.controls:FileSystemComboBox"><apiName>FileSystemComboBox</apiName><shortdesc>
  The FileSystemComboBox control defines a combo box control for
  navigating up the chain of ancestor directories from a specified
  directory in a file system.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion><Exclude kind="style" name="editableUpSkin"/><Exclude kind="style" name="editableOverSkin"/><Exclude kind="style" name="editableDownSkin"/><Exclude kind="style" name="editableDisabledSkin"/><Exclude kind="property" name="editable"/><styles><style format="EmbeddedFile" inherit="no" name="directoryIcon" owner="mx.controls:FileSystemComboBox" playerVersion="AIR1.1" type="Class">
<description>
  Specifies the icon that indicates a directory.
  The default icon is located in the Assets.swf file.
  In MXML, you can use the following syntax to set this property:
  <codeph>directoryIcon="@Embed(source='directoryIcon.jpg');"</codeph>
 
  </description>
<default>TreeNodeIcon
  
  </default>

	<prolog><asCustoms><langversion>3.0
  </langversion><productversion>Flex 3
 </productversion></asCustoms></prolog></style><style format="EmbeddedFile" inherit="no" name="computerIcon" owner="mx.controls:FileSystemComboBox" playerVersion="AIR1.1" type="Class">
<description>
  Specifies the icon that indicates
  the root directories of the computer.
  There is no default icon.
  In MXML, you can use the following syntax to set this property:
  <codeph>computerIcon="@Embed(source='computerIcon.jpg');"</codeph>
 
  </description>
<default>null
  
  </default>

	<prolog><asCustoms><langversion>3.0
  </langversion><productversion>Flex 3
 </productversion></asCustoms></prolog></style></styles><DefaultProperty name="dataProvider"/></asMetadata><asCustoms><mxml><![CDATA[
 
  <p>The <code>&lt;mx:FileSystemComboBox&gt;</code> tag inherits all of the tag
  attributes of its superclass and adds the following tag attributes:</p>
 
  <pre>
  &lt;mx:FileSystemComboBox
    <strong>Properties</strong>
    directory="<i>null</i>"
    indent="8"
    showIcons="true"
 
    <strong>Styles</strong>
    computerIcon="<i>null</i>"
    directoryIcon="<i>TreeNodeIcon</i>"
 
    <strong>Events</strong>
    directoryChange="<i>No default</i>"
  /&gt;
  </pre>
 
  ]]></mxml></asCustoms></prolog><apiClassifierDetail><apiClassifierDef><apiAccess value="public"/><apiStatic/><apiBaseClassifier>mx.controls:ComboBox</apiBaseClassifier></apiClassifierDef><apiDesc>
  The FileSystemComboBox control defines a combo box control for
  navigating up the chain of ancestor directories from a specified
  directory in a file system.
  You often use this control with the FileSystemList and FileSystemTree
  controls to change the current directory displayed by those controls.
 
  <p>Unlike the standard ComboBox control, to populate the FileSystemComboBox control's
  <codeph>dataProvider</codeph> property,
  you set the <codeph>directory</codeph> property.
  This control then automatically sets the <codeph>dataProvider</codeph>
  property to an ArrayCollection of File objects
  that includes all the ancestor directories of the specified directory,
  starting with the <codeph>COMPUTER</codeph> File
  and ending with the specified directory.</p>
 
  <p>When you select an entry in the dropdown list,
  this control dispatches a <codeph>change</codeph> event.
  After the event is dispatched data provider, and consequently the dropdown list,
  contain the selected directory's ancestors.</p>
 
  </apiDesc></apiClassifierDetail><related-links><link href="" invalidHref="flash.filesystem.File.xml"><linktext>flash.filesystem.File</linktext></link><link href="mx.controls.xml#FileSystemList"><linktext>mx.controls.FileSystemList</linktext></link><link href="mx.controls.xml#FileSystemTree"><linktext>mx.controls.FileSystemTree</linktext></link></related-links><adobeApiEvent id="mx.controls:FileSystemComboBox_mx.events.FileEvent.DIRECTORY_CHANGE_directoryChange"><apiName>directoryChange</apiName><shortdesc>
  Dispatched when the selected directory displayed by this control
  changes for any reason.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><adobeApiEventDetail><adobeApiEventDef><apiEventType>mx.events.FileEvent.DIRECTORY_CHANGE</apiEventType><adobeApiEventClassifier>mx.events.FileEvent</adobeApiEventClassifier><apiGeneratedEvent/></adobeApiEventDef><apiDesc>
  Dispatched when the selected directory displayed by this control
  changes for any reason.
 
  </apiDesc></adobeApiEventDetail></adobeApiEvent><apiConstructor id="mx.controls:FileSystemComboBox:FileSystemComboBox"><apiName>FileSystemComboBox</apiName><shortdesc>
      Constructor.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiConstructorDetail><apiConstructorDef><apiAccess value="public"/></apiConstructorDef><apiDesc>
      Constructor.
      
      </apiDesc></apiConstructorDetail></apiConstructor><apiValue id="mx.controls:FileSystemComboBox:COMPUTER"><apiName>COMPUTER</apiName><shortdesc>
      A constant that can be used as a value for the directory property,
      representing a pseudo-top level directory named "Computer".</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiAccess value="public"/><apiStatic/><apiData>unknown</apiData><apiType value="flash.filesystem:File"/></apiValueDef><apiDesc>
      A constant that can be used as a value for the <codeph>directory</codeph> property,
      representing a pseudo-top level directory named "Computer". This pseudo-directory
      contains the root directories
      (such as C:\ and D:\ on Windows or / on Macintosh).
      
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FileSystemComboBox:directory:get"><apiName>directory</apiName><shortdesc>
      A File object representing the directory
      whose ancestors are to be displayed in this control.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty isBindable="true"/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="flash.filesystem:File"/><apiDefaultValue>null
      
      </apiDefaultValue></apiValueDef><apiDesc>
      A File object representing the directory
      whose ancestors are to be displayed in this control.
      The control displays each ancestor directory
      as a separate entry in the dropdown list.
     
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FileSystemComboBox:indent:get"><apiName>indent</apiName><shortdesc>
      The number of pixels to indent each entry in the dropdown list.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="int"/><apiDefaultValue>8
      
      </apiDefaultValue></apiValueDef><apiDesc>
      The number of pixels to indent each entry in the dropdown list.
     
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FileSystemComboBox:showIcons:get"><apiName>showIcons</apiName><shortdesc>
      A flag that determines whether icons are displayed
      before the directory names in the dropdown list.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiProperty/><apiAccess value="public"/><apiDynamic/><apiValueAccess value="readwrite"/><apiType value="Boolean"/><apiDefaultValue>true
      
      </apiDefaultValue></apiValueDef><apiDesc>
      A flag that determines whether icons are displayed
      before the directory names in the dropdown list.
     
      </apiDesc></apiValueDetail></apiValue></apiClassifier><apiClassifier id="mx.controls:FileSystemEnumerationMode"><apiName>FileSystemEnumerationMode</apiName><shortdesc>
  The FileSystemEnumerationMode class defines the constant values
  for the enumerationMode property
  of the FileSystemList, FileSystemDataGrid,
  and FileSystemTree classes.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiClassifierDetail><apiClassifierDef><apiAccess value="public"/><apiStatic/><apiFinal/><apiBaseClassifier>Object</apiBaseClassifier></apiClassifierDef><apiDesc>
  The FileSystemEnumerationMode class defines the constant values
  for the <codeph>enumerationMode</codeph> property
  of the FileSystemList, FileSystemDataGrid,
  and FileSystemTree classes.
 
  </apiDesc></apiClassifierDetail><related-links><link href="mx.controls.xml#FileSystemList/enumerationMode"><linktext>mx.controls.FileSystemList.enumerationMode</linktext></link><link href="mx.controls.xml#FileSystemDataGrid/enumerationMode"><linktext>mx.controls.FileSystemDataGrid.enumerationMode</linktext></link><link href="mx.controls.xml#FileSystemTree/enumerationMode"><linktext>mx.controls.FileSystemTree.enumerationMode</linktext></link></related-links><apiValue id="mx.controls:FileSystemEnumerationMode:DIRECTORIES_FIRST"><apiName>DIRECTORIES_FIRST</apiName><shortdesc>
      Specifies to show directories, then files.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiAccess value="public"/><apiStatic/><apiData>directoriesFirst</apiData><apiType value="String"/></apiValueDef><apiDesc>
      Specifies to show directories, then files.
      
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FileSystemEnumerationMode:DIRECTORIES_ONLY"><apiName>DIRECTORIES_ONLY</apiName><shortdesc>
      Specifies to show directories but not files.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiAccess value="public"/><apiStatic/><apiData>directoriesOnly</apiData><apiType value="String"/></apiValueDef><apiDesc>
      Specifies to show directories but not files.
      
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FileSystemEnumerationMode:FILES_AND_DIRECTORIES"><apiName>FILES_AND_DIRECTORIES</apiName><shortdesc>
      Specifies to show both files and directories, mixed together.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiAccess value="public"/><apiStatic/><apiData>filesAndDirectories</apiData><apiType value="String"/></apiValueDef><apiDesc>
      Specifies to show both files and directories, mixed together.
      
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FileSystemEnumerationMode:FILES_FIRST"><apiName>FILES_FIRST</apiName><shortdesc>
      Specifies to show files first, then directories.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiAccess value="public"/><apiStatic/><apiData>filesFirst</apiData><apiType value="String"/></apiValueDef><apiDesc>
      Specifies to show files first, then directories.
      
      </apiDesc></apiValueDetail></apiValue><apiValue id="mx.controls:FileSystemEnumerationMode:FILES_ONLY"><apiName>FILES_ONLY</apiName><shortdesc>
      Specifies to show files but not directories.</shortdesc><prolog><asMetadata><apiVersion><apiLanguage version="3.0"/><apiPlatform description="" name="AIR" version="1.1"/><apiTool name="Flex" version="3"/></apiVersion></asMetadata></prolog><apiValueDetail><apiValueDef><apiAccess value="public"/><apiStatic/><apiData>filesOnly</apiData><apiType value="String"/></apiValueDef><apiDesc>
      Specifies to show files but not directories.
      
      </apiDesc></apiValueDetail></apiValue></apiClassifier></apiPackage>