パッケージflash.net
public final class FileFilter
継承FileFilter Inheritance Object

FileFilter クラスは、FileReference.browse() または FileReferenceList.browse() が呼び出されたときに表示されるファイル参照ダイアログボックスに、ユーザーシステムのどのファイルが表示されるかを示すために使用されます。FileFilter インスタンスは browse() 関数に渡します。FileFilter インスタンスを使用する場合、FileFilter インスタンスに指定されていない拡張子およびファイルタイプは、フィルタ処理で除外されます。つまり、ユーザーはそれらをアップロードに選択できません。FileFilter オブジェクトを browse() に渡さないと、すべてのファイルがダイアログボックスに表示されます。

FileFilter インスタンスは次の 2 つの方法で使用できます。

この 2 つの形式は、1 つの browse() 呼び出しの中で混在できません。どちらか一方を使用する必要があります。

1 つまたは複数の 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]);

2 番目の例では、browse() 呼び出しの中で FileFilter インスタンスを作成しています。

 myFileReference.browse( [ new FileFilter("Images", "*.jpg;*.gif;*.png"), new FileFilter("Flash Movies", "*.swf") ] );

FileFilter.extension プロパティの拡張子のリストは、ユーザーが選択したファイルタイプに応じて、Windows のファイルをフィルタにかけるために使用します。ダイアログボックスに実際に表示されるわけではありません。ファイルタイプをユーザーに表示するには、拡張子リストのほか、説明用ストリングにもファイルタイプをリストする必要があります。説明用ストリングは、Windows のダイアログボックスに表示されます。Macintosh では使用されません。Macintosh では、Macintosh のファイルタイプリストを指定すると、このリストがファイルのフィルタリングに使用されます。これを指定しない場合は、Windows の拡張子リストが使用されます。


パブリックプロパティ
 プロパティ定義
 Inheritedconstructor : Object
特定のオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
  description : String
フィルタの説明用文字列です。
FileFilter
  extension : String
ファイル拡張子のリストです。
FileFilter
  macType : String
Macintosh ファイルタイプのリストです。
FileFilter
 Inheritedprototype : Object
[static] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
パブリックメソッド
 メソッド定義
  FileFilter(description:String, extension:String, macType:String = null)
新しい FileFilter インスタンスを作成します。
FileFilter
 InheritedhasOwnProperty(name:String):Boolean
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
 InheritedisPrototypeOf(theClass:Object):Boolean
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
 InheritedpropertyIsEnumerable(name:String):Boolean
指定されたプロパティが存在し、列挙可能かどうかを示します。
Object
 InheritedsetPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
 InheritedtoString():String
指定されたオブジェクトのストリング表現を返します。
Object
 InheritedvalueOf():Object
指定されたオブジェクトのプリミティブ値を返します。
Object
プロパティの詳細
descriptionプロパティ
description:String  [read-write]

フィルタの説明用文字列です。説明は、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]

ファイル拡張子のリストです。このリストは、ファイル参照ダイアログボックスに表示するファイルの種類を示します。(リストは表示されません。ユーザーには description プロパティの値のみが表示されます)。extension プロパティには、次のストリングに示すように、セミコロンで区切った Windows ファイル拡張子のリストが含まれ、各拡張子の前にはワイルドカード (*) を付けます。 "*.jpg;*.gif;*.png".

実装
    public function get extension():String
    public function set extension(value:String):void
macTypeプロパティ 
macType:String  [read-write]

Macintosh ファイルタイプのリストです。このリストは、ファイル参照ダイアログボックスに表示するファイルの種類を示します。(このリスト自体は表示されません。ユーザーには description プロパティの値のみが表示されます)。macType プロパティには、次のストリングに示すように、Macintosh ファイルタイプをセミコロンで区切ったリストが含まれます。 "JPEG;jp2_;GIFF".

実装
    public function get macType():String
    public function set macType(value:String):void
コンストラクタの詳細
FileFilter()コンストラクタ
public 関数 FileFilter(description:String, extension:String, macType:String = null)

新しい FileFilter インスタンスを作成します。

パラメータ
description:String — ユーザーがアップロードするファイルを選択したときに表示される説明用ストリングです。
 
extension:String — ユーザーがアップロードするファイルを選択したときに表示される Windows ファイル形式を示すファイル拡張子のリストです。
 
macType:String (default = null) — ユーザーがアップロードするファイルを選択したときに表示されるファイルタイプを示す Macintosh ファイルタイプのリストです。値を指定しないと、このパラメータは null に設定されます。



© 2004-2006 Adobe Systems Incorporated. All rights reserved.
2006.08.17, 午後 11:21, GMT-07:00

 

このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。 | コメントレポート

現在のページ: http://livedocs.adobe.com/flex/2_jp/langref/flash/net/FileFilter.html