mx.controlsFileSystemDataGrid Элемент управления FileSystemDataGrid позволяет отображать содержимое одного каталога файловой системы в формате сетки данных.The <mx:FileSystemDataGrid> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

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

]]>mx.controls:DataGrid Элемент управления FileSystemDataGrid позволяет отображать содержимое одного каталога файловой системы в формате сетки данных.

Информация, отображаемая для каждого элемента, включает его имя (с необязательным общим значком), тип, размер, дату создания и дату изменения. Для отображения этой информации элемент управления FileSystemDataGrid автоматически создает следующие пять столбцов (экземпляров DataGridColumn): nameColumn, typeColumn, sizeColumn, creationDateColumn и modificationDateColumn, а также устанавливает в качестве значения свойства columns массив, состоящий из этих пяти экземпляров. Каждый экземпляр столбца автоматически конфигурируется с соответствующими функциями labelFunction, sortCompareFunction и т. д. Если использовать все пять столбцов не требуется или необходимо изменить их порядок, следует сбросить свойство columns. При необходимости настройки столбца, например путем изменения его функции labelFunction, следует просто переназначить это свойство для соответствующего объекта столбца.

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

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

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

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

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

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

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

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

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

Этот элемент управления позволяет пользователю переходить к другим каталогам с использованием мыши или клавиатуры. Пользователь может осуществить попытку изменения каталога путем двойного щелчка по подкаталогу, нажатия клавиши 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 на основе списка в настоящее время обеспечивают отображение только вложенных значков, динамическое считывание значков не поддерживаются. Таким образом, значки файловой системы, отображаемые в операционной системе, не отображаются в FileSystemDataGrid даже в том случае, если они доступны в AIR при помощи свойства icon объекта File.

flash.filesystem.File

fileChoose Передается при выборе пользователем какого-либо файла путем двойного щелчка по нему или путем выделения файла с последующим нажатием клавиши Enter.mx.events.FileEvent.FILE_CHOOSEmx.events.FileEvent Передается при выборе пользователем какого-либо файла путем двойного щелчка по нему или путем выделения файла с последующим нажатием клавиши Enter. directoryChanging Передается при попытке пользователя изменить каталог, отображаемый этим элементом управления.mx.events.FileEvent.DIRECTORY_OPENINGmx.events.FileEvent Передается при попытке пользователя изменить каталог, отображаемый этим элементом управления.

Пользователь может осуществить попытку изменения каталога путем двойного щелчка по подкаталогу, нажатия клавиши ENTER или Ctrl-Down после выбора подкаталога; путем нажатия Ctrl-Up, если элемент управления не отображает каталог COMPUTER; путем нажатия Ctrl-Left, если в журнале существует «предыдущий» каталог для возврата; либо путем нажатия Ctrl-Right при наличии в журнале «следующего» каталога, в который требуется перейти.

Это событие допускает отмену. При вызове метода event.preventDefault() каталог не изменяется.

Если свойство directory изменилось, и dataProvider содержит экземпляры файлов для элементов в новом каталоге, то передается событие directoryChange.

Если массив backHistory пуст или указан индекс, не принадлежащий этому массиву, какие-либо действия посредством этого метода не выполняются.

При возвращении этим методом какого-либо значения свойство directory содержит экземпляр файла для нового каталога. Свойство dataProvider имеет значение null до тех пор, пока не перечислен новый каталог. После его перечисления свойство dataProvider содержит ArrayCollection экземпляров файла для содержимого нового каталога.

Журнал остается без изменений. Однако текущий индекс в нем изменяется, что оказывает влияние на свойства backHistory и forwardHistory. После возвращения этим методом каких-либо значений эти свойства получают новые значения.

Следующий пример иллюстрирует способ использования этого метода в сочетании с элементом управления FileSystemHistoryButton в целях создания кнопки «Назад»:

      <mx:FileSystemDataGrid id="fileSystemViewer" directory="{File.desktopDirectory}"/>
      <mx:FileSystemHistoryButton label="Back"
          enabled="{fileSystemViewer.canNavigateBack}"
          dataProvider="{fileSystemViewer.backHistory}"
          click="fileSystemViewer.navigateBack();"
          itemClick="fileSystemViewer.navigateBack(event.index);"/>

backHistorycanNavigateBack

navigateDown Изменяет этот элемент управления в целях отображения содержимого выбранного подкаталога. Изменяет этот элемент управления в целях отображения содержимого выбранного подкаталога.

Если подкаталог не выбран, какие-либо действия посредством этого метода не выполняются.

Следующий пример иллюстрирует способ использования этого метода в сочетании с элементом управления «Кнопка» в целях создания кнопки «Открыть»:

      <mx:FileSystemDataGrid id="fileSystemViewer" directory="{File.desktopDirectory}"/>
      <mx:Button label="Open"
          enabled="{fileSystemViewer.canNavigateDown}"
          click="fileSystemViewer.navigateDown();"/>

canNavigateDown

navigateForward Изменяет этот элемент управления в целях отображения содержимого предыдущего каталога в массиве forwardHistory.index0Индекс в массиве forwardHistory для выполнения навигации. По умолчанию используется значение 0, указывающее на ближайший последующий каталог. Изменяет этот элемент управления в целях отображения содержимого предыдущего каталога в массиве forwardHistory.

Если массив forwardHistory пуст или указан индекс, не принадлежащий этому массиву, какие-либо действия посредством этого метода не выполняются.

Следующий пример иллюстрирует способ использования этого метода в сочетании с элементом управления FileSystemHistoryButton для создания кнопки «Вперед»:

      <mx:FileSystemDataGrid id="fileSystemViewer" directory="{File.desktopDirectory}"/>
      <mx:FileSystemHistoryButton label="Forward"
          enabled="{fileSystemViewer.canNavigateForward}"
          dataProvider="{fileSystemViewer.forwardHistory}"
          click="fileSystemViewer.navigateForward();"
          itemClick="fileSystemViewer.navigateForward(event.index);"/>

canNavigateForwardforwardHistory

navigateTo directoryОбъект файла, представляющий файл или каталог. navigateUp Изменяет этот элемент управления в целях отображения содержимого следующего каталога в иерархии. Изменяет этот элемент управления в целях отображения содержимого следующего каталога в иерархии.

Если этот элемент управления в настоящее время отображает корневые каталоги (например, C: и D: в Microsoft Windows), какие-либо действия посредством этого метода не выполняются.

Следующий пример иллюстрирует способ использования этого метода в сочетании с элементом управления Button в целях создания кнопки «Вверх»:

      <mx:FileSystemDataGrid id="fileSystemViewer" directory="{File.desktopDirectory}"/>
      <mx:Button label="Up"
          enabled="{fileSystemViewer.canNavigateUp}"
          click="fileSystemViewer.navigateUp();"/>

canNavigateUp

refresh COMPUTER unknown creationDateColumn Элемент DataGridColumn представляет столбец Created. Элемент DataGridColumn представляет столбец Created. Этот столбец автоматически создается элементом управления FileSystemDataGrid.

Для настройки этого столбца можно установить значения свойств, например creationDateColumn.width. Для полного удаления этого столбца или изменения порядка столбцов следует задать в качестве значений свойства columns определенный массив, например [nameColumn, modificationDateColumn, sizeColumn].

modificationDateColumn Элемент DataGridColumn представляет столбец Modified. Элемент DataGridColumn представляет столбец Modified. Этот столбец автоматически создается элементом управления FileSystemDataGrid.

Для настройки этого столбца можно установить значения свойств, например modificationDateColumn.width. Для полного удаления этого столбца или изменения порядка столбцов следует задать в качестве значений свойства columns определенный массив, например [nameColumn, modificationDateColumn, sizeColumn].

nameColumn Элемент DataGridColumn представляет столбец Name. Элемент DataGridColumn представляет столбец Name. Этот столбец автоматически создается элементом управления FileSystemDataGrid.

Для настройки этого столбца можно установить значения свойств, например nameColumn.width. Для полного удаления этого столбца или изменения порядка столбцов следует задать в качестве значений свойства columns определенный массив, например [nameColumn, modificationDateColumn, sizeColumn].

sizeColumn Элемент DataGridColumn представляет столбец Size. Элемент DataGridColumn представляет столбец Size. Этот столбец автоматически создается элементом управления FileSystemDataGrid.

Для настройки этого столбца можно установить значения свойств, например sizeColumn.width. Для полного удаления этого столбца или изменения порядка столбцов следует задать в качестве значений свойства columns определенный массив, например [nameColumn, modificationDateColumn, sizeColumn].

typeColumn Элемент DataGridColumn представляет столбец Type. Элемент DataGridColumn представляет столбец Type. Этот столбец автоматически создается элементом управления FileSystemDataGrid.

Для настройки этого столбца можно установить значения свойств, например typeColumn.width. Для полного удаления этого столбца или изменения порядка столбцов следует задать в качестве значений свойства columns определенный массив, например [nameColumn, modificationDateColumn, sizeColumn].

backHistory Массив объектов File представляет каталоги, в которые может вернуться пользователь.[] Массив объектов File представляет каталоги, в которые может вернуться пользователь.

Первый элемент этого массива представляет собой ближайший предыдущий каталог в журнале. Последним элементом массива является самый последний каталог в журнале.

Этот массив может содержать элемент null, представляющий несуществующий каталог, содержимым которого являются корневые каталоги, например C:\ и D:\ в Microsoft Windows.

Следующий пример иллюстрирует способ использования этого свойства в сочетании с элементом управления FileSystemHistoryButton в целях реализации кнопки «Назад»:

      <mx:FileSystemDataGrid id="fileSystemViewer" directory="{File.desktopDirectory}"/>
      <mx:FileSystemHistoryButton label="Back"
         enabled="{fileSystemViewer.canNavigateBack}"
         dataProvider="{fileSystemViewer.backHistory}"
         click="fileSystemViewer.navigateBack();"
         itemClick="fileSystemViewer.navigateBack(event.index);"/>

