包 | flash.net |
类 | public final class FileFilter |
继承 | FileFilter Object |
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 1.0, Flash Player 9 |
FileReference.browse()
方法、FileReferenceList.browse()
方法或调用 File、FileReference 或 FileReferenceList 对象的 browse 方法时显示的文件浏览对话框中显示用户系统上的哪些文件。FileFilter 实例作为可选 typeFilter
参数的值传递给该方法。如果使用 FileFilter 实例,则会滤除 FileFilter 实例中未指定的扩展名和文件类型,即用户无法选择这些类型。如果未向方法传递任何 FileFilter 对象,则对话框中将显示所有文件。
可以采用以下两种方式之一使用 FileFilter 实例:
- 仅包含文件扩展名的描述
- 包含文件扩展名和 Macintosh 文件类型的描述
这两种格式不能在一个 browse 方法调用中互换。必须使用其中一种格式。
可以向 browse 方法传递一个或多个 FileFilter 实例,如下所示:
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 | 属性 |
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:04 AM Z