FileFilter 类用于指示在调用 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]);
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 文件类型的列表,则该列表用于过滤文件。如果未提供,则使用文件扩展名列表。