canNavigateBacknavigateBack()mx.controls.FileSystemHistoryButton

canNavigateBack Флаг, имеющий значение true, если в журнале существует, по крайней мере, один каталог, к которому может вернуться пользователь.false Флаг, имеющий значение true, если в журнале существует, по крайней мере, один каталог, к которому может вернуться пользователь.

      <mx:FileSystemDataGrid id="fileSystemViewer" directory="{File.desktopDirectory}"/>
      <mx:FileSystemHistoryButton label="Back"
          enabled="{fileSystemViewer.canNavigateBack}"
          dataProvider="{fileSystemViewer.backHistory}"
          click="fileSystemViewer.navigateBack();"
          itemClick="fileSystemViewer.navigateBack(event.index);"/>

backHistorynavigateBack()

canNavigateDown Флаг, имеющий значение true, если для перемещения к выбранному каталогу пользователь может перейти на один уровень вниз.false Флаг, имеющий значение true, если для перемещения к выбранному каталогу пользователь может перейти на один уровень вниз. Этот флаг имеет значение false при отсутствии выбранного элемента или в случае, если выбранным элементом является файл, а не каталог.

Следующий пример иллюстрирует способ использования этого свойства в сочетании с элементом управления «Кнопка»:

      <mx:FileSystemDataGrid id="fileSystemViewer" directory="{File.desktopDirectory}"/>
      <mx:Button label="Open"
          enabled="{fileSystemViewer.canNavigateDown}"
          click="fileSystemViewer.navigateDown();"/>

navigateDown()

canNavigateForward Флаг, имеющий значение true при наличии в журнале, по крайней мере, одного каталога, к которому можно перейти.false Флаг, имеющий значение true при наличии в журнале, по крайней мере, одного каталога, к которому можно перейти.

Следующий пример иллюстрирует способ использования этого свойства в сочетании с элементом управления FileSystemHistoryButton для реализации кнопки «Вперед»:

      <mx:FileSystemDataGrid id="fileSystemViewer" directory="{File.desktopDirectory}"/>
      <mx:FileSystemHistoryButton label="Forward"
          enabled="{fileSystemViewer.canNavigateForward}"
          dataProvider="{fileSystemViewer.forwardHistory}"
          click="fileSystemViewer.navigateForward();"
          itemClick="fileSystemViewer.navigateForward(event.index);"/>

forwardHistorynavigateForward()

canNavigateUp Флаг, имеющий значение true, если пользователь может перейти на один уровень вверх в вышестоящий каталог.false Флаг, имеющий значение true, если пользователь может перейти на один уровень вверх в вышестоящий каталог. Этот флаг имеет значение false только в том случае, если данный элемент управления отображает корневые каталоги, например C:\ и D:\ в Microsoft Windows. (В этом случае свойство directory имеет значение COMPUTER.)

      <mx:FileSystemDataGrid id="fileSystemViewer" directory="{File.desktopDirectory}"/>
      <mx:Button label="Up"
          enabled="{fileSystemViewer.canNavigateUp}"
          click="fileSystemViewer.navigateUp();"/>

navigateUp()

dateFormatString Строка, определяющая способ форматирования дат в столбцах Created и Modified. Строка, определяющая способ форматирования дат в столбцах Created и Modified. Установка этого свойства позволяет настроить formatString внутреннего DateFormatter, создаваемого данным элементом управления.

mx.formatters.DateFormatter.formatString

directory enumerationMode FileSystemEnumerationMode.DIRECTORIES_FIRST

mx.controls.FileSystemEnumerationMode

extensions null filterFunction null forwardHistory Массив каталогов представляет объекты File, к которым можно перейти.[] Массив каталогов представляет объекты File, к которым можно перейти.

Первый элемент этого массива представляет собой ближайший следующий каталог в журнале. Последним элементом массива является самый последний каталог в журнале, к которому можно перейти.

      <mx:FileSystemDataGrid id="fileSystemViewer" directory="{File.desktopDirectory}"/>
      <mx:FileSystemHistoryButton label="Forward"
          enabled="{fileSystemViewer.canNavigateForward}"
          dataProvider="{fileSystemViewer.forwardHistory}"
          click="fileSystemViewer.navigateForward();"
          itemClick="fileSystemViewer.navigateForward(event.index);"/>

mx.controls.FileSystemHistoryButton

nameCompareFunction null selectedPath null

mx.controls.listClasses.ListBase.selectedIndexmx.controls.listClasses.ListBase.selectedItem

selectedPaths []

mx.controls.listClasses.ListBase.selectedIndexmx.controls.listClasses.ListBase.selectedItem

showExtensions showHidden showIcons sizeDisplayMode Строка, определяющая способ отображения в столбце Size размеров файлов: в байтах или в виде чисел, являющихся результатом округления до ближайшего значения в килобайтах, где килобайт равен 1024 байтам. Строка, определяющая способ отображения в столбце Size размеров файлов: в байтах или в виде чисел, являющихся результатом округления до ближайшего значения в килобайтах, где килобайт равен 1024 байтам. Возможные значения определены в классе FileSystemSizeDisplayMode.

mx.controls.FileSystemSizeDisplayMode

FileSystemTree Элемент управления The FileSystemTree отображает содержимое каталога файловой системы в виде дерева.The <mx:FileSystemTree> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <mx:FileSystemTree
    Properties
    directory="null"
    enumerationMode="directoriesFirst"
    extensions="null"
    filterFunction="null"
    nameCompareFunction="null"
    openPaths="null"
    selectedPath="null"
    selectedPaths="null"
    showExtensions="true"
    showHidden="false"
    showIcons="true"
 
    Events
    directoryChange="No default"
    directoryClosing="No default"
    directoryOpening="No default"
    fileChoose="No default"
  />

]]>mx.controls:Tree Элемент управления The FileSystemTree отображает содержимое каталога файловой системы в виде дерева.

Указывается каталог, содержимое которого отображается в результате установки свойства directory для экземпляра класса flash.filesystem.File. (Экземпляры файла могут представлять каталоги и файлы.) При каждом изменении свойства по любой причине элемент управления передает событие directoryChange для уведомления пользователя.

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

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

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

Можно выполнить пользовательскую сортировку в каждом узле дерева с помощью настройки свойства nameCompareFunction для функции, которая сравнивает два имени файлов или каталогов.

При двойном щелчке закрытого узла каталога или при щелчке значка раскрытия этот элемент управления передает событие directoryOpening. При двойном щелчке открытого узла каталога или при щелчке значка раскрытия этот элемент управления передает событие directoryClosing. Обработчик может отменить любое событие с помощью вызова event.preventDefault(). В этом случае открытие узла не выполняется.

При двойном щелчке узла файла этот элемент управления передает событие select.

flash.filesystem.File

fileChoose Передается при выборе пользователем какого-либо файла путем двойного щелчка по нему или путем выделения файла с последующим нажатием клавиши Enter.mx.events.FileEvent.FILE_CHOOSEmx.events.FileEvent Передается при выборе пользователем какого-либо файла путем двойного щелчка по нему или путем выделения файла с последующим нажатием клавиши Enter. directoryOpening Передается, если пользователь открывает закрытый узел каталога с помощью мыши или клавиатуры.mx.events.FileEvent.DIRECTORY_OPENINGmx.events.FileEvent Передается, если пользователь открывает закрытый узел каталога с помощью мыши или клавиатуры.

Это событие может быть отменено. При вызове event.preventDefault() этот элемент управления продолжает отображать текущий каталог, а не подкаталог, по которому был произведен двойной щелчок.

directoryClosing Передается в том случае, когда пользователь закрывает открытый узел каталога с помощью мыши или клавиатуры.mx.events.FileEvent.DIRECTORY_CLOSINGmx.events.FileEvent Передается в том случае, когда пользователь закрывает открытый узел каталога с помощью мыши или клавиатуры. directoryChange Передается при изменении свойства directory по любым причинам.mx.events.FileEvent.DIRECTORY_CHANGEmx.events.FileEvent Передается при изменении свойства directory по любым причинам. FileSystemTree Конструктор. Конструктор. clear Очищает список. Очищает список.

Этот метод устанавливает свойство dataProvider равным null, но не изменяет свойство directory. Для повторного заполнения списка можно вызвать refresh.

closeSubdirectory Закрывает подкаталог, указанный с помощью пути встроенной файловой системы.nativePathСтрока, определяющая nativePath элемента «Файл». Закрывает подкаталог, указанный с помощью пути встроенной файловой системы.

Если свойство nativePath не указывает каталог, который отображается внутри этого элемента управления, то этот метод не выполняет никаких действий.

findIndex Отсчитываемый от нуля индекс или -1, если не найден файл с указанным путем. nativePathСтрока, определяющая nativePath элемента «Файл». findItem Экземпляр файла, если таковой найден, с указанной строкой nativePath; либо null, если экземпляр не обнаружен. nativePathСтрока, определяющая nativePath элемента «Файл». openSubdirectory Открывает подкаталог, указанный с помощью пути встроенной файловой системы.nativePathСтрока, определяющая nativePath элемента «Файл». Открывает подкаталог, указанный с помощью пути встроенной файловой системы.

Этот метод автоматически открывает все промежуточные каталоги, обращение к которым необходимо для доступа к указанному каталогу.

Если в свойстве nativePath не указан существующий каталог файловой системы или этот каталог не содержится в каталоге, отображаемом в данном элементе управления, то данный метод не выполняет никаких действий.

refresh Выполняет повторное перечисление текущего каталога, который отображается в этом элементе управления. Выполняет повторное перечисление текущего каталога, который отображается в этом элементе управления.

