| 附录 | 约定 | 帧
| 包 | flash.net |
| 类 | public final class FileFilter |
| 继承 | FileFilter  Object |
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
FileReference.browse() 或 FileReferenceList.browse() 时，用户系统上的哪些文件显示在出现的文件浏览对话框中。 FileFilter 实例将被传递给 browse() 函数。 如果使用 FileFilter 实例，则 FileFilter 实例中未指定的扩展名和文件类型将被过滤掉，即用户在上载时无法选择这些类型。 如果未将 FileFilter 对象传递给 browse()，则对话框中将显示所有文件。
可以采用以下两种方式之一使用 FileFilter 实例：
这两种格式不能在一个 browse() 调用中互换。 必须使用其中一种格式。
您可以将一个或多个 FileFilter 实例传递给 FileReference.browse() 或 FileReferenceList.browse()。 下例显示了创建 FileFilter 实例并将其传递给 browse() 调用的多种方式（仅适用于 Windows）。 第一个示例在 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]);
第二个示例在 browse() 调用内部创建 FileFilter 实例：
myFileReference.browse( [ new FileFilter("Images", "*.jpg;*.gif;*.png"), new FileFilter("Flash Movies", "*.swf") ] );
FileFilter.extension 属性中的扩展名列表用于过滤 Windows 中的文件，具体取决于用户选择的文件。 实际上它不显示在对话框中；要对用户显示文件类型，必须在描述字符串以及扩展名列表中列出文件类型。 在 Windows 上，描述字符串显示在对话框中。 （在 Macintosh 上不使用它。） 在 Macintosh 上，如果提供 Macintosh 文件类型的列表，则该列表用于过滤文件。 如果未提供，则使用 Windows 扩展名列表。
| 属性 | 定义方 | ||
|---|---|---|---|
 | constructor : Object
对类对象或给定对象实例的构造函数的引用。
| Object | |
| description : String
滤镜的描述字符串。
| FileFilter | ||
| extension : String
一个文件扩展名列表。
| FileFilter | ||
| macType : String
一个 Macintosh 文件类型列表。
| FileFilter | ||
| prototype : Object
[static]
对类或函数对象的原型对象的引用。
| Object | |
| 方法 | 定义方 | ||
|---|---|---|---|
|
创建一个新的 FileFilter 实例。
| FileFilter | ||
|
指示对象是否已经定义了指定的属性。
| Object | |
|
指示 Object 类的实例是否在指定为参数的对象的原型链中。
| Object | |
|
指示指定的属性是否存在、是否可枚举。
| Object | |
|
设置循环操作动态属性的可用性。
| Object | |
|
返回指定对象的字符串表示形式。
| Object | |
|
返回指定对象的原始值。
| Object | |
| description | 属性 |
隐藏继承的公共属性
显示继承的公共属性description:String [read-write]
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | 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 [read-write]
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | Flash Player 9 |
一个文件扩展名列表。 此列表指示要在文件浏览对话框中显示的文件的类型。 （用户看不到此列表，只能看到 description 属性值。） extension 属性包含以分号分隔的 Windows 文件扩展名列表，其中每个扩展名之前都具有通配符 (*)，如下面的字符串所示："*.jpg;*.gif;*.png"。
public function get extension():String
public function set extension(value:String):void
| macType | 属性 |
macType:String [read-write]
| 语言版本 : | ActionScript 3.0 |
| Player 版本 : | 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 |
| Player 版本 : | Flash Player 9 |
创建一个新的 FileFilter 实例。
参数description:String — 用户选择要上载的文件时可以看到的描述字符串。
|
|
extension:String — 文件扩展名列表，其中列出用户选择要上载的文件时可以看到的 Windows 文件格式。
|
|
macType:String (default = null)null。
|
当前页: http://livedocs.adobe.com/flash/9.0_cn/ActionScriptLangRefV3/flash/net/FileFilter.html