Maplets[Elements][Action] - 動作の定義
使い方
Action(opts, element_content)
Action[refID](opts, element_content)
パラメータ
opts - reference=value の形の等式; Action 要素のためのオプション指定
element_content - Action の任意の番号あるいはコマンド要素
refID - 名前または文字列; 要素の参照
|
説明
|
|
•
|
Action 要素は、maplet での動作を定義します。
|
•
|
Action 要素の特徴は、オプションを用いて修正が可能です。Maplets パッケージでのオプション指定を簡単にするために、等式を用いることなしにあるオプションと内容を設定することが可能です。次の表では、(左側の列に) 要素、記号、および型、そして (右側の列に) 型がデフォルトで割り当てられると入力を行う、対応するオプションまたは内容を一覧表示します。
|
Elements, Symbols, or Types Assumed Option or Content
refID reference option
•
|
Action 要素は、任意の番号の他の Action 要素、あるいは CloseWindow, Evaluate, SetOption, RunWindow, RunDialog, Shutdown といったコマンド要素を含むことが可能です。
|
•
|
Action 要素は、Maplet 要素の中に含めることが可能です; 要素に対する onapprove, oncancel, onchange, onclick, ondecline, onstartup の各オプションで用いる等式内; あるいは、等式なしに onchange または onclick オプションで受け付ける要素内のパラメータとして使用されます。
|
•
|
Action 要素の内容は、順番に評価されます。各動作は、次が始まる前に完了します。階層化された Action 要素の内容も、順番に評価されます。
|
•
|
次の表に、Action 要素のオプションの、制御および使用法について記述します。
|
|
I 列の x は、(要素の定義を行う) 呼び出し手順で指定される、初期化が可能なオプションを示す。
|
|
R 列の x は、呼び出し手順で必要となるオプションを示す。
|
|
G 列の x は、オプションが Get ツールを用いて取得できる、すなわち読み込み可能であることを示す。
|
|
S 列の x は、 SetOption 要素あるいは Set ツールを用いて設定される、書き出し可能なオプションを示す。
|
Option I R G S
reference x
run x
•
|
opts 引数は、maplet のオプションを設定する、1 つまたは複数の以下の等式を含みます。
|
|
reference = name または string
|
|
この参照、例えば Action[refID] およびコマンド列内の reference が、両方ともインデックスで指定されている場合、インデックスによる参照が優先されます。
|
|
これは起動を設定することができるフィールドです、コントロールが Maplet アプリケーションに返ると、指定されたアクションが実行されます。これは、ウィンドウを閉じる条件を指定するのに役立ちます。
|
|
|
例
|
|
ボタンを加える動作を持つ maplet の例:
>
|
with(Maplets[Elements]):
maplet1 := Maplet(
[[TextField['TF1']()],
[Button['B1']("Clear", 'onclick' = 'A1')],
[Button['B2']("OK", 'onclick' = 'A2')]],
Action['A1'](SetOption('target' = 'TF1')),
Action['A2'](Shutdown(['TF1']))
):
Maplets[Display](maplet1);
|
この maplet をより簡単に記述すると、次のようになります;
>
|
maplet2 := Maplet(
[[TextField['TF1']()],
[Button['B1']("Clear", SetOption('target' = 'TF1'))],
[Button['B2']("OK", Shutdown(['TF1']))]]
):
Maplets[Display](maplet2);
|
|
|
参照
|
|
Maplets パッケージの概要, Maplets/コマンド要素, Maplets[Display], Maplets[Elements] パッケージの紹介, Maplets[Elements][Button], Maplets[Elements][Maplet], Maplets[Elements][SetOption], Maplets[Elements][Shutdown], Maplets[Elements][TextField], Maplets[Tools][Get], Maplets[Tools][Set]
|
|