Главная / Action Script 3
Пакетflash.net
Классpublic final class FileFilter
НаследованиеFileFilter Inheritance Object

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Класс FileFilter применяется для обозначения тех файлов в системе пользователя, которые отображаются в диалоговом окне выбора файлов, появляющемся при выборе метода 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.



Общедоступные свойства
 СвойствоОпределено
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
  description : String
Строка описания для фильтра.
FileFilter
  extension : String
Список расширений файлов.
FileFilter
  macType : String
Список типов файлов Macintosh.
FileFilter
 Inheritedprototype : Object
[статические] Ссылка на модель объекта класса или функции.
Object
Общедоступные методы
 МетодОпределено
  
FileFilter(description:String, extension:String, macType:String = null)
Создает новый экземпляр класса FileFilter.
FileFilter
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
 Inherited
Возвращает строковое представление заданного объекта.
Object
 Inherited
Возвращает элементарное значение заданного объекта.
Object
Сведения о свойстве
descriptionсвойство
description:String  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 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
Версии среды выполнения:  1.0 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
Версии среды выполнения:  1.0 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
Версии среды выполнения:  1.0 9

Создает новый экземпляр класса FileFilter.

Параметры
description:String — Строка описания, отображаемая для пользователей, выбирающих файлы для отправки.
 
extension:String — Список расширений файлов, указывающий, какие форматы файлов Windows отображаются для пользователей при выборе файлов для отправки.
 
macType:String (default = null) — Список типов файлов Macintosh, указывающий, какие типы файлов видны пользователям при выборе файлов для отправки. Если ни одно значение не передается, данный параметр получает значение null.