FileSystemList  - AS3 Flex

Пакет	mx.controls
Класс	public class FileSystemList
Наследование	FileSystemList List ListBase ScrollControlBase UIComponent FlexSprite Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object

Для изменения отображаемых данных вместо использования свойства dataProvider можно настроить свойство directory. Затем элемент управления автоматически заполняет свойство dataProvider путем перечисления содержимого этого каталога. Выполнять непосредственную настройку свойства dataProvider не требуется.

Следует установить в качестве значения свойства directory экземпляр файла, как показано в следующем примере:

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

Можно настроить свойство enumerationMode для определения необходимости отображения файлов, подкаталогов или того и другого. Существует три способа отображения файлов и подкаталогов: первоочередной вывод каталогов, файлов или смешанный вывод.

Можно настроить свойство extensions для фильтрации отображаемых элементов таким образом, что на экране появляются только файлы с указанными расширениями. Свойство showHidden определяет необходимость отображения элементом управления файлов и подкаталогов, которые обычно скрыты операционной системой. Можно определить дополнительную функцию filterFunction для выполнения пользовательской фильтрации, и функцию nameCompareFunction для выполнения пользовательской сортировки.

Поскольку AIR не поддерживает уведомления файловой системы, автоматическое обновление этого элемента управления в случае создания, удаления, перемещения или переименования файла или подкаталога не выполняется; иными словами, на экране может отображаться устаревшее представление файловой системы. Однако с помощью вызова метода refresh() можно повторно перечислить текущий directory. Это осуществляется, например, в случае выполнения файловой операции, результатом которой является отображение устаревшего представления элемента управления, либо в случае деактивации и повторной активации приложения пользователем.

Свойство showIcons можно использовать для отображения или скрытия значков, а свойство showExtensions – для отображения или скрытия расширения файла.

Этот элемент управления предоставляет два метода, findItem() и findIndex(), которые можно использовать для выполнения поиска среди отображаемых файлов и подкаталогов только элементов с указанным nativePath.

Два свойства, selectedPath и selectedPaths, функционируют аналогично свойствам selectedItem и selectedItems или selectedIndex и selectedIndices, однако указанные два свойства позволяют указывать вариант выбора посредством строк nativePath. Эти свойства рекомендуется использовать при необходимости отображения каталога с определенными предварительно выбранными элементами, поскольку в этом случае еще не существует элементов «Файл», создаваемых элементом управления при перечислении каталога, с неизвестными индексами.

Этот элемент управления позволяет пользователю переходить к другим каталогам с использованием мыши или клавиатуры. Пользователь может осуществить попытку изменения каталога путем двойного щелчка по подкаталогу, нажатия клавиши ENTER или Ctrl-«Стрелка вниз» после выбора подкаталога; путем нажатия Ctrl-«Стрелка вверх», если элемент управления не отображает каталог COMPUTER; путем нажатия Ctrl-«Стрелка влево», если существует «предыдущий» каталог для возврата; либо путем нажатия Ctrl-«Стрелка вправо» при наличии «следующего» каталога, в который требуется перейти. Если пользователь пытается изменить отображаемый каталог, элемент управления передает допускающее отмену событие directoryChanging. Если это событие не отменяется путем вызова методаevent.preventDefault(), элемент управления отображает содержимое нового каталога, и свойство directory изменяется. При каждом изменении directory по любой причине элемент управления передает событие directoryChange с целью уведомления пользователя.

Поддержка элементов управления «Вверх» и «Вниз» осуществляется при помощи свойств canNavigateUp и canNavigateDown и методов navigateUp() и navigateDown() FileSystemList. Кроме того, существует метод navigateTo(), позволяющий осуществлять переход к произвольному каталогу.

В целях упрощения поддержки элементов управления «Назад» и «Вперед» элемент управления отслеживает каталоги, в которые переходил пользователь. Для получения дополнительной информации см. описание свойств backHistory, forwardHistory, canNavigateBack и canNavigateForward, а также методов navigateBack() и navigateForward().

Примечание. Значки, отображаемые для каждого элемента, являются общими для файлов и каталогов, их использование определяется при помощи стилей fileIcon и directoryIcon. Элементы управления Flex на основе списка в настоящее время обеспечивают отображение только вложенных значков, динамическое считывание значков не поддерживаются. Таким образом, значки файловой системы, отображаемые в операционной системе, не отображаются в элементе FileSystemList даже в том случае, если они доступны в AIR при помощи свойства объекта File icon.

Показать синтаксис MXML

Скрыть синтаксис MXML

  <mx:FileSystemList
    Properties
    directory="null"
    enumerationMode="directoriesFirst"
    extensions="null"
    filterFunction="null"
    nameCompareFunction="null"
    selectedPath="null"
    selectedPaths="null"
    showExtensions="true"
    showHidden="false"
    showIcons="true"
 
    Styles
    directoryIcon="TreeNodeIcon"
    fileIcon="TreeNodeIcon"
 
    Events
    directoryChange="No default"
    directoryChanging="No default"
    fileChoose="No default"
  />
  

Свойство MXML по умолчаниюdataProvider

Связанные элементы API