| 包 | 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 实例：
这两种格式不能在一个 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]);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 和 Linux 中，描述字符串显示在对话框中。（在 Macintosh® 中不使用它。）在 Macintosh 上，如果提供 Macintosh 文件类型的列表，则该列表用于过滤文件。如果未提供，则使用文件扩展名列表。
| 属性 | 定义方 | ||
|---|---|---|---|
 | constructor : Object
对类对象或给定对象实例的构造函数的引用。 | Object | |
| description : String 滤镜的描述字符串。 | FileFilter | ||
| extension : String 一个文件扩展名列表。 | FileFilter | ||
| macType : String 一个 Macintosh 文件类型列表。 | FileFilter | ||
| prototype : Object [静态]
对类或函数对象的原型对象的引用。 | Object | |
| 方法 | 定义方 | ||
|---|---|---|---|
创建一个新的 FileFilter 实例。 | FileFilter | ||
|
指示对象是否已经定义了指定的属性。 | 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)null。
|