После возврата данного метода свойство directory будет содержать экземпляр File для того же каталога, что и раньше. Свойство dataProvider временно становится равным null до момента повторного перечисления каталога. После перечисления свойство dataProvider будет содержать объект ArrayCollection экземпляров File для содержимого каталога.

COMPUTER unknown directory Каталог, содержимое которого отображается в элементе управления.COMPUTER Каталог, содержимое которого отображается в элементе управления.

Если это свойство устанавливается равным объекту File, который представляет существующий каталог, то свойство dataProvider немедленно становится равным null. После того как LayoutManager проводит повторную проверку элемента управления, сам элемент управления выполняет синхронное перечисление содержимого каталога и заполняет свойство dataProvider коллекцией ArrayCollection, которая состоит из объектов File для файлов и подкаталогов данного каталога.

Если свойство приравнивается объекту File, который не представляет существующий каталог, то возникает ошибка. Если свойство приравнивается значению COMPUTER, то выполняется синхронное отображение корневых каталогов, например C: и D: в системе Windows.

enumerationMode FileSystemEnumerationMode.DIRECTORIES_FIRST

mx.controls.FileSystemEnumerationMode

extensions null filterFunction null nameCompareFunction null openPaths Массив, состоящий из строк nativePath для элементов File, которые представляют открытые подкаталоги.[] Массив, состоящий из строк nativePath для элементов File, которые представляют открытые подкаталоги. Массив пуст, если не открыто ни одного подкаталога. selectedPath null

mx.controls.listClasses.ListBase.selectedIndexmx.controls.listClasses.ListBase.selectedItem

selectedPaths []

mx.controls.listClasses.ListBase.selectedIndexmx.controls.listClasses.ListBase.selectedItem

showExtensions true showHidden false showIcons true FileSystemList Элемент управления FileSystemList позволяет отображать содержимое одного каталога файловой системы в формате списка.The <mx:FileSystemList> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

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

]]>mx.controls:List Элемент управления FileSystemList позволяет отображать содержимое одного каталога файловой системы в формате списка.

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

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

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

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

flash.filesystem.File

Это событие допускает отмену. При вызове метода event.preventDefault() каталог не изменяется.

directoryChange Передается при изменении по любым причинам каталога, отображаемого данным элементом управления.mx.events.FileEvent.DIRECTORY_CHANGEmx.events.FileEvent Передается при изменении по любым причинам каталога, отображаемого данным элементом управления. FileSystemList Конструктор. Конструктор. clear Сбрасывает этот элемент управления, после чего он не будет отображать ни одного элемента. Сбрасывает этот элемент управления, после чего он не будет отображать ни одного элемента.

Этот метод устанавливает свойство dataProvider равным null, но не изменяет свойство directory. Для повторного заполнения элемента управления можно вызвать refresh.

findIndex Возвращает индекс элемента File с указанным путем встроенной файловой системы.Отсчитываемый от нуля индекс или -1, если не найден файл с указанным путем. nativePathСтрока, определяющая nativePath элемента «Файл». Возвращает индекс элемента File с указанным путем встроенной файловой системы.

В поиск не включаются элементы, присутствующие в коллекции элемента управления, но не отображающиеся после фильтрации.

flash.filesystem.File.nativePath

findItem Выполняет поиск по экземплярам File, отображаемым в данный момент в этом элементе, и возвращает элемент с указанным свойством nativePath.Экземпляр файла, если таковой найден, с указанной строкой nativePath; либо null, если экземпляр не обнаружен. nativePathСтрока, определяющая nativePath элемента «Файл». Выполняет поиск по экземплярам File, отображаемым в данный момент в этом элементе, и возвращает элемент с указанным свойством nativePath.

В поиск не включаются экземпляры файлов, присутствующие в коллекции элемента управления, но не отображающиеся после фильтрации.

navigateBack Изменяет этот элемент управления в целях отображения содержимого предыдущего каталога в массиве backHistory.index0Индекс в массиве backHistory для выполнения навигации. По умолчанию используется значение 0, указывающее на ближайший предыдущий каталог. Изменяет этот элемент управления в целях отображения содержимого предыдущего каталога в массиве backHistory.

      <mx:FileSystemList id="fileSystemViewer" directory="{File.desktopDirectory}"/>
      <mx:FileSystemHistoryButton label="Back"
          enabled="{fileSystemViewer.canNavigateBack}"
          dataProvider="{fileSystemViewer.backHistory}"
          click="fileSystemViewer.navigateBack();"
          itemClick="fileSystemViewer.navigateBack(event.index);"/>

backHistorycanNavigateBack

Если подкаталог не выбран, какие-либо действия посредством этого метода не выполняются.

      <mx:FileSystemList id="fileSystemViewer" directory="{File.desktopDirectory}"/>
      <mx:Button label="Open"
          enabled="{fileSystemViewer.canNavigateDown}"
          click="fileSystemViewer.navigateDown();"/>

canNavigateDown

      <mx:FileSystemList id="fileSystemViewer" directory="{File.desktopDirectory}"/>
      <mx:FileSystemHistoryButton label="Forward"
          enabled="{fileSystemViewer.canNavigateForward}"
          dataProvider="{fileSystemViewer.forwardHistory}"
          click="fileSystemViewer.navigateForward();"
          itemClick="fileSystemViewer.navigateForward(event.index);"/>

canNavigateForwardforwardHistory

navigateTo Изменяет этот элемент управления для отображения содержимого указанного каталога.directoryОбъект файла, представляющий файл или каталог. Изменяет этот элемент управления для отображения содержимого указанного каталога. navigateUp Изменяет этот элемент управления в целях отображения содержимого следующего каталога в иерархии. Изменяет этот элемент управления в целях отображения содержимого следующего каталога в иерархии.

Следующий пример иллюстрирует способ использования этого метода в сочетании с элементом управления Button для создания кнопки «Вверх»:

      <mx:FileSystemList id="fileSystemViewer" directory="{File.desktopDirectory}"/>
      <mx:Button label="Up"
          enabled="{fileSystemViewer.canNavigateUp}"
          click="fileSystemViewer.navigateUp();"/>

canNavigateUp

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

Этот метод сохраняет все выбранные элементы (если они еще существуют) и положение прокрутки (если первый видимый элемент еще существует).

COMPUTER Константа, которая может использоваться в качестве значения для свойства directory, представляющего псевдокаталог верхнего уровня под именем «Компьютер».unknown Константа, которая может использоваться в качестве значения для свойства directory, представляющего псевдокаталог верхнего уровня под именем «Компьютер». Этот псевдокаталог содержит корневые каталоги (например, C:\ и D:\ в Windows или / в Macintosh). backHistory Массив объектов File представляет каталоги, в которые может вернуться пользователь.[] Массив объектов File представляет каталоги, в которые может вернуться пользователь.

      <mx:FileSystemList id="fileSystemViewer" directory="{File.desktopDirectory}"/>
      <mx:FileSystemHistoryButton label="Back"
          enabled="{fileSystemViewer.canNavigateBack}"
          dataProvider="{fileSystemViewer.backHistory}"
          click="fileSystemViewer.navigateBack();"
          itemClick="fileSystemViewer.navigateBack(event.index);"/>

canNavigateBacknavigateBack()mx.controls.FileSystemHistoryButton

      <mx:FileSystemList id="fileSystemViewer" directory="{File.desktopDirectory}"/>
      <mx:FileSystemHistoryButton label="Back"
          enabled="{fileSystemViewer.canNavigateBack}"
          dataProvider="{fileSystemViewer.backHistory}"
          click="fileSystemViewer.navigateBack();"
          itemClick="fileSystemViewer.navigateBack(event.index);"/>

backHistorynavigateBack()

      <mx:FileSystemList id="fileSystemViewer" directory="{File.desktopDirectory}"/>
      <mx:Button label="Open"
          enabled="{fileSystemViewer.canNavigateDown}"
          click="fileSystemViewer.navigateDown();"/>

navigateDown()

      <mx:FileSystemList id="fileSystemViewer" directory="{File.desktopDirectory}"/>
      <mx:FileSystemHistoryButton label="Forward"
          enabled="{fileSystemViewer.canNavigateForward}"
          dataProvider="{fileSystemViewer.forwardHistory}"
          click="fileSystemViewer.navigateForward();"
          itemClick="fileSystemViewer.navigateForward(event.index);"/>

forwardHistorynavigateForward()

      <mx:FileSystemList id="fileSystemViewer" directory="{File.desktopDirectory}"/>
      <mx:Button label="Up"
          enabled="{fileSystemViewer.canNavigateUp}"
          click="fileSystemViewer.navigateUp();"/>

navigateUp()

directory Каталог, содержимое которого отображается в элементе управления.COMPUTER Каталог, содержимое которого отображается в элементе управления.

Если это свойство устанавливается равным объекту File, который представляет существующий каталог, то свойство dataProvider немедленно становится равным null. После повторной проверки с помощью LayoutManager этот элемент управления перечисляет содержимое каталога и заполняет свойство dataProvider данными ArrayCollection результирующих объектов File для файлов и подкаталогов данного каталога.

Установка этого свойства отменяет выбор всех ранее выбранных элементов и приводит к возврату элементом управления положения прокрутки в левый верхний угол.

enumerationMode Строка, определяющая отображение этим элементом управления файлов и/или подкаталогов.FileSystemEnumerationMode.DIRECTORIES_FIRST Строка, определяющая отображение этим элементом управления файлов и/или подкаталогов. В случае отображения и файлов, и подкаталогов оно также указывает, отображаются ли подкаталоги до, после или совместно с файлами. Возможные значения определены в классе FileSystemEnumerationMode.

