API version 4

FileSystem.OpenDialogメソッド

iOSAndroidWindows

説明

ダイアログで開くファイルを選択します。

ファイルを開くダイアログを表示し、ユーザが開くファイルを選択します。選択したファイルは読み込みモードで開かれ、Fileオブジェクトに割り当てられます。

ダイアログでキャンセルが選択された場合は、PKG-21例外が発生します。

noConfirmパラメータに$TRUEを指定すると警告ダイアログは表示されずにマウントされます。

また、警告ダイアログの「今後、このメッセージを表示しない」をチェックしたと見なされます。

Android版
Biz/Browser HT ver 1.2.6より、Android11以降の端末でアプリケーション専用ディレクトリ以外のディレクトリにあるファイルにアクセスする場合、OSに対してユーザー操作で許可をとる必要があります。
詳しくはAndroid11以降のファイルアクセスを参照してください。

呼出形式

var f = fs.OpenDialog( title, filter, suffix, fileName )

戻り値

開いたファイルのFileオブジェクト

引数

String title

ダイアログに表示するタイトル

String filter

ダイアログに表示するファイル名のフィルタ

表示する内容とワイルドカードのペアを"="で接続して指定します。

複数のワイルドカードを指定する場合は、";"で区切ります。複数のフィルタを指定する場合、"/"で区切ります。

ファイル名として有効な文字とワイルドカード文字"*"、"?"だけが指定できます。空白文字を含めることはできません。

（例）

フィルタ文字列	表示する内容	表示されるファイル
"テキストファイル(.txt)=.txt"	テキストファイル(*.txt)	拡張子がtxtのファイル
"テキスト(.txt,.log)=.txt;.log"	テキスト(.txt,.log)	拡張子がtxtとlogのファイル
"テキスト形式=.txt/ワープロ形式=.doc"	テキスト形式	拡張子がtxtのファイル
"テキスト形式=.txt/ワープロ形式=.doc"	ワープロ形式	拡張子がdocのファイル
"すべてのファイル=."	すべてのファイル	すべてのファイル

String suffix

標準の拡張子

ユーザがファイル名に拡張子を付加しない場合に、ピリオドとsuffixに指定した文字の左から3文字が拡張子として採用されます。suffixにはファイル名として有効な文字だけが指定できます。

String fileName

ファイル名の初期値

絶対パスを含んだファイル名を指定すると初期フォルダを指定することができます。

例外

RTM-3

ファイルをオープンできません

PKG-19

ファイル名が不正です

PKG-20

ファイルセレクションダイアログが開けません

PKG-21

ファイル選択はユーザにより中止されました

使用例

var fs = new FileSystem;
var f = fs.OpenDialog("ファイルを開く", "テキストファイル(*.txt)=*.txt", "txt", "Readme.txt");
var data = f.Read();
f.Close();