Пакет | flash.net |
Класс | public final class FileFilter |
Наследование | FileFilter ![]() |
Язык версии: | 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):void
extension | свойство |
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):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 — Список расширений файлов, указывающий, какие форматы файлов отображаются для пользователей при выборе файлов для загрузки.
| |
macType:String (default = null ) — Список типов файлов Macintosh, указывающий, какие типы файлов видны пользователям при выборе файлов для загрузки. Если ни одно значение не передается, данный параметр получает значение 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