Files
krkr2doc/docs/kr2doc/contents/f_Storages_selectFile.html
2016-09-08 17:50:19 +09:00

106 lines
6.5 KiB
HTML

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="ja" lang="ja">
<!-- generated by to_html.pl from f_Storages.xml -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<title>selectFile - ファイル選択ダイアログボックスを表示</title>
<meta name="author" content="W.Dee" />
<meta http-equiv="Content-Style-Type" content="text/css" />
<meta http-equiv="Content-Script-Type" content="text/javascript" />
<link href="funcref.css" type="text/css" rel="stylesheet" title="クラスリファレンス用標準スタイル" />
<link href="mailto:[email protected]" rev="Made" />
<link href="index.html" target="_top" rel="Start" title="トップページ" />
<link href="f_Storages.html" title="Storagesクラス" rel="Parent" />
</head>
<body>
<h1><span class="fheader"><a name="top" id="top">Storages.selectFile</a></span></h1><div class="para"><div>
<dl>
<dt>機能/意味</dt>
<dd>
ファイル選択ダイアログボックスを表示</dd>
<dt>タイプ</dt>
<dd>
<a class="jump" href="f_Storages.html">Storagesクラス</a>のメソッド<br />
</dd>
<dt>構文</dt>
<dd>
<span class="funcdecl">selectFile(<span class="arg">params</span>)</span><br />
</dd>
<dt>引数</dt>
<dd>
<table rules="all" frame="box" cellpadding="3" summary="selectFile の引数">
<tr><td valign="top"><span class="argname">params</span></td>
<td>  データの受け渡しに用いる辞書配列を指定します。<br />
 このメソッドに渡すとき、以下のメンバを指定することができます。また、
いくつかのメンバはこのメソッドが終わると値が変更されます。<br />
<br />
<dl> <dt><a class="targanchor" name="id322" id="id322">filter</a></dt> <dd>  フィルタ文字列を配列で渡します。<br />
 フィルタ文字列は、フィルタの説明と フィルタを | (半角縦棒) で区切って指定
するもので、フィルタにはワイルドカードを指定します。一つのフィルタに複数の
拡張子が対応する場合は ; (半角セミコロン) で区切ります。<br />
 複数のフィルタを指定するには配列で指定します。<br />
 省略するとフィルタは用いません。<br />
<br />
例 :<br />
<span class="script"><nobr>[&quot;画像ファイル(*.bmp;*.png;*.jpg;*.jpeg;*.eri;*.tlg)|*.bmp;*.png;*.jpg;*.jpeg;*.eri;*.tlg&quot;, </nobr></span><br />
<span class="script"><nobr> &quot;スクリプトファイル(*.tjs;*.ks)|*.tjs;*.ks&quot;]</nobr></span><br />
</dd> <br />
<dt><a class="targanchor" name="id323" id="id323">filterIndex</a></dt> <dd>  選択されているフィルタの番号 ( filter で指定したもの ) を指定します。<br />
 1 を指定すると、filter で指定された最初のフィルタが初期状態において
選択されています。2 を指定すると2番目のフィルタが選択さている状態に
なります ( 0 から始まるインデックス番号ではないことに注意してください;
先頭は 1 です )。<br />
 省略すると先頭のフィルタが選択されます。<br />
 また、ユーザが OK ボタンを押した場合、最後にダイアログボックス上で
選ばれていたフィルタのインデックスがこのメンバに設定されます。<br />
</dd> <br />
<dt><a class="targanchor" name="id324" id="id324">name</a></dt> <dd>  ファイル名を指定します。省略したり、空文字列を指定すると初期状態ではなにもファイルを選択
されていない状態にすることができます。<br />
 また、ユーザが OK ボタンを押した場合、選択されたファイルがこのメンバに
設定されます。<br />
</dd> <br />
<dt><a class="targanchor" name="id325" id="id325">initialDir</a></dt> <dd>  初期状態で表示するフォルダを指定します。<br />
 省略するとカレントディレクトリが使用されます。<br />
</dd> <br />
<dt><a class="targanchor" name="id326" id="id326">title</a></dt> <dd>  ダイアログボックスのタイトルを表示します。<br />
 省略されるとデフォルトの「開く」や「名前を付けて保存」になります
( save メンバの設定によります )。
</dd> <br />
<dt><a class="targanchor" name="id327" id="id327">save</a></dt> <dd>  ダイアログボックスの種類を指定します。<br />
 false(デフォルト) の場合、「開く」のダイアログボックスが使われます。<br />
 true の場合、「名前を付けて保存」のダイアログボックスが使われます。<br />
</dd> <br />
<dt><a class="targanchor" name="id328" id="id328">defaultExt</a></dt> <dd>  デフォルトの拡張子を指定します。ユーザが拡張子を指定しなかった場合に
自動的にこの拡張子を付加します。ここで指定する拡張子には . (ピリオド)を
指定しないでください。<br />
 省略すると、拡張子が付加されることはありません。<br />
</dd> </dl> </td></tr>
</table>
</dd>
<dt>戻り値</dt>
<dd>
<result>ユーザがファイルを選択して OK ボタンを押せば真、キャンセルボタンを押せば偽が戻ります。</result></dd>
<dt>説明</dt>
<dd>
 ファイル選択ダイアログボックスを開きます。<br />
<code class="bq"><span class="weak">例:</span><br />var&nbsp;params&nbsp;=&nbsp;%[<br />
filter&nbsp;:&nbsp;[&nbsp;&quot;テキストファイル(*.txt)|*.txt&quot;,&nbsp;&quot;バイナリファイル(*.bin)|*.bin&quot;&nbsp;],<br />
filterIndex&nbsp;:&nbsp;1,<br />
name&nbsp;:&nbsp;&quot;&quot;,<br />
initialDir&nbsp;:&nbsp;System.exePath,<br />
title&nbsp;:&nbsp;&quot;ファイルを開く&quot;,<br />
save&nbsp;:&nbsp;false,<br />
];<br />
if(Storages.selectFile(params))<br />
System.inform(&quot;選択したファイルは&nbsp;:&nbsp;&quot;&nbsp;+&nbsp;params.name);<br />
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code>
</dd>
</dl>
</div></div>
<script type="text/javascript" charset="UTF-8" src="documentid.js" ></script>
<script type="text/javascript" charset="UTF-8" src="postcontent.js" ></script>
</body>
</html>