| Пакет | flash.net |
| Класс | public final class FileFilter |
| Наследование | FileFilter  Object |
| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9 |
FileReference.browse(), метода FileReferenceList.browse() или метода browse объекта File, FileReference или FileReferenceList. Экземпляры FileFilter в качестве значений дополнительного параметра typeFilter этого метода. При использовании экземпляра FileFilter расширения и типы файлов, которые не указаны в экземпляре FileFilter, отфильтровываются. Другими словами, они недоступны для выбора пользователем. Если методу не передается какой-либо объект FileFilter, все файлы отображаются в диалоговом окне.
Экземпляры FileFilter можно использовать одним из двух следующих способов:
- Описание, в котором приводятся только расширения файлов
- Описание с расширениями файлов и типами файлов Macintosh
Эти два формата не являются взаимозаменяемыми в одном вызове метода browse. Следует выбрать только один из них.
Можно передать один или несколько экземпляров 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]);
Или в приложении AIR:
var imagesFilter:FileFilter = new FileFilter("Images", "*.jpg;*.gif;*.png");
var docFilter:FileFilter = new FileFilter("Documents", "*.pdf;*.doc;*.txt");
var myFile:File = new File();
myFile.browseForOpen("Open", [imagesFilter, docFilter]);
Список расширений в свойстве FileFilter.extension используется для фильтрации файлов, отображаемых в диалоговом окне обзора файлов. На самом деле этот список не отображается в диалоговом окне. Чтобы отобразить типы файлов для пользователей, вам необходимо перечислить типы файлов в строке описания, а также в списке расширений. В операционной системе Windows и Linux строка описания отображается в диалоговом окне. (Не используется в платформе Macintosh®.) На компьютерах Macintosh для фильтрации файлов используется сам предоставленный список типов файлов Macintosh. В противном случае используется список расширений файлов.
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства| Свойство | Определено | ||
|---|---|---|---|
 | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| description : String
Строка описания для фильтра. | FileFilter | ||
| extension : String
Список расширений файлов. | FileFilter | ||
| macType : String
Список типов файлов Macintosh. | FileFilter | ||
| Метод | Определено | ||
|---|---|---|---|
Создает новый экземпляр FileFilter. | FileFilter | ||
|
Показывает, определено ли заданное свойство для объекта. | Object | |
|
Показывает, есть ли экземпляр класса 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):voidextension | свойство |
extension:String| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Список расширений файлов. Данный список содержит типы файлов, которые будут отображаться в диалоговом окне выбора файлов. (Пользователь видит не сам список, а только значение свойства description.) Свойство extension содержит список расширений файлов, где в качестве разделителя значений используется точка с запятой. Перед каждым расширением добавляется подстановочный знак (*), как показано в следующей строке: "*.jpg;*.gif;*.png".
Реализация
public function get extension():String public function set extension(value:String):voidmacType | свойство |
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):voidFileFilter | () | Конструктор |
public function FileFilter(description:String, extension:String, macType:String = null)| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Создает новый экземпляр FileFilter.
Параметрыdescription:String — Строка описания, отображаемая для пользователей, выбирающих файлы для загрузки.
| |
extension:String — Список расширений файлов, указывающий, какие форматы файлов отображаются для пользователей при выборе файлов для загрузки.
| |
macType:String (default = null)null.
|
Пример ( Использование этого примера )
var buttonShape:Shape = new Shape();
buttonShape.graphics.beginFill(0x336699);
buttonShape.graphics.drawCircle(50, 50, 25);
var button = new SimpleButton(buttonShape, buttonShape, buttonShape, buttonShape);
addChild(button);
var fileRef:FileReference= new FileReference();
button.addEventListener(MouseEvent.CLICK, onButtonClick);
function onButtonClick(e:MouseEvent):void {
fileRef.browse([new FileFilter("Images", "*.jpg;*.gif;*.png")]);
fileRef.addEventListener(Event.SELECT, onFileSelected);
}
function onFileSelected(e:Event):void {
fileRef.addEventListener(Event.COMPLETE, onFileLoaded);
fileRef.load();
}
function onFileLoaded(e:Event):void {
var loader:Loader = new Loader();
loader.loadBytes(e.target.data);
addChild(loader);
}
Tue Jun 12 2018, 11:34 AM Z