Maplets[Elements][InputDialog] - 入力ダイアログの定義
使い方
InputDialog(opts)
InputDialog[refID](opts)
パラメータ
opts - option=value の形の等式; ここで option は caption, height, onapprove, oncancel, reference, resizable, title, type, value, width のいずれか; InputDialog 要素のためのオプション指定
refID - 名前または文字列; 要素の参照
|
説明
|
|
•
|
InputDialog ダイアログ要素は、maplet 内で入力のダイアログを定義します。このダイアログは、表題、テキストフィールド、および 2 つのボタン OK および Cancel を含みます。
|
•
|
Maplets のダイアログ要素は、事前に定義されたレイアウトを持っています。ダイアログについては、製作者が要素を指定することはできません。これが、例えばボタンやレイアウト要素といった、他の要素を含むことのできる Window 要素との相違点です。
|
•
|
InputDialog 要素の特徴は、オプションを用いて修正が可能です。Maplets パッケージでのオプション指定を簡単にするために、等式を用いることなしにあるオプションと内容を設定することが可能です。次の表では、(左側の列に) 要素、記号、および型、そして (右側の列に) 型がデフォルトで割り当てられると入力を行う、対応するオプションまたは内容を一覧表示します。
|
Elements, Symbols, or Types Assumed Option or Content
`error`, information, plain or warning type option
refID reference option
string or symbol caption option
•
|
InputDialog 要素は、Action あるいは、onapprove および oncancel オプションを指定するコマンド要素を含むことが可能です。
|
•
|
InputDialog 要素は、Maplet 要素の中に含めることが可能です。
|
•
|
次の表に、InputDialog 要素のオプションの、制御および使用法について記述します。
|
|
I 列の x は、(要素の定義を行う) 呼び出し手順で指定される、初期化が可能なオプションを示す。
|
|
R 列の x は、呼び出し手順で必要となるオプションを示す。
|
|
G 列の x は、オプションが Get ツールを用いて取得できる、すなわち読み込み可能であることを示す。
|
|
S 列の x は、 SetOption 要素あるいは Set ツールを用いて設定される、書き出し可能なオプションを示す。
|
Option I R G S
caption x x
height x x x
onapprove x
oncancel x
reference x
resizable x x x
title x x x
type x
value x x x
width x x x
•
|
opts 引数は、maplet のオプションを設定する、1 つまたは複数の以下の等式を含みます。
|
|
caption = string または symbol
|
|
onapprove = Action あるいはコマンド要素, または Action 要素の参照 (name または string )
|
|
ユーザが OK ボタンをクリックした際に起こる動作。デフォルトでは、この動作ではダイアログを閉じます。
|
|
oncancel = Action あるいはコマンド要素, または Action 要素の参照 (name または string )
|
|
ユーザが Cancel ボタンかタイトルバー上にあるダイアログを閉じるボタンのいずれかをクリックした際に起こる動作。デフォルトでは、この動作ではダイアログを閉じます。
|
|
reference = name または string
|
|
InputDialog 要素についての参照を表します。
|
|
この参照、例えば InputDialog[refID] およびコマンド列内の reference が、両方ともインデックスで指定されている場合、インデックスによる参照が優先されます。
|
|
resizable = true または false
|
|
ユーザがウィンドウのサイズ変更を行えるかどうかの設定。デフォルトでは、false です。
|
|
title = string または symbol
|
|
入力ダイアログのタイトルバーに現れるテキスト。デフォルトのタイトルは、Input Request です。
|
|
type = `error`, information, plain または warning
|
|
表題に関連するアイコンの表示。デフォルトでは、アイコンを表示しない plain の入力ダイアログが使用されます。
|
|
ダイアログの本体にあるテキストフィールド内に現れるテキスト。
|
|
|
例
|
|
閉じると maplet を終了し、リストに入力された値または "FAIL" を返すという入力ダイアログを持つ maplet の例:
>
|
with(Maplets[Elements]):
maplet := Maplet(
InputDialog['ID1']("Enter an integer",
'onapprove'=Shutdown(['ID1']),
'oncancel'=Shutdown()
)):
Maplets[Display](maplet);
|
|
|
参照
|
|
Maplets パッケージの概要, Maplets/コマンド要素, Maplets/ダイアログ要素, Maplets[Display], Maplets[Elements] パッケージの紹介, Maplets[Elements][Action], Maplets[Elements][Maplet], Maplets[Elements][RunDialog], Maplets[Elements][SetOption], Maplets[Elements][Shutdown], Maplets[Elements][Window], Maplets[Tools][Get], Maplets[Tools][Set]
|
|