| window.runtime 属性 | window.runtime.flash.net.FileFilter |
| 继承 | FileFilter  Object |
FileReference.browse() 方法、FileReferenceList.browse() 方法或调用 File、FileReference 或 FileReferenceList 对象的 browse 方法时显示的文件浏览对话框中显示用户系统上的哪些文件。FileFilter 实例作为可选 typeFilter 参数的值传递给该方法。如果使用 FileFilter 实例，则会滤除 FileFilter 实例中未指定的扩展名和文件类型，即用户无法选择这些类型。如果未向方法传递任何 FileFilter 对象，则对话框中将显示所有文件。
可以采用以下两种方式之一使用 FileFilter 实例：
这两种格式不能在一个 browse 方法调用中互换。必须使用其中一种格式。
可以向 browse 方法传递一个或多个 FileFilter 实例，如下所示（仅限 Windows）：
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]);
var imagesFilter = new air.FileFilter("Images", "*.jpg;*.gif;*.png");
var docFilter = new air.FileFilter("Documents", "*.pdf;*.doc;*.txt");
var myFile = new air.File();
myFile.browseForOpen("Open", [imagesFilter, docFilter]);
属性 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(description:String, extension:String, macType:String = null)
创建一个新的 FileFilter 实例。 | FileFilter | ||
| hasOwnProperty(name:String):Boolean
指示对象是否已经定义了指定的属性。 | Object | |
| isPrototypeOf(theClass:Object):Boolean
指示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | |
| propertyIsEnumerable(name:String):Boolean
指示指定的属性是否存在、是否可枚举。 | Object | |
| setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
设置循环操作动态属性的可用性。 | Object | |
| toString():String
返回指定对象的字符串表示形式。 | Object | |
| valueOf():Object
返回指定对象的原始值。 | Object | |
| description | 属性 |
隐藏继承的公共属性
显示继承的属性description:String [读写]
滤镜的描述字符串。调用 FileReference.browse() 或 FileReferenceList.browse() 时，用户将在打开的对话框中看到此描述。描述字符串包含诸如 "Images (*.gif, *.jpg, *.png)" 之类的字符串，这些字符串有助于用户辨认可以上载或下载的文件类型。请注意，此 FileReference 对象支持的实际文件类型存储在 extension 属性中。
| extension | 属性 |
extension:String [读写]
一个文件扩展名列表。此列表指示要在文件浏览对话框中显示的文件的类型。（用户看不到此列表，只能看到 description 属性值。） extension 属性包含以分号分隔的 Windows 文件扩展名列表，其中每个扩展名之前都具有通配符 (*)，如下面的字符串所示："*.jpg;*.gif;*.png"。
| macType | 属性 |
macType:String [读写]
一个 Macintosh 文件类型列表。此列表指示要在文件浏览对话框中显示的文件的类型。（用户看不到此列表，只能看到 description 属性值。） macType 属性包含以分号分隔的 Macintosh 文件类型列表，如下面的字符串所示："JPEG;jp2_;GIFF"。
| FileFilter | () | 构造函数 |
function FileFilter(description:String, extension:String, macType:String = null)创建一个新的 FileFilter 实例。
参数description:String — 用户选择要上载的文件时可以看到的描述字符串。
| |
extension:String — 文件扩展名列表，其中列出用户选择要上载的文件时可以看到的 Windows 文件格式。
| |
macType:String (default = null)null。
|