Это свойство определяет подкаталоги и файлы, отображаемые в элементе управления, а также порядок их появления. Но оно не определяет экземпляры файлов в свойстве dataProvider; они определяются путем изменения функции фильтрации, применяемой к dataProvider. Его установка не приводит к повторному перечислению текущегоdirectory.

Установка этого свойства отменяет выбор всех выбранных элементов и приводит к возврату элементом управления положения прокрутки в левый верхний угол.

mx.controls.FileSystemEnumerationMode

extensions Массив расширений, определяющий файлы, отображаемые в этом элементе управления.null Массив расширений, определяющий файлы, отображаемые в этом элементе управления. Например, если это свойство имеет значение [.htm, .html], то далее будут отображаться только файлы с такими расширениями.

Значения расширений обрабатываются без учета регистра, и предшествующая расширению точка является необязательной. Например, .HTML эквивалентно html.

Каталоги не подчиняются фильтрации по расширениям, даже если в их именах содержатся точки.

Файлы, отображаемые в элементе управления, также определяются свойствами enumerationMode и filterFunction. Например, хотя это свойство имеет значение [".htm", ".html"], файл с расширением .html не будет отображен, если свойство enumerationMode имеет значение FileSystemEnumerationMode.DIRECTORIES_ONLY или если filterFunction возвращает для файла значение false.

Если это свойство имеет значение null, фильтрация по расширениям не выполняется, и отображаются все файлы. Если это свойство является пустым массивом, то все расширения отфильтровываются, и файлы с расширениями не отображаются.

Это свойство определяет файлы, отображаемые в элементе управления. Но оно не определяет экземпляры файлов в свойстве dataProvider; они определяются путем изменения функции фильтрации, применяемой к dataProvider. Его установка не приводит к повторному перечислению текущегоdirectory.

filterFunction Функция обратного вызова, позволяющая выполнить дополнительную фильтрацию после применения свойств enumerationMode и extensions для определения отображаемых и скрытых файлов и подкаталогов.null Функция обратного вызова, позволяющая выполнить дополнительную фильтрацию после применения свойств enumerationMode и extensions для определения отображаемых и скрытых файлов и подкаталогов.

Эта функция должна иметь следующую подпись:

function myFilterFunction(file:File):Boolean

Эта функция должна возвращать значение true для отображения указанного файла или подкаталога и значение false для его скрытия.

Для обеспечения передачи в эту функцию всех перечисленных файлов и подкаталогов свойство enumerationMode не должно иметь значение FileSystemEnumerationMode.FILES_ONLY или FileSystemEnumerationMode.DIRECTORIES_ONLY, а свойство extensions должно иметь значение null. В противном случае значения этих свойств приведут к выполнению предварительной фильтрации до вызова функции фильтрации.

Это свойство определяет подкаталоги и файлы, отображаемые в элементе управления Но оно не определяет экземпляры файлов в свойстве dataProvider; они определяются путем изменения функции фильтрации, применяемой к dataProvider. Его установка не приводит к повторному перечислению текущегоdirectory.

forwardHistory Массив каталогов представляет объекты File, к которым можно перейти.[] Массив каталогов представляет объекты File, к которым можно перейти.

Этот массив может содержать специальный объект File COMPUTER, представляющий несуществующий каталог, содержимым которого являются корневые каталоги, например C:\ и D:\ в Microsoft Windows.

      <mx:FileSystemList id="fileSystemViewer" directory="{File.desktopDirectory}"/>
      <mx:FileSystemHistoryButton label="Forward"
          enabled="{fileSystemViewer.canNavigateForward}"
          dataProvider="{fileSystemViewer.forwardHistory}"
          click="fileSystemViewer.navigateForward();"
          itemClick="fileSystemViewer.navigateForward(event.index);"/>

canNavigateForwardnavigateForward()mx.controls.FileSystemHistoryButton

nameCompareFunction Функция обратного вызова, позволяющая влиять на сравнение имен файлов и подкаталогов для определения порядка сортировки.null Функция обратного вызова, позволяющая влиять на сравнение имен файлов и подкаталогов для определения порядка сортировки.

Эта функция должна иметь следующую подпись:

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

Возвращает -1, если name1 следует перед name2, 1, если name1 следует после name2, и 0, если имена одинаковы.

Если это свойство не установлено, элемент управления выполняет сравнение двух указанных имен с учетом регистра и языкового стандарта. Сначала для каждого имени вызывается строковый метод toLocaleLowerCase(), затем выполняется сравнение имен с помощью операторов < и >.

Если для свойства enumerationMode установлено значение FileSystemEnumerationMode.FILES_FIRST или FileSystemEnumerationMode.DIRECTORIES_FIRST, то этот метод выполняет сравнение имен только внутри отдельных групп файлов и каталогов.

Это свойство определяет порядок отображения в элементе управления подкаталогов и файлов. Но оно не определяет экземпляры файлов в свойстве dataProvider; они определяются путем изменения способа сортировки, применяемого к dataProvider. Его установка не приводит к повторному перечислению текущегоdirectory.

selectedPath Свойство nativePath файлового элемента, представляющее выбранный подкаталог или файл или имеющее значение null, если элемент не выбран.null Свойство nativePath файлового элемента, представляющее выбранный подкаталог или файл или имеющее значение null, если элемент не выбран.

При выборе нескольких элементов это свойство представляет первый путь в массиве selectedPaths.

Установка этого свойства влияет на свойства selectedPaths, selectedItem, selectedItems, selectedIndex и selectedIndices.

mx.controls.listClasses.ListBase.selectedIndexmx.controls.listClasses.ListBase.selectedItem

selectedPaths Массив строк nativePath для файловых элементов, представляющий выбранные подкаталоги и файлы.[] Массив строк nativePath для файловых элементов, представляющий выбранные подкаталоги и файлы. Массив пуст, если элементы не выбраны.

Установка этого свойства влияет на свойства selectedPaths, selectedItem, selectedItems, selectedIndex и selectedIndices.

mx.controls.listClasses.ListBase.selectedIndexmx.controls.listClasses.ListBase.selectedItem

showExtensions Флаг, определяющий возможность отображения расширений в именах файлов.true Флаг, определяющий возможность отображения расширений в именах файлов. У этого свойства значение true устанавливается для отображения расширений файлов, а значение false для их скрытия. Расширения в именах каталогов отображаются всегда.

Установка этого свойства не определяет отображаемые элементы и порядок их появления. Она также не влияет на выбор элементов и положение прокрутки.

showHidden Флаг, указывающий возможность отображения скрытых файлов и каталогов.false Флаг, указывающий возможность отображения скрытых файлов и каталогов. У этого свойства значение true устанавливается для отображения скрытых файлов, а значение false для их скрытия.

showIcons Флаг, указывающий возможность отображения значков перед именами файлов.true Флаг, указывающий возможность отображения значков перед именами файлов. У этого свойства значение true устанавливается для отображения значков, а значение false для их скрытия.

Для изменения значков по умолчанию можно установить стили directoryIcon и fileIcon. Этот элемент управления не может отобразить фактический значок, устанавливаемый для файла операционной системой, поскольку AIR не поддерживает эту функцию.

FileSystemSizeDisplayMode Класс FileSystemSizeDisplayMode определяет значения констант для свойства sizeDisplayMode класса FileSystemDataGrid.Object Класс FileSystemSizeDisplayMode определяет значения констант для свойства sizeDisplayMode класса FileSystemDataGrid.

mx.controls.FileSystemDataGrid.enumerationMode

BYTES Определяет необходимость отображения размера файлов в байтах.bytes Определяет необходимость отображения размера файлов в байтах. KILOBYTES Определяет необходимость отображения размера файлов в килобайтах.kilobytes Определяет необходимость отображения размера файлов в килобайтах. HTML Элемент управления ToolTip позволяет отображать содержимое HTML в приложении.The <mx:HTML> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <mx:HTML
    Properties
    data="null"
    historyPosition="0"
    htmlHost="null"
    htmlLoaderFactory="mx.core.ClassFactory"
    htmlText=""
    listData="null"
    location=""
    paintsDefaultBackground="false"
    runtimeApplicationDomain="null"
    userAgent="null"
 
    Styles
    paddingBottom="0"
    paddingLeft="0"
    paddingRight="0"
    paddingTop="0"
 
    Events
    complete="No default"
    htmlDOMInitialize="No default"
    htmlRender="No default"
    locationChange="No default"
    uncaughtScriptException="No default"
  />

]]>mx.core:IDataRenderermx.controls.listClasses:IDropInListItemRenderermx.controls.listClasses:IListItemRenderermx.managers:IFocusManagerComponentmx.core:ScrollControlBase Элемент управления ToolTip позволяет отображать содержимое HTML в приложении.

Свойство location используется для указания URL-адреса страницы HTML, содержимое которой отображается в элементе управления, либо можно настроить свойство htmlText для определения строки, содержащей отформатированный текст HTML, визуализация которого осуществляется в элементе управления.

HTMLLoader

uncaughtScriptException Передается в случае неперехваченного исключения JavaScript.flash.events.HTMLUncaughtScriptExceptionEvent.UNCAUGHT_SCRIPT_EXCEPTIONflash.events.HTMLUncaughtScriptExceptionEvent Передается в случае неперехваченного исключения JavaScript.

Передача события всегда выполняется асинхронно. Обработчик события для этого события может выполнить вызов любого метода либо получить доступ к любому свойству этого элемента управления или его внутреннего htmlLoader.

locationChange Передается при изменении свойства location.flash.events.Event.LOCATION_CHANGEflash.events.Event Передается при изменении свойства location.

htmlRender Передается при первоначальной визуализации содержимого HTML этого элемента управления, а также при каждом повторном выполнении визуализации.flash.events.Event.HTML_RENDERflash.events.Event Передается при первоначальной визуализации содержимого HTML этого элемента управления, а также при каждом повторном выполнении визуализации.

