패키지flash.net
클래스public final class FileFilter
상속FileFilter Inheritance Object

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

FileFilter 클래스는 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]);

FileFilter.extension 속성의 확장명 목록을 사용하여 파일 브라우저 대화 상자에 표시된 파일을 필터링합니다. 이 목록은 실제로 대화 상자에 표시되지 않습니다. 사용자에게 파일 유형을 표시하려면 설명 문자열 및 확장명 목록에 파일 유형을 나열해야 합니다. 설명 문자열은 Windows 및 Linux 대화 상자에 표시됩니다. 이 기능을 Macintosh®에서는 사용할 수 없습니다. Macintosh의 경우 Macintosh 파일 유형 목록이 제공되면 이 목록을 사용하여 파일을 필터링할 수 있습니다. 그렇지 않으면 파일 확장명 목록이 사용됩니다.



Public 속성
 속성다음에 의해 정의됨
 Inheritedconstructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다.
Object
  description : String
필터에 대한 설명 문자열입니다.
FileFilter
  extension : String
파일 확장명 목록입니다.
FileFilter
  macType : String
Macintosh 파일 유형 목록입니다.
FileFilter
 Inheritedprototype : Object
[정적] 클래스 또는 함수 객체의 프로토타입 객체에 대한 참조입니다.
Object
Public 메서드
 메서드다음에 의해 정의됨
  
FileFilter(description:String, extension:String, macType:String = null)
새 FileFilter 인스턴스를 만듭니다.
FileFilter
 Inherited
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다.
Object
 Inherited
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다.
Object
 Inherited
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다.
Object
 Inherited
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다.
Object
 Inherited
지정된 객체의 문자열 표현을 반환합니다.
Object
 Inherited
지정된 객체의 프리미티브 값을 반환합니다.
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 속성에는 "JPEG;jp2_;GIFF" 문자열과 같이 세미콜론으로 구분된 Macintosh 파일 유형 목록이 포함되어 있습니다.



구현
    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) — 업로드할 파일 선택 시 선택할 수 있는 Macintosh 파일 유형이 포함된 파일 유형 목록입니다. 전달된 값이 없으면 이 매개 변수는 null로 설정됩니다.