APM ActionScript リファレンス

全件検索で「クラス」を検索した結果、66件ヒットしました。

FileReference (flash.net.FileReference) クラス

使用可能バージョン【FlashPlayer8 】
使用可能ActionScriptバージョン【ActionScript1.0 】

public class FileReference
extends Object

FileReference クラスには、ユーザーのコンピュータとサーバーとの間でファイルをアップロードおよびダウンロードするための手段があります。オペレーティングシステムのダイアログボックスを使用して、アップロードするファイルや、ダウンロード先の場所をユーザーが選択できるようにします。各 FileReference オブジェクトはユーザーのハードディスク上にある 1 つのファイルを参照し、ファイルのサイズ、タイプ、名前、作成日、変更日、クリエータタイプ (Macintosh のみ) に関する情報を保持するプロパティを備えています。

FileReference インスタンスは、次の 2 とおりの方法で作成できます。

FileReference コンストラクタで new 演算子を使用する方法 : var myFileReference = new FileReference();
FileReferenceList.browse() を呼び出す方法。これによって FileReference オブジェクトの配列が作成されます。

アップロード処理の実行中、FileReference オブジェクトのすべてのプロパティの値が、FileReference.browse() またはFileReferenceList.browse() への呼び出しによって設定されます。ダウンロード処理の実行中、name プロパティの値は onSelect が呼び出されたときに設定されます。これ以外のすべてのプロパティの値は、onComplete が呼び出されたときに設定されます。

browse() メソッドはオペレーティングシステムのダイアログボックスを開いて、ユーザーがアップロード対象のローカルファイルを選択できるようにします。FileReference.browse() メソッドを使用すると、ユーザーは単一のファイルを選択できます。
FileReferenceList.browse() メソッドを使用すると、複数のファイルを選択できます。browse() メソッドの呼び出しが正常に終了したら、FileReference.upload() メソッドを呼び出して一度に 1 つのファイルをアップロードします。FileReference.download() メソッドは、ファイルの保存先をユーザーに指定させ、リモート URL からのダウンロードを開始します。

browse() および download() 呼び出しによって生成されるダイアログボックスのデフォルトのファイルの場所を、FileReference クラスおよび FileReferenceList クラスを使って設定することはできません。ダイアログボックスに表示されるデフォルトの場所は、最後に参照されたフォルダ (その場所を決定できる場合) またはデスクトップです。これらのクラスを使って、転送ファイルを読み込んだり、転送ファイルに書き込んだりすることはできません。これらのクラスを使用しても、アップロードまたはダウンロードを開始した SWF ファイルが、アップロードファイルやダウンロードファイル、またはユーザーのディスクのファイルの場所にアクセスすることはできません。

また FileReference と FileReferenceList クラスは認証方法も提供しません。認証が必要なサーバーでは、Flash Player ブラウザプラグインを使ってファイルをダウンロードできますが、すべての Player でのアップロード、およびスタンドアローンまたは外部 Player でのダウンロードは失敗します。処理が正常に終了したかどうかを確認して、エラー処理を行う場合は、FileReference のイベントリスナーを使用します。

アップロード処理およびダウンロード処理の場合、SWF ファイルは、それ自体のドメイン内に含まれるファイルだけにアクセスできます。こうしたドメインには、クロスドメインポリシーファイルで指定されたドメインが含まれます。アップロードまたはダウンロードを開始している SWF が、ファイルサーバーと同じドメインに属していない場合、ファイルサーバーにポリシーファイルを配置する必要があります。

FileReference.browse()、FileReferenceList.browse()、または FileReference.download() メソッドへの呼び出しの実行中、SWF ファイルの再生が一時停止となる場合があります。一時停止が発生するプラットフォームは、Mac OS X の Flash Player プラグイン、Macintosh の外部 Flash Player、および Mac OS X 10 以前のスタンドアローン Flash Player です。すべての Windows 用 Flash Palyerと Mac OS X 10.2 以降で実行される Macintosh 用スタンドアローン Flash Player で実行する場合、SWF ファイルの再生は続行します。

プロパティ一覧

オプション	プロパティ	説明
	creationDate:Date(読み取り専用)	ローカルディスク上に存在するファイルの作成日です。
	creator:String(読み取り専用)	ファイルのMacintoshクリエータタイプです。
	modificationDate:Date(読み取り専用)	ローカルディスク上に存在するファイルの最終変更日です。
	name:String(読み取り専用)	ローカルディスク上に存在するファイルの名前です。
	size:Number(読み取り専用)	ローカルディスク上に存在するファイルのサイズ(バイト単位)です。
	type:String(読み取り専用)	ファイル形式です。

イベントの一覧

イベント	説明
onCancel=function(fileRef:FileReference){}	ユーザーがファイル参照ダイアログボックスを閉じると、呼び出されます。
onComplete=function(fileRef:FileReference){}	アップロード処理またはダウンロード処理が正常に完了したときに呼び出されます。
onHTTPError=function(fileRef:FileReference,httpError:Number){}	HTTPエラーのためにアップロードが失敗したときに呼び出されます。
onIOError=function(fileRef:FileReference){}	入出力エラーが発生したときに呼び出されます。
onOpen=function(fileRef:FileReference){}	アップロード処理またはダウンロード処理が開始するときに呼び出されます。
onProgress=function(fileRef:FileReference,bytesLoaded:Number, bytesTotal:Number){}	ファイルのアップロード処理中またはダウンロード処理中に定期的に呼び出されます。
onSecurityError=function(fileRef:FileReference,errorString:String){}	セキュリティエラーのためにアップロードまたはダウンロードが失敗したときに呼び出されます。
onSelect=function(fileRef:FileReference){}	ユーザーがアップロードするファイルまたはダウンロードするファイルをファイル参照ダイアログボックスから選択したときに、呼び出されます。

コンストラクタ一覧

署名	説明
FileReference()	新しいFileReferenceオブジェクトを作成します。

メソッド一覧

オプション	署名	説明
	addListener(listener:Object):Void	FileReferenceイベントリスナーが呼び出されたときに通知を受けるオブジェクトを登録します。
	browse([typelist:Array]):Boolean	アップロードするローカルファイルを選択するためのファイル参照ダイアログボックスを表示します。
	cancel():Void	このFileReferenceオブジェクトで進行中のアップロード処理またはダウンロード処理を取り消します。
	download(url:String, [defaultFileName:String]):Boolean	リモートサーバーからファイルをダウンロードするためのダイアログボックスを表示します。
	removeListener(listener:Object):Boolean	イベント通知メッセージを受信するオブジェクトのリストからオブジェクトを削除します。
	upload(url:String):Boolean	ユーザーが選択したファイルをリモートサーバーにアップロードする処理を開始します。

FileReference (flash.net.FileReference) クラスのページトップへ

APM Action Script リファレンス

FileReference (flash.net.FileReference) クラス

プロパティ一覧

イベントの一覧

コンストラクタ一覧

メソッド一覧