Поскольку элемент управления HTML может выполнять передачу многих из этих событий, важно избежать значительного увеличения объема обработки, выполняемой обработчиком render, которое могло бы оказать отрицательное воздействие на производительность.

htmlDOMInitialize Передается после инициализации HTML DOM в результате выполнения операции загрузки при настройке свойства location или htmlText.flash.events.Event.HTML_DOM_INITIALIZEflash.events.Event Передается после инициализации HTML DOM в результате выполнения операции загрузки при настройке свойства location или htmlText.

В момент передачи этого события какие-либо методы JavaScript еще не выполнены. Объекты domWindowи domWindow.document уже существуют, однако другие объекты DOM могут еще не существовать. Это событие можно использовать для настройки свойства объектов domWindow и domWindow.document для методов JavaScript с целью последующего получения доступа к этим методам.

Обработчик для этого события не должен устанавливать каких-либо свойств или выполнять вызов каких-либо методов, инициирующих другую операцию загрузки или воздействующих на URL-адрес для текущей операции загрузки; в противном случае возникает исключение ActionScript или JavaScript.

locationhtmlText

complete Передается после выполнения последней операции загрузки, инициированной при завершении установки свойств location или htmlText.flash.events.Event.COMPLETEflash.events.Event Передается после выполнения последней операции загрузки, инициированной при завершении установки свойств location или htmlText.

Передача этого события всегда выполняется асинхронно и инициируется после передачи события JavaScript load в HTML DOM.

Обработчик события для этого события может выполнить вызов любого метода либо получить доступ к любому свойству этого элемента управления или его внутреннего htmlLoader.

locationhtmlText

HTML Конструктор. Конструктор. cancelLoad Отменяет любую выполняющуюся операцию загрузки. Отменяет любую выполняющуюся операцию загрузки.

Этот метод не приводит к выполнению каких-либо действий в случае его вызова перед созданием внутреннего HTMLLoader этого компонента (свойство htmlLoader).

getHistoryAt Возвращает HTMLHistoryItem в указанной позиции в журнале этого элемента управления.Объект HTMLHistoryItem для записи журнала в заданной позиции. positionПозиция в журнале. Возвращает HTMLHistoryItem в указанной позиции в журнале этого элемента управления.

Этот метод возвращает значение null, если он вызывается перед созданием внутреннего HTMLLoader этого элемента (свойство htmlLoader).

historyPosition

historyBack Обеспечивает выполнение возврата в журнале этого элемента управления (по возможности). Обеспечивает выполнение возврата в журнале этого элемента управления (по возможности).

Вызов этого метода объекта HTMLLoader аналогичен вызову метода back() свойства window.history в сценарии JavaScript в содержимом HTML.

historyPositionhistoryForward()

historyForward Обеспечивает выполнение перехода вперед в журнале этого элемента управления (по возможности). Обеспечивает выполнение перехода вперед в журнале этого элемента управления (по возможности).

Вызов этого метода объекта HTMLLoader аналогичен вызову метода forward() свойства window.history в сценарии JavaScript в содержимом HTML.

Эта функция не приводит к возникновению ошибок.

historyPositionhistoryBack()

historyGo Обеспечивает переход на указанное количество шагов в журнале этого элемента управления.stepsЧисло шагов в журнале, на которое необходимо выполнить переход вперед (положительное число) или назад (отрицательное число). Обеспечивает переход на указанное количество шагов в журнале этого элемента управления.

Этот метод обеспечивает переход, если количество шагов является положительным, и переход назад, если количество шагов является отрицательным. Переход на нулевое количество шагов эквивалентен выполнению вызова метода reload().

Вызов этого метода эквивалентен вызову метода go() свойства window.history в сценарии JavaScript в содержимом HTML.

reload Повторно загружает содержимое HTML из текущего местоположения. Повторно загружает содержимое HTML из текущего местоположения.

htmlLoader Внутренний объект HTMLLoader, обеспечивающий визуализацию содержимого HTML для этого элемента управления. Внутренний объект HTMLLoader, обеспечивающий визуализацию содержимого HTML для этого элемента управления. contentHeight Высота содержимого HTML (в пикселях). Высота содержимого HTML (в пикселях). contentWidth Ширина содержимого HTML (в пикселях). Ширина содержимого HTML (в пикселях). data Позволяет выполнить передачу значения в компонент при его использовании в средстве визуализации элементов или редакторе элементов.null Позволяет выполнить передачу значения в компонент при его использовании в средстве визуализации элементов или редакторе элементов. Привязка данных, как правило, используется для привязки поля свойства data к свойству данного компонента.

При использовании элемента управления в качестве средства визуализации или редактора вставных элементов Flex автоматически записывает текущее значение элемента в свойство text данного элемента управления.

Установить это свойство в MXML невозможно.

mx.core.IDataRenderer

domWindow Объект JavaScript window для корневого фрейма HTML DOM в пределах этого элемента управления.null Объект JavaScript window для корневого фрейма HTML DOM в пределах этого элемента управления.

Это свойство имеет значение null до момента передачи события htmlDOMInitialize.

historyLength Полная длина списка журнала, включая предыдущие и последующие записи. Полная длина списка журнала, включая предыдущие и последующие записи. Это свойство имеет то же самое значение, что и свойство JavaScript window.history.length содержимого HTML.

historyPosition

historyPosition Текущее положение в журнале.0 Текущее положение в журнале.

Журнал соответствует объекту window.history содержимого HTML. Записи, расположенные перед текущим положением, называются предыдущим списком; записи после текущего положения называются последующим списком. При попытке настроить положение после конечных записей задается положение в конце списка.

htmlHost Объект HTMLHost используется при обработке изменений для определенных элементов пользовательского интерфейса в содержимом HTML, например свойства window.document.title.null Объект HTMLHost используется при обработке изменений для определенных элементов пользовательского интерфейса в содержимом HTML, например свойства window.document.title.

В целях отмены поведения по умолчанию для HTMLLoader необходимо создать подкласс класса HTMLHost, отменить его функции элемента, предназначенные для обработки различных изменений пользовательского интерфейса в содержимом HTML, а затем настроить это свойство для экземпляра подкласса.

htmlLoaderFactory IFactory, создающий экземпляр, производный от HTMLLoader, для использования в качестве htmlLoader. IFactory, создающий экземпляр, производный от HTMLLoader, для использования в качестве htmlLoader.

По умолчанию для HTMLLoader используется значение IFactory.

htmlText Указывает строку, отформатированную на основе HTML, для отображения элементом управления."" Указывает строку, отформатированную на основе HTML, для отображения элементом управления.

Настройка этого свойства имеет побочный эффект, который заключается в установке для свойства location значения null и наоборот.

Содержимое, загруженное с помощью метода loadString(), помещается в защищенную изолированную среду приложения. Если приложение AIR включает элемент управления HTML, расположенный в изолированной среде приложения, и в элемент управления непосредственно добавляется удаленный код HTML путем настройки свойства htmlText, то любой сценарий, содержащийся в тексте HTML, выполняется в изолированной среде приложения.

location

imeMode Указывает режим IME (редактор методов ввода).null Указывает режим IME (редактор методов ввода). IME позволяет пользователям вводить текст на китайском, японском и корейском языках. Режим IME устанавливается при перемещении фокуса на элемент управления и возвращается к предыдущему значению при потере фокуса этим элементом управления.

Класс flash.system.IMEConversionMode определяет константы для допустимых значений этого свойства. Можно также указать значение null и не указывать IME.

flash.system.IMEConversionMode

listData При использовании компонента в качестве средства визуализации вставных элементов или редактора вставных элементов Flex инициализирует свойство компонента listData соответствующими данными из элемента управления List.null При использовании компонента в качестве средства визуализации или редактора вставных элементов Flex инициализирует свойство компонента listData с соответствующими данными из элемента управления List. Затем компонент может использовать свойство listData для инициализации свойства data средства визуализации или редактора вставных объектов.

Это свойство не устанавливается в MXML или ActionScript; Flex устанавливает его, когда компонент используется как средство визуализации или редактор вставных элементов.

mx.controls.listClasses.IDropInListItemRenderer

loaded Флаг, указывающий на соответствие события load JavaScript предыдущей операции загрузки в HTML DOM в этом элементе управления.false Флаг, указывающий на соответствие события load JavaScript предыдущей операции загрузки в HTML DOM в этом элементе управления.

Это свойство имеет значение true перед передачей события complete.

Установка для этого свойства значения true может оказаться невозможной. Причины аналогичны тем, по которым невозможна передача события complete.

location URL-адрес страницы HTML, отображаемой этим элементом управления."" URL-адрес страницы HTML, отображаемой этим элементом управления.

Настройка этого свойства имеет побочный эффект, который заключается в установке для свойства htmlText значения null и наоборот.

htmlText

paintsDefaultBackground Определяет наличие по умолчанию непрозрачного белого фона в содержимом HTML этого элемента управления.false; Определяет наличие по умолчанию непрозрачного белого фона в содержимом HTML этого элемента управления.

Если это свойство имеет значение false, то содержимое HTML(при его наличии) отображается с использованием фона, указанного для этого элемента управления Flex.

Однако если какой-либо элемент HTML имеет собственный цвет непрозрачного фона (например, определяемый стилем style="background-color:gray"), то соответствующий элемент отображается с использованием этого фона.

pdfCapability Тип поддержки PDF в пользовательской системе, определенный как целочисленное кодовое значение. Тип поддержки PDF в пользовательской системе, определенный как целочисленное кодовое значение.

Содержимое PDF будет отображаться в объекте HTML только в том случае, если для этого свойства задано значение PDFCapability.STATUS_OK. Класс PDFCapability определяет константы для возможных значений свойства pdfCapability, как показано ниже:

Константа PDFCapabilityЗначение STATUS_OK Необходимая версия (8.1 или более поздняя) приложения Acrobat Reader обнаружена, и содержимое PDF можно загрузить в объект HTML.

Примечание. Если в системе Windows в настоящее время запущено приложение Acrobat или Acrobat Reader версии 7.x или более поздней, эта версия используется даже в том случае, если установлена более поздняя версия, поддерживающая загрузку содержимого PDF, загруженного в объект HTML. Таким образом, если для свойства pdfCapability задано значение PDFCapability.STATUS_OK, при попытке приложения AIR загрузить содержимое PDF в объект HTML в более ранней версии Acrobat или Reader отображается предупреждение, однако в среде выполнения AIR сообщение об ошибке не появляется. Если конечные пользователи сталкиваются с такой ситуацией, можно рассмотреть необходимость создания инструкций относительно закрытия Acrobat при использовании данного приложения. Целесообразно предусмотреть возможность отображения этих инструкций, если загрузка содержимого PDF не может быть выполнена в пределах определенного временного интервала.

ERROR_INSTALLED_READER_NOT_FOUND Версия Acrobat Reader не обнаружена. Объекту HTML не удается отобразить содержимое PDF. ERROR_INSTALLED_READER_TOO_OLD Приложение Acrobat Reader обнаружено, но версия является слишком старой. Объекту HTML не удается отобразить содержимое PDF. ERROR_PREFERED_READER_TOO_OLD Необходимая версия (8.1 или более поздняя) приложения Acrobat Reader обнаружена, но версия этого приложения, настроенная для обработки содержимого PDF, является более ранней, чем 8.1. Объекту HTML не удается отобразить содержимое PDF. runtimeApplicationDomain ApplicationDomain, используемый для создания сценария window.runtime HTML.null ApplicationDomain, используемый для создания сценария window.runtime HTML.

Если это свойство имеет значение null, или если оно определяет ApplicationDomain из домена безопасности, отличного от содержимого HTML, то на странице HTML используется ApplicationDomain по умолчанию для домена страницы.

userAgent Строка агента пользователя, которую необходимо использовать в запросах содержимого из данного элемента управления.null Строка агента пользователя, которую необходимо использовать в запросах содержимого из данного элемента управления.

Можно настроить строку агента пользователя по умолчанию, используемую всеми элементами управления HTML в домене приложения, путем определения свойства URLRequestDefaults.userAgent. Если для свойства userAgent объекта значение не задано (или в качестве значения используется null), то строке агента пользователя назначается значение URLRequestDefaults.userAgent.

Если ни для свойства userAgent этого элемента управления, ни для URLRequestDefaults.userAgent не задано какое-либо значение, в качестве строки агента пользователя используется значение по умолчанию. Это значение по умолчанию зависит от конечной операционной системы (Mac OS или Windows), языка и версии (см. следующие два примера):

      "Mozilla/5.0 (Macintosh; U; PPC Mac OS X; en) AppleWebKit/420+ (KHTML, like Gecko) AdobeAIR/1.0"
      "Mozilla/5.0 (Windows; U; en) AppleWebKit/420+ (KHTML, like Gecko) AdobeAIR/1.0"

flash.net.URLRequest.userAgentflash.net.URLRequestDefaults.userAgent

FlexNativeMenu Компонент FlexNativeMenu предоставляет оболочку для класса NativeMenu AIR.The <mx:FlexNativeMenu> tag supports the following tag attributes:

  <mx:FlexNativeMenu
    Properties
    dataDescriptor="mx.controls.treeClasses.DefaultDataDescriptor"
    dataProvider="undefined"
    keyEquivalentField="keyEquivalent"
    keyEquivalentFunction="undefined"
    keyEquivalentModifiersFunction="undefined"
    labelField="label"
    labelFunction="undefined"
    mnemonicIndexField="mnemonicIndex"
    mnemonicIndexFunction="undefined"
    showRoot="true"
 
    Events
    itemClick="No default"
    menuShow="No default"
  />

]]>mx.managers:ILayoutManagerClientmx.controls:IFlexContextMenumx.automation:IAutomationObjectflash.events:EventDispatcher Компонент FlexNativeMenu предоставляет оболочку для класса NativeMenu AIR. Компонент FlexNativeMenu предоставляет способ определения собственных меню операционной системы (например, меню окон, приложений и контекстных меню) с использованием технологий, знакомых разработчикам Flex и совместимых с другими компонентами меню Flex, например с помощью применения MXML и поставщиков данных для указания структуры меню. Однако в отличие от компонентов меню Flex, меню, определенные при помощи компонента FlexNativeMenu, в большинстве операционных систем отображаются в качестве составной части приложения AIR, а не в качестве визуальных компонентов, создаваемых программой Flex.

Как и в случае с другими компонентами меню Flex для определения структуры меню, представляемой компонентом FlexNativeMenu, создается поставщик данных, например иерархия XML или массив объектов, содержащий данные, которые будут использоваться для определения меню. Для определения метода интерпретации данных поставщика данных можно установить несколько свойств, например свойство labelField, указывающее поле данных, используемое для метки элемента меню, свойство keyEquivalentField, указывающее поле, которое позволяет определить сочетание клавиш, эквивалентное элементу меню, и свойство mnemonicIndexField, позволяющее указать поле, определяющее позицию индекса символа в метке, используемого в качестве горячих клавиш элемента меню.

С помощью поставщика данных элементов FlexNativeMenu можно указать несколько атрибутов, определяющих способ отображения элемента и его поведение, представленных в примере для следующего поставщика данных XML:

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

В следующей таблице приведены атрибуты, которые можно указать, типы их данных, их назначение, а также способ их отображения поставщиком данных при использовании класса DefaultDataDescriptor в меню для анализа поставщика данных:

АтрибутТипОписание altKey Логическое значение Указывает, должна ли клавиша Alt являться частью сочетания клавиш для элемента. cmdKey Логическое значение Примечание. Обработка этого атрибута осуществляется, начиная с версии Flex 3.2. Вместо этого используйте commandKey. Указывает, должна ли клавиша Command являться частью сочетания клавиш для элемента. commandKey Логическое значение Указывает, должна ли клавиша Command являться частью сочетания клавиш для элемента. controlKey Логическое значение Указывает, должна ли клавиша Ctrl являться частью сочетания клавиш для элемента. ctrlKey Логическое значение Примечание. Обработка этого атрибута осуществляется, начиная с версии Flex 3.2. Вместо этого используйте controlKey. Указывает, должна ли клавиша Ctrl являться частью сочетания клавиш для элемента. включено Логическое значение Указывает, может ли пункт меню быть выбран пользователем (true) или нет (false). Если значение не указано, элемент обрабатывается так, как если бы имел значение true. При применении дескриптора данных по умолчанию для указания этой характеристики поставщиками данных должен использоваться атрибут XML enabled или поле объекта. keyEquivalent Строка Указывает символ на клавиатуре, при нажатии которого событие инициируется таким же образом, как если бы был выбран пункт меню. Свойство меню keyEquivalentField или keyEquivalentFunction определяет имя поля в составе данных, указывающего эквивалентную клавишу или функцию для определения эквивалентных клавиш. (Если поставщик данных имеет формат XML E4X, для присвоения эквивалентных клавиш необходимо задать одно из этих свойств.) label Строка Задает текст, отображаемый в элементе управления. Этот элемент используется для всех типов пунктов меню, за исключением separator. Свойство меню labelField или labelFunction определяет имя поля в составе данных, указывающего метку или функцию для определения меток. (Если поставщик данных имеет формат XML E4X, для отображения метки необходимо задать одно из этих свойств.) Если поставщиком данных является массив из строк, в качестве метки используется строковое значение. mnemonicIndex Целое Указывает позицию индекса для символа в метке, используемого в качестве горячей клавиши для элемента меню. Свойство меню mnemonicIndexField или mnemonicIndexFunction определяет имя поля в составе данных, указывающее мнемонический индекс или функцию для определения мнемонического индекса. (Если поставщик данных имеет формат XML E4X, для определения мнемонического индекса в данных необходимо задать одно из этих свойств.) В качестве альтернативы, для указания на то, что символ, входящий в состав метки, является горячей клавишей элемента меню, необходимо добавить знак подчеркивания слева от этого символа. shiftKey Логическое значение Указывает, должна ли клавиша Shift являться частью сочетания клавиш для элемента. toggled Логическое значение Указывает, был ли установлен флажок. Если значение не указано, элемент обрабатывается так, как если бы было установлено значение false и элемент не был выбран. При использовании дескриптора данных по умолчанию для указания этой характеристики в поставщиках данных необходимо применять атрибут XML toggled или поле объекта. type Строка Указывает тип пункта меню. Допустимыми значениями являются separator и check. Все другие значения или узлы без указания типа обрабатываются как обычные пункты меню. При использовании дескриптора данных по умолчанию для указания этой характеристики в поставщиках данных необходимо применять атрибут XML type или поле объекта.

Для создания меню окна установите FlexNativeMenu в качестве свойства menu экземпляра Window или WindowedApplication, в котором должно появляться меню. Для создания меню приложения установите FlexNativeMenu в качестве свойства menu приложения WindowedApplication. В целях присвоения объекта FlexNativeMenu в качестве контекстного меню для части пользовательского интерфейса вызовите метод setContextMenu() для экземпляра FlexNativeMenu, передав объект пользовательского интерфейса в качестве аргумента. Вызовите метод display() компонента FlexNativeMenu для отображения меню в качестве всплывающего меню в любой области одного из окон приложения.

Для обнаружения времени инициирования команд элементов меню зарегистрируйте прослушиватель для события itemClick. Также можно зарегистрировать прослушиватель для события menuShow, определяющего открытие любого меню или подменю.

flash.display.NativeMenumx.events.FlexNativeMenuEvent

itemClick Передается при выборе пункта меню.mx.events.FlexNativeMenuEvent.ITEM_CLICKmx.events.FlexNativeMenuEvent Передается при выборе пункта меню. menuShow Передается перед отображением меню или подменю.mx.events.FlexNativeMenuEvent.MENU_SHOWmx.events.FlexNativeMenuEvent Передается перед отображением меню или подменю. FlexNativeMenu Конструктор. Конструктор. commitProperties Обрабатывает свойства, установленные в компоненте. Обрабатывает свойства, установленные в компоненте.

mx.core.UIComponent.commitProperties()

createAutomationIDPartWithRequiredProperties childproperties createAutomationIDPart child display Добавляет раскрывающееся меню в заданном положении.stageОбъект Stage, на котором будет отображаться данное меню. xЧисло пикселей по горизонтали относительно начала рабочей области, на котором будет отображаться данное меню. yЧисло пикселей по вертикали относительно начала рабочей области, на котором будет отображаться данное меню. Добавляет раскрывающееся меню в заданном положении. getAutomationChildAt index getAutomationChildren invalidateProperties itemToKeyEquivalentModifiers Возвращает модификаторы эквивалентных клавиш для заданного объекта данных на основе свойства keyEquivalentModifiersFunction.Массив модификаторов эквивалентных клавиш на основе данных. dataОбъект, который должен быть отображен. Возвращает модификаторы эквивалентных клавиш для заданного объекта данных на основе свойства keyEquivalentModifiersFunction. Если с помощью метода не удается преобразовать параметр в массив модификаторов, возвращается пустой массив. itemToKeyEquivalent Возвращает эквивалентную клавишу для заданного объекта данных на основе свойств keyEquivalentField и keyEquivalentFunction.Эквивалентная клавиша на основе данных. dataОбъект, который должен быть отображен. Возвращает эквивалентную клавишу для заданного объекта данных на основе свойств keyEquivalentField и keyEquivalentFunction. Если метод не позволяет преобразовать параметр в строку, возвращается пустая строка. itemToLabel Возвращает строку, которая должна использоваться в качестве метки элемента меню для заданного объекта данных на основе свойств labelField и labelFunction.Строка, отображаемая в зависимости от данных. dataОбъект, который должен быть отображен. Возвращает строку, которая должна использоваться в качестве метки элемента меню для заданного объекта данных на основе свойств labelField и labelFunction. Если метод не позволяет преобразовать параметр в строку, возвращается одиночный знак пробела. itemToMnemonicIndex Возвращает мнемонический индекс для заданного объекта данных на основе свойств mnemonicIndexField и mnemonicIndexFunction.Мнемонический индекс на основе данных. dataОбъект, который должен быть отображен. Возвращает мнемонический индекс для заданного объекта данных на основе свойств mnemonicIndexField и mnemonicIndexFunction. Если с помощью метода не удается преобразовать параметр в целое число, возвращается значение -1. parseLabelToMnemonicIndex Обеспечивает извлечение мнемонического индекса из метки на основе наличия символа подчеркивания.Индекс. dataАнализируемые данные для индекса. Обеспечивает извлечение мнемонического индекса из метки на основе наличия символа подчеркивания. Обеспечивает нахождение первого символа подчеркивания, если таковой существует, и его использование в качестве индекса. parseLabelToString Определяет фактическую метку, которая должна использоваться для элемента NativeMenuItem путем удаления символов подчеркивания и преобразования уцелевших символов подчеркивания, если таковые существуют.Метка. dataАнализируемые данные для метки. Определяет фактическую метку, которая должна использоваться для элемента NativeMenuItem путем удаления символов подчеркивания и преобразования уцелевших символов подчеркивания, если таковые существуют. replayAutomatableEvent event resolveAutomationIDPart criteria setContextMenu Устанавливает контекстное меню элемента InteractiveObject для основного собственного меню.componentИнтерактивный объект. Устанавливает контекстное меню элемента InteractiveObject для основного собственного меню. unsetContextMenu Обеспечивает сброс контекстного меню элемента InteractiveObject, установленного для основного собственного меню.componentИнтерактивный объект. Обеспечивает сброс контекстного меню элемента InteractiveObject, установленного для основного собственного меню. validateDisplayList validateNow Проверяет и обновляет свойства и макет этого объекта, а также перерисовывает его в случае необходимости. Проверяет и обновляет свойства и макет этого объекта, а также перерисовывает его в случае необходимости. validateProperties validateSize recursivefalse automationDelegate Объект-делегат, выполняющий обработку функций, связанных с автоматизацией. Объект-делегат, выполняющий обработку функций, связанных с автоматизацией. automationEnabled automationName automationOwner automationParent automationTabularData automationValue automationVisible dataDescriptor Объект, обеспечивающий доступ к данным и управление ими в поставщике данных. Объект, обеспечивающий доступ к данным и управление ими в поставщике данных. Элемент управления FlexNativeMenu выполняет делегирование в дескриптор данных для получения информации о его данных. Затем эти данные используются для анализа и перемещения источника данных. Дескриптор данных, определенный для FlexNativeMenu, используется во всех нижестоящих меню и подменю.

При указании этого свойства в качестве атрибута в MXML необходимо использовать ссылку на дескриптор данных, а не на имя строки дескриптора. Для установки свойства применяйте следующий формат:

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

В качестве альтернативы, в MXML свойство может быть указано в качестве вложенного подтега, как представлено в примере:

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

Значением по умолчанию является внутренний экземпляр класса DefaultDataDescriptor.

dataProvider Иерархия объектов, используемых для определения структуры пунктов меню в NativeMenu."undefined" Иерархия объектов, используемых для определения структуры пунктов меню в NativeMenu. Отдельные объекты данных, определяющие элементы меню, и элементы с нижестоящими элементами становятся меню и подменю.

Обработка исходного объекта данных элементом управления FlexNativeMenu осуществляется следующим образом:

Строка, содержащая допустимый текст XML, преобразуется в объект XML.
XMLNode преобразуется в объект XML.
XMLList преобразуется в XMLListCollection.
Любой объект, реализующий интерфейс ICollectionView, приводится к ICollectionView.
Массив преобразуется в ArrayCollection.
Объект другого типа включается в массив, причем объект становится единственной записью.

hasRoot initialized keyEquivalentField Имя поля в поставщике данных, определяющее эквивалентную клавишу для каждого элемента меню."keyEquivalent" Имя поля в поставщике данных, определяющее эквивалентную клавишу для каждого элемента меню. Набор значений определяется в классе Keyboard, в константах KEYNAME_XXXX. Обратитесь к списку значений управляющего символа, например Home, Insert и т. д.

Установка свойства keyEquivalentFunction приведет к игнорированию данного свойства.

flash.ui.Keyboard

keyEquivalentFunction Функция, определяющая эквивалентные клавиши для каждого элемента меню."undefined" Функция, определяющая эквивалентные клавиши для каждого элемента меню. Если это свойство опускается, в программе Flex используется содержимое поля или атрибута, определенное при помощи свойства keyEquivalentField. При указании данного свойства игнорируются все значения свойства keyEquivalentField.

Свойство keyEquivalentFunction подходит для обработки форматирования, локализации и независимости платформы.

Функция эквивалента клавиши должна принимать отдельный аргумент, являющийся элементом поставщика данных, и возвращать строку.

myKeyEquivalentFunction(item:Object):String

flash.ui.Keyboard

keyEquivalentModifiersFunction Функция, определяющая модификаторы эквивалентных клавиш для каждого пункта меню."undefined" Функция, определяющая модификаторы эквивалентных клавиш для каждого пункта меню. Если это свойство опускается, в программе Flex применяется собственная функция по умолчанию, позволяющая определить массив модификаторов путем поиска данных в поставщике данных со следующими (логическими) полями: altKey, commandKey, controlKey и shiftKey.

Свойство keyEquivalentModifiersFunction подходит для обработки форматирования, локализации и независимости платформы.

Функция модификаторов эквивалентных клавиш должна принимать отдельный аргумент, являющийся элементом поставщика данных, и возвращать массив имен модифицирующих клавиш.

myKeyEquivalentModifiersFunction(item:Object):Array

labelField Имя поля в поставщике данных, определяющего текст, который должен отображаться для каждого элемента меню."label" Имя поля в поставщике данных, определяющего текст, который должен отображаться для каждого элемента меню. Если поставщиком данных является массив строк, каждое строковое значение используется в качестве метки. Если поставщиком данных является объект XML E4X, необходимо явным образом установить это свойство. Например, если каждый элемент XML объекта XML E4X включает атрибут «метка», содержащий текст, который должен отображаться для каждого элемента меню, установите значение @label для свойства labelField.

Для указания символа, который должен использоваться в качестве мнемонического индекса, в метке необходимо добавить знак подчеркивания перед ним. Например, значение метки C_ut устанавливает мнемонический индекс 1. С этой целью используется только первый символ подчеркивания. Для отображения точного символа подчеркивания в метке этого можно избежать путем установки двойного подчеркивания. Например, установка значения метки C__u_t приведет к созданию пункта меню с меткой C_ut и мнемоническим индексом 3 (символ t). Если поле, определенное в свойстве mnemonicIndexField, существует и имеет значение, отличное от нуля, это значение имеет приоритет над любым значением мнемонического индекса, указанного с помощью знаков подчеркивания.

Установка свойства labelFunction приводит к игнорированию этого свойства.

labelFunction Функция, определяющая текст, который должен отображаться для каждого пункта меню."undefined" Функция, определяющая текст, который должен отображаться для каждого пункта меню. Функция метки должна обеспечивать поиск соответствующего поля или полей в поставщике данных и возвращение отображаемой строки.

Если это свойство опускается, в программе Flex применяется содержимое поля или атрибута, определенное с помощью свойства labelField. Установка данного свойства приводит к игнорированию любого значения свойства labelField.

Свойство labelFunction может быть полезным при обработке форматирования, локализации и автономности платформы.

Функция метки должна принимать отдельный аргумент, являющийся элементом поставщика данных, и возвращать строку.

myLabelFunction(item:Object):String

mnemonicIndexField Имя поля в поставщике данных, определяющее мнемонический индекс для каждого пункта меню."mnemonicIndex" Имя поля в поставщике данных, определяющее мнемонический индекс для каждого пункта меню.

Если поле, определенное с помощью этого свойства, содержит положительное число, этот мнемонический индекс имеет приоритет над любым индексом, указанным с использованием символа подчеркивания.

Установка свойства mnemonicIndexFunction приводит к игнорированию этого свойства.

labelField

mnemonicIndexFunction Функция, определяющая мнемонический индекс для каждого элемента меню."undefined" Функция, определяющая мнемонический индекс для каждого элемента меню.

Если это свойство опускается, в программе Flex используется содержимое поля или атрибута, указанного в свойстве mnemonicIndexField. Указание этого свойства приводит к игнорированию любого значения свойства mnemonicIndexField.

Если это свойство определено и для элемента данных функция возвращает положительное число, возвращаемый мнемонический индекс имеет приоритет над любым индексом, определенным с помощью подчеркивания в метке.

Свойство mnemonicIndexFunction подходит для обработки форматирования, локализации и независимости платформы.

Функция мнемонического индекса должна принимать отдельный аргумент, являющийся элементом поставщика данных, и возвращать целое число.

myMnemonicIndexFunction(item:Object):int

nativeMenu Возвращает элемент flash.display.NativeMenu, управляемый этим объектом, или null, если такой элемент отсутствует. Возвращает элемент flash.display.NativeMenu, управляемый этим объектом, или null, если такой элемент отсутствует. Любые изменения, вносимые непосредственно в экземпляр NativeMenu, могут быть потеряны при внесении изменений в меню или основного поставщика данных. nestLevel numAutomationChildren processedDescriptors showInAutomationHierarchy showRoot Логический флаг, указывающий, отобразить ли корневой узел поставщика данных.true Логический флаг, указывающий, отобразить ли корневой узел поставщика данных.

Если поставщик данных имеет корневой узел и свойство showRoot имеет значение false, элементы меню верхнего уровня, отображаемые при помощи элемента управления FlexNativeMenu, соответствуют непосредственным нижестоящим элементам корневого узла.

Этот флаг не влияет на источник без корневого узла, например на объекты списка или массива.

hasRoot

updateCompletePendingFlag Флаг, определяющий, прошел ли объект все три фазы проверки макета (при условии, что все они требовались). Флаг, определяющий, прошел ли объект все три фазы проверки макета (при условии, что все они требовались). FileSystemHistoryButton Элемент управления FileSystemHistoryButton определяет отдельный элемент управления с двумя кнопками: основной кнопкой слева и дополнительной кнопкой справа.The <mx:FileSystemHistoryButton> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <mx:FileSystemHistoryButton
    Properties
    dataProvider="undefined"
 
    Events
    itemClick="No default"
  />

]]>mx.controls:PopUpButton Элемент управления FileSystemHistoryButton определяет отдельный элемент управления с двумя кнопками: основной кнопкой слева и дополнительной кнопкой справа.

На основной кнопке может располагаться текстовая метка, значок или оба элемента. Если пользователь нажимает основную кнопку, элемент также передает событие click.

Нажатие дополнительной (правой) кнопки раскрывает меню, которое можно заполнить с помощью свойства dataProvider. Когда пользователь выбирает элемент из раскрывающегося меню, элемент управления передает событие itemClick.

Как правило, используется два FileSystemHistoryButtons с FileSystemList или FileSystemDataGrid для реализации элементов управления Back или Forward, которые позволяет пользователю перемещаться вперед или назад по истории навигации FileSystemList или FileSystemDataGrid. Для заполнения свойства dataProvider элемента управления FileSystemHistoryButton используйте привязку данных и установите ее свойство dataProvider на свойство backHistory или forwardHistory элемента управления FileSystemList или FileSystemDataGrid. Для включения или выключения этой функции необходимо выполнить привязку свойства enabled к свойству canNavigateBack или canNavigateForward элемента управления FileSystemList или FileSystemDataGrid. При использовании привязки данных для установки этих свойств Flex автоматически обновляет их, когда пользователь выполняет перемещение в рамках элемента управления FileSystemList или FileSystemDataGrid.

При использовании кнопки перемещение не выполняется отдельно. Следует выполнить запись прослушивателей события, реагирующих на события click и itemClick с целью активации кнопки. Как правило, код вызывает метод navigateBack() или navigateForward() элемента управления FileSystemList или FileSystemDataGrid для перемещения элемента управления. Для события click передача аргумента для этих методов не требуется. Для события itemClick следует выполнить передачу event.index.

mx.controls.FileSystemListmx.controls.FileSystemDataGrid

itemClick Передается, когда пользователь выбирает элемент из всплывающего меню.mx.events.MenuEvent.ITEM_CLICKmx.events.MenuEvent Передается, когда пользователь выбирает элемент из всплывающего меню. FileSystemHistoryButton Конструктор. Конструктор. dataProvider Поставщик данных для элемента управления FileSystemHistoryButton. Поставщик данных для элемента управления FileSystemHistoryButton. Должен являться коллекцией объектов File, содержащей местоположения каталогов – как правило, cвойство backHistory или forwardHistory элемента управления FileSystemList or FileSystemDataGrid. FileSystemComboBox Элемент управления FileSystemComboBox определяет элемент управления ComboBox для перемещения вверх по цепочке предшествующих каталогов из указанного каталога в файловой системе.The <mx:FileSystemComboBox> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <mx:FileSystemComboBox
    Properties
    directory="null"
    indent="8"
    showIcons="true"
 
    Styles
    computerIcon="null"
    directoryIcon="TreeNodeIcon"
 
    Events
    directoryChange="No default"
  />

]]>mx.controls:ComboBox Элемент управления FileSystemComboBox определяет элемент управления ComboBox для перемещения вверх по цепочке предшествующих каталогов из указанного каталога в файловой системе. Этот элемент управления часто используется в сочетании с элементами управления FileSystemList и FileSystemTree для изменения текущего каталога, отображаемого этими элементами управления.

В отличие от стандартного элемента управления ComboBox, для заполнения свойства dataProvider элемента управления FileSystemComboBox следует настроить свойство directory. Затем этот элемент управления автоматически устанавливает в качестве значений свойства dataProvider массив ArrayCollection объектов File, который включает все каталоги, предшествующие указанному каталогу, начиная с файла COMPUTER и заканчивая указанным каталогом.

При выборе записи в раскрывающемся списке этот элемент управления передает событие change. После передачи этого события поставщик данных и, следовательно, раскрывающийся список, содержат каталоги, предшествующие выбранному каталогу.

flash.filesystem.Filemx.controls.FileSystemListmx.controls.FileSystemTree

directoryChange Это событие передается при изменении каталога, отображаемого элементом управления, по любой причине.mx.events.FileEvent.DIRECTORY_CHANGEmx.events.FileEvent Это событие передается при изменении каталога, отображаемого элементом управления, по любой причине. FileSystemComboBox Конструктор. Конструктор. COMPUTER Константа, которая может использоваться в качестве значения для свойства directory, представляющего псевдокаталог верхнего уровня под именем «Компьютер».unknown Константа, которая может использоваться в качестве значения для свойства directory, представляющего псевдокаталог верхнего уровня под именем «Компьютер». Этот псевдокаталог содержит корневые каталоги (например, C:\ и D:\ в Windows или / в Macintosh). directory Объект File представляет каталог, предшественники которого должны отображаться в этом элементе управления.null Объект File представляет каталог, предшественники которого должны отображаться в этом элементе управления. Элемент управления отображает каждый предшествующий каталог как отдельную запись в раскрывающемся списке. indent Число пикселей, определяющее отступ перед каждой записью в раскрывающемся списке.8 Число пикселей, определяющее отступ перед каждой записью в раскрывающемся списке. showIcons Флаг, определяющий необходимость отображения значков перед именами каталогов в раскрывающемся списке.true Флаг, определяющий необходимость отображения значков перед именами каталогов в раскрывающемся списке. FileSystemEnumerationMode Класс FileSystemEnumerationMode определяет постоянные значения для свойства enumerationMode классов FileSystemList, FileSystemDataGrid и FileSystemTree.Object Класс FileSystemEnumerationMode определяет постоянные значения для свойства enumerationMode классов FileSystemList, FileSystemDataGrid и FileSystemTree.

mx.controls.FileSystemList.enumerationModemx.controls.FileSystemDataGrid.enumerationModemx.controls.FileSystemTree.enumerationMode

DIRECTORIES_FIRST Определяет необходимость отображения каталогов, затем файлов.directoriesFirst Определяет необходимость отображения каталогов, затем файлов. DIRECTORIES_ONLY Определяет необходимость отображения каталогов, но не файлов.directoriesOnly Определяет необходимость отображения каталогов, но не файлов. FILES_AND_DIRECTORIES Определяет необходимость отображения и файлов, и каталогов.filesAndDirectories Определяет необходимость отображения и файлов, и каталогов. FILES_FIRST Определяет необходимость отображения сначала файлов, а затем каталогов.filesFirst Определяет необходимость отображения сначала файлов, а затем каталогов. FILES_ONLY Определяет необходимость отображения файлов, но не каталогов.filesOnly Определяет необходимость отображения файлов, но не каталогов.