flash.net.FileReferenceList (Flex™ 2 リファレンスガイド)

	プロパティ	定義
		constructor : Object 指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。	Object
		fileList : Array [read-only] `FileReference` オブジェクトの配列です。	FileReferenceList
		prototype : Object [static] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。	Object

	メソッド	定義
		FileReferenceList() 新しい FileReferenceList オブジェクトを作成します。	FileReferenceList
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void リスナーがイベントの通知を受け取るように、イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録します。	EventDispatcher
		browse(typeFilter:Array = null):Boolean アップロードするローカルファイルを 1 つ以上選択できるファイル参照ダイアログボックスを表示します。	FileReferenceList
		dispatchEvent(event:Event):Boolean イベントをイベントフローに送出します。	EventDispatcher
		hasEventListener(type:String):Boolean EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。	EventDispatcher
		hasOwnProperty(name:String):Boolean 指定されたプロパティがオブジェクトに定義されているかどうかを示します。	Object
		isPrototypeOf(theClass:Object):Boolean Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。	Object
		propertyIsEnumerable(name:String):Boolean 指定されたプロパティが存在し、列挙できるかどうかを示します。	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void EventDispatcher オブジェクトからリスナーを削除します。	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void ループ処理に対するダイナミックプロパティの可用性を設定します。	Object
		toString():String 指定されたオブジェクトのストリング表現を返します。	Object
		valueOf():Object 指定されたオブジェクトのプリミティブな値を返します。	Object
		willTrigger(type:String):Boolean 指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。	EventDispatcher

一覧	定義
activate	Flash Player がオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。	EventDispatcher
cancel	ユーザーがファイル参照ダイアログボックスを閉じると、送出されます	FileReferenceList
deactivate	Flash Player がオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。	EventDispatcher
select	ユーザーがアップロードするファイルをファイル参照ダイアログボックスから 1 つ以上選択したときに送出されます。	FileReferenceList

プロパティの詳細

fileList

プロパティ

fileList:Array [read-only]

FileReference オブジェクトの配列です。

FileReferenceList.browse() メソッドが呼び出され、ユーザーが browse() メソッドによって開いたダイアログボックスからファイルを選択すると、このプロパティに FileReference オブジェクトの配列が設定されます。このオブジェクトは、ユーザーが選択したファイルを表します。その後、この配列を使用して、FileReference.upload() メソッドで各ファイルをアップロードできます。一度に 1 つのファイルをアップロードする必要があります。

fileList プロパティは、browse() が FileReferenceList オブジェクトで呼び出されるたびに新しく設定されます。

FileReference オブジェクトのプロパティについての説明は、FileReference クラスの説明にあります。

実装
public function get fileList():Array

コンストラクタの詳細

FileReferenceList

()

コンストラクタ

public 関数 FileReferenceList()

新しい FileReferenceList オブジェクトを作成します。FileReferenceList オブジェクトで browse() メソッドを呼び出し、ユーザーが 1 つまたは複数のファイルを選択するまでは、FileReferenceList オブジェクトには何も含まれません。FileReference オブジェクトで browse() を呼び出すと、このオブジェクトの fileList プロパティに FileReference オブジェクトの配列が設定されます。

メソッドの詳細

browse

()

メソッド

public function browse(typeFilter:Array = null):Boolean

アップロードするローカルファイルを 1 つ以上選択できるファイル参照ダイアログボックスを表示します。このダイアログボックスは、オペレーティングシステムのネイティブのダイアログボックスです。このメソッドを呼び出して、ユーザーが正常にファイルを選択すると、この FileReferenceList オブジェクトの fileList プロパティに FileReference オブジェクトの配列が設定されます。FileReference オブジェクトはユーザーが選択したファイルごとに作成されます。これ以降 FileReferenceList.browse() メソッドが呼び出されるたびに、FileReferenceList.fileList プロパティは、ダイアログボックスでユーザーが選択したファイルにリセットされます。

どのファイルをダイアログボックスに表示するかを決定するために、typeFilter パラメータを使用できます。

FileReferenceList オブジェクトに対し、一度に 1 つの FileReference.browse() セッション、FileReference.download() セッション、または FileReferenceList.browse() セッションだけを実行できます。これは、一度に 1 つのダイアログボックスしか開けないからです。

パラメータ

typeFilter:Array (default = null) — ダイアログボックスに表示するファイルをフィルタにかける場合に使用する FileFilter インスタンスの配列です。このパラメータを省略すると、すべてのファイルが表示されます。詳細については、FileFilter クラスを参照してください。

戻り値

Boolean — パラメータが有効で、ファイル参照ダイアログボックスが表示された場合に、true を返します。

イベント

	`select:Event` — アップロード対象の項目をユーザーがダイアログボックスで正常に選択したときに呼び出されます。

	`cancel:Event` — ユーザーが [キャンセル] をクリックするかダイアログボックスを閉じた場合に、呼び出されます。

スロー

	`IllegalOperationError` — 次の理由でスローされます。1) 他の FileReference ブラウズセッション、または FileReferenceList ブラウズセッションが進行中の場合。ファイルのブラウズセッションは、一度に 1 つのみ実行できます。2) ユーザーの "mms.cfg" ファイルの設定により、この操作が禁止されている場合。

	`ArgumentError` — `typeFilter` 配列に、正しい形式の FileFilter オブジェクトが含まれていないと、例外がスローされます。正しいフィルタ形式の詳細については、FileFilter の説明を参照してください。

イベントの詳細

cancel

event

イベントオブジェクトの型: flash.events.Event
Event.type property = flash.events.Event.CANCEL

ユーザーがファイル参照ダイアログボックスを閉じると、送出されます(このダイアログボックスは、FileReferenceList.browse() メソッド、FileReference.browse() メソッド、またはFileReference.download() メソッドを呼び出したときに開かれます)。

cancel イベントオブジェクトの type プロパティの値を定義します。

このイベントには、次のプロパティがあります。

プロパティ	値
`bubbles`	`false`
`cancelable`	`false` は、キャンセルするデフォルトの動作がないことを示します。
`currentTarget`	イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
`target`	操作をキャンセルするオブジェクトへの参照です。

関連項目

FileReferenceList.browse()

select

event

イベントオブジェクトの型: flash.events.Event
Event.type property = flash.events.Event.SELECT

ユーザーがアップロードするファイルをファイル参照ダイアログボックスから 1 つ以上選択したときに送出されます。(このダイアログボックスは、FileReferenceList.browse() メソッド、FileReference.browse() メソッド、またはFileReference.download() メソッドを呼び出したときに開かれます)。ユーザーがファイルを選択し、[保存] などをクリックして操作を確認すると、ユーザーが選択したファイルを表す FileReference オブジェクトが FileReferenceList オブジェクトに設定されます。

select イベントオブジェクトの type プロパティの値を定義します。

このイベントには、次のプロパティがあります。

プロパティ	値
`bubbles`	`false`
`cancelable`	`false` は、キャンセルするデフォルトの動作がないことを示します。
`currentTarget`	イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
`target`	アイテムが選択された FileReference オブジェクトです。

関連項目

FileReferenceList.browse()

Adobe^® Flex™ 2 リファレンスガイド		すべてのパッケージ \| すべてのクラス \| \| 索引 \| 付録 \| 規則 \| フレーム内に表示フレームなしバージョン
Class FileReferenceList	プロパティ \| メソッド \| イベント

パッケージ	flash.net
	public class FileReferenceList
継承	FileReferenceList EventDispatcher Object