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);