| Пакет | flash.net |
| Класс | public final class FileFilter |
| Наследование | FileFilter  Object |
| Язык версии : | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9 |
FileReference.browse() или FileReferenceList.browse(). Экземпляры FileFilter передаются в функцию browse(). При использовании экземпляра FileFilter расширения и типы файлов, которые не указаны в экземпляре FileFilter, отфильтровываются. Другими словами, они недоступны пользователю при выборе объектов для отправки. Если методу browse() не передается какой-либо объект FileFilter, все файлы отображаются в диалоговом окне.
Экземпляры FileFilter можно использовать одним из двух следующих способов:
В рамках одного вызова browse() эти два формата не являются взаимозаменяемыми. Следует выбрать только один из них.
Методам FileReference.browse() или FileReferenceList.browse() можно передать один или несколько экземпляров FileFilter. В следующем примере представлены различные способы создания и передачи экземпляров FileFilter вызову browse() (только для ОС Windows). В первом примере экземпляры FileFilter создаются за пределами вызова browse():
var imagesFilter:FileFilter = new FileFilter("Images", "*.jpg;*.gif;*.png");
var docFilter:FileFilter = new FileFilter("Documents", "*.pdf;*.doc;*.txt");
var myFileReference:FileReference = new FileReference();
myFileReference.browse([imagesFilter, docFilter]);
Во втором примере экземпляры FileFilter создаются в рамках вызова browse():
myFileReference.browse( [ new FileFilter("Images", "*.jpg;*.gif;*.png"), new FileFilter("Flash Movies", "*.swf") ] );
Список расширений в свойстве FileFilter.extension используется для фильтрации файлов в операционной системе Windows в зависимости от выбранного пользователем файла. На самом деле он не отображается в диалоговом окне. Чтобы отобразить типы файлов для пользователей, вам необходимо перечислить типы файлов в строке описания, а также в списке расширений. В операционной системе Windows строка описания отображается в диалоговом окне. (Не используется в платформе Macintosh.) На компьютерах Macintosh для фильтрации файлов используется сам предоставленный список типов файлов Macintosh. В противном случае используется список расширений Windows.
| Свойство | Определено | ||
|---|---|---|---|
 | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| description : String
Строка описания для фильтра. | FileFilter | ||
| extension : String
Список расширений файлов. | FileFilter | ||
| macType : String
Список типов файлов Macintosh. | FileFilter | ||
| prototype : Object [статические]
Ссылка на модель объекта класса или функции. | Object | |
| Метод | Определено | ||
|---|---|---|---|
Создает новый экземпляр класса FileFilter. | FileFilter | ||
|
Показывает, определено ли заданное свойство для объекта. | Object | |
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
|
Задает доступность динамического свойства для операций цикла. | Object | |
|
Возвращает строковое представление заданного объекта. | Object | |
|
Возвращает элементарное значение заданного объекта. | Object | |
| description | свойство |
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойстваdescription:String [чтение и запись] | Язык версии : | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Строка описания для фильтра. Описание представлено пользователю в диалоговом окне, которое открывается при вызове FileReference.browse() или FileReferenceList.browse(). Строка описания содержит строку, например "Images (*.gif, *.jpg, *.png)", которая помогает проинформировать пользователя о том, какие типы файлов могут быть переданы или загружены. Обратите внимание на то, что фактические типы файлов, поддерживаемые данным объектом FileReference, хранятся в свойстве extension.
public function get description():String public function set description(value:String):void| extension | свойство |
extension:String [чтение и запись] | Язык версии : | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Список расширений файлов. Данный список содержит типы файлов, которые будут отображаться в диалоговом окне выбора файлов. (Пользователь видит не сам список, а только значение свойства description.) Свойство extension содержит список расширений файлов Windows, где в качестве разделителя значений используется точка с запятой. Перед каждым расширением добавляется подстановочный знак (*), как показано в следующей строке: "*.jpg;*.gif;*.png".
public function get extension():String public function set extension(value:String):void| macType | свойство |
macType:String [чтение и запись] | Язык версии : | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Список типов файлов Macintosh. Данный список содержит типы файлов, которые будут отображаться в диалоговом окне выбора файлов. (Пользователь видит не сам список, а только значение свойства description.) Свойство macType содержит список типов файлов Macintosh, где в качестве разделителя используется точка с запятой, как показано в следующей строке: "JPEG;jp2_;GIFF".
public function get macType():String public function set macType(value:String):void| FileFilter | () | Конструктор |
public function FileFilter(description:String, extension:String, macType:String = null)| Язык версии : | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Создает новый экземпляр класса FileFilter.
Параметрыdescription:String — Строка описания, отображаемая для пользователей, выбирающих файлы для отправки.
| |
extension:String — Список расширений файлов, указывающий, какие форматы файлов Windows отображаются для пользователей при выборе файлов для отправки.
| |
macType:String (default = null)null.
|