Storages.selectFile

機能/意味
ファイル選択ダイアログボックスを表示
タイプ
Storagesクラスのメソッド
構文
selectFile(params)
引数
params  データの受け渡しに用いる辞書配列を指定します。
 このメソッドに渡すとき、以下のメンバを指定することができます。また、 いくつかのメンバはこのメソッドが終わると値が変更されます。

filter
 フィルタ文字列を配列で渡します。
 フィルタ文字列は、フィルタの説明と フィルタを | (半角縦棒) で区切って指定 するもので、フィルタにはワイルドカードを指定します。一つのフィルタに複数の 拡張子が対応する場合は ; (半角セミコロン) で区切ります。
 複数のフィルタを指定するには配列で指定します。
 省略するとフィルタは用いません。

例 :
["画像ファイル(*.bmp;*.png;*.jpg;*.jpeg;*.eri;*.tlg)|*.bmp;*.png;*.jpg;*.jpeg;*.eri;*.tlg",
"スクリプトファイル(*.tjs;*.ks)|*.tjs;*.ks"]

filterIndex
 選択されているフィルタの番号 ( filter で指定したもの ) を指定します。
 1 を指定すると、filter で指定された最初のフィルタが初期状態において 選択されています。2 を指定すると2番目のフィルタが選択さている状態に なります ( 0 から始まるインデックス番号ではないことに注意してください; 先頭は 1 です )。
 省略すると先頭のフィルタが選択されます。
 また、ユーザが OK ボタンを押した場合、最後にダイアログボックス上で 選ばれていたフィルタのインデックスがこのメンバに設定されます。

name
 ファイル名を指定します。省略したり、空文字列を指定すると初期状態ではなにもファイルを選択 されていない状態にすることができます。
 また、ユーザが OK ボタンを押した場合、選択されたファイルがこのメンバに 設定されます。

initialDir
 初期状態で表示するフォルダを指定します。
 省略するとカレントディレクトリが使用されます。

title
 ダイアログボックスのタイトルを表示します。
 省略されるとデフォルトの「開く」や「名前を付けて保存」になります ( save メンバの設定によります )。

save
 ダイアログボックスの種類を指定します。
 false(デフォルト) の場合、「開く」のダイアログボックスが使われます。
 true の場合、「名前を付けて保存」のダイアログボックスが使われます。

defaultExt
 デフォルトの拡張子を指定します。ユーザが拡張子を指定しなかった場合に 自動的にこの拡張子を付加します。ここで指定する拡張子には . (ピリオド)を 指定しないでください。
 省略すると、拡張子が付加されることはありません。
戻り値
ユーザがファイルを選択して OK ボタンを押せば真、キャンセルボタンを押せば偽が戻ります。
説明
 ファイル選択ダイアログボックスを開きます。
例:
var params = %[
filter : [ "テキストファイル(*.txt)|*.txt", "バイナリファイル(*.bin)|*.bin" ],
filterIndex : 1,
name : "",
initialDir : System.exePath,
title : "ファイルを開く",
save : false,
];
if(Storages.selectFile(params))
System.inform("選択したファイルは : " + params.name);