| 包 | 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):voidextension | 属性 |
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):voidmacType | 属性 |
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。
|
示例 ( 如何使用本示例 )
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