API version 21

FileSystem.CopyFileFromExternalStorageメソッド

iOSAndroidWindows

説明

USBで接続したストレージ等の外部ストレージから、ファイルをコピーします。

このメソッドを呼び出すとファイル選択画面が表示され、選択したファイルがコピーされます。

ただし、一部のディレクトリはOSの制限によりコピー元として選択できない場合があります。

呼出形式

fs.CopyFileFromExternalStorage( path [, mimeType [,mode]])

戻り値

なし

引数

String path

コピー先のファイルパスを指定します。

ディレクトリのパスが指定された場合、指定されたディレクトリ以下にファイルを保存します。

String mimeType

"image/jpeg"といったMIME Typeを指定します。

指定したMIME Typeに対応したファイルだけが表示されます。

省略した場合は、"*/*"を指定した場合と同じ動作になります。

integer mode

上書き保存に関する動作を指定します。

以下の値を指定します。

定数	値	説明
FileSystem.ALWAYS_OVERWRITE	0	同名ファイルを上書きします。
FileSystem.NOT_COPY_FILE_EXISTS	1	コピー先に同名ファイルが存在する場合は例外RTM-132を発生させてコピーしません。
FileSystem.NOT_OVERWRITE	3	コピー先に同名ファイルが存在する場合、例外を発生させず処理を終了します。

省略した場合は、FileSystem.ALWAYS_OVERWRITEと同じ動作になります。

例外

FUNC-4

引数の値が不正です

RTM-24

パスが不正です

RTM-131

ファイル操作に失敗しました

RTM-132

このフォルダには既に’xxx’ファイルが存在します。

使用例

var fs = new FileSystem;
fs.CopyFileFromExternalStorage("/temp/sample.jpg", "image/jpeg", FileSystem.NOT_OVERWRITE);