パッケージ | 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 インスタンスは次の 2 つの方法で使用できます。
- 説明と ファイル拡張子のみ
- 説明と ファイル拡張子および Macintosh ファイルタイプ
これら 2 つの形式を browse メソッドの 1 回の呼び出しの中に混在させることはできません。 どちらか一方を使用する必要があります。
次の例のように、browse メソッドには 1 つ以上の 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):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 に設定されます。
|
例 ( この例の使用方法 )
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, 10:34 AM Z