Maplets[Elements][SetOption] - maplet 要素内のオプション値の設定
使い方
SetOption(opts, argument)
パラメータ
opts - option=value の形の等式; ここで option は `option`, target, value のいずれか; SetOption 要素のためのオプション指定
argument - (オプション) Argument 要素; 目的の要素オプションへ割り当てる値の基を指定する(value オプションが含まれる場合は使用不可)。
|
説明
|
|
•
|
SetOption コマンド要素は、指定された要素内のあるオプションの値を設定します。属性の値は、value オプションを用いるか、あるいは Argument 要素を含むことで、指定が可能です。 SetOption が使用可能な要素オプションを特定するためには、個々の Element のヘルプページを参照するか、あるいは、Maplets/ElementOptions を参照して下さい。
|
•
|
Set と SetOption の違いは、Set が手続きの中で使用されるのに対して、SetOption は maplet の中で使用されるということです。Set を用いて設定可能な要素オプションは、SetOption を用いても設定が可能です。
|
•
|
argument オプションは、要素の参照を指定します。この要素に関する value オプションの値は、target で参照される要素に割り当てられます。
|
•
|
SetOption 要素の特徴は、オプションを用いて修正が可能です。Maplets パッケージでのオプション指定を簡単にするために、等式を用いることなしにあるオプションと内容を設定することが可能です。次の表では、(左側の列に) 要素、記号、および型、そして (右側の列に) 型がデフォルトで割り当てられると入力を行う、対応するオプションまたは内容を一覧表示します。
|
Elements, Symbols, or Types Assumed Option or Content
name or string equated to anything target and value options, respectively
•
|
SetOption 要素は、追加の簡易表現を使用します。これら簡易表現を、以下の表に記述します。ここで ref は参照を、opt は記号 (要素に関するオプション) を、そして右側は、ref で参照された maplet の要素に関する、指定されたオプション opt で受け付ける値を表します。以下の表では、簡単化した等式 (左側の列)、およびそれに対応する解釈 (右側の列) の形で表示します。
|
Simplified Equation Interpretation
ref = anything target = ref, value = anything
ref(opt) = anything target = ref, `option` = opt, value = anything
•
|
SetOption 要素は、value オプションを指定するための Argument 要素を含むことが可能です。
|
•
|
SetOption 要素は、Maplet 要素の中に含めることが可能です; 要素に対する onapprove, oncancel, onchange, onclick, ondecline, onstartup の各オプションで用いる等式内に含めることも可能です; あるいは、等式なしに onchange または onclick オプションで受け付ける要素内のパラメータとして、Action 要素内に重ねて含めることも可能です。
|
•
|
次の表に、 SetOption 要素のオプションの、制御および使用法について記述します。
|
|
I 列の x は、(要素の定義を行う) 呼び出し手順で指定される、初期化が可能なオプションを示す。
|
|
R 列の x は、呼び出し手順で必要となるオプションを示す。
|
|
G 列の x は、オプションが Get ツールを用いて取得できる、すなわち読み込み可能であることを示す。
|
|
S 列の x は、 SetOption 要素あるいは Set ツールを用いて設定される、書き出し可能なオプションを示す。
|
Option I R G S
`option` x
target x x
value x
•
|
opts 引数は、maplet のオプションを設定する、1 つまたは複数の以下の等式を含みます。
|
|
更新する target 要素のオプション。デフォルトでは、(存在する場合には) value オプションとなります。
|
|
target = 要素の参照(name または string )
|
|
target 要素の `option` オプションに割り当てる値。デフォルトでは、この値は空 ("") になっています。
|
|
|
例
|
|
>
|
with(Maplets[Elements]):
maplet1 := Maplet([
[Label('caption'="Enter an expression")],
["Input Field:", TextField['B1'](20)],
["Output Field:", TextField['B2'](20, 'editable' = 'false')],
[
Button("Clear 1st Field", SetOption('target' = 'B1', 'value' = "")),
Button("Copy to 2nd Field", SetOption('target' = 'B2', Argument('B1'))),
Button("Return 2nd Field", Shutdown(['B2']))
]
]):
Maplets[Display](maplet1);
|
この maplet の例は、 reference ショートカットと共に SetOption を使用します;
>
|
with(Maplets[Elements]):
maplet2 := Maplet([
[Label('caption'="Enter an expression")],
["Input Field:", TextField['TF1'](20)],
[
Button("Change Font", SetOption('TF1'('font') = 'F1')),
Button("Change Color", SetOption('TF1'('background') = 'red')),
Button("Exit", Shutdown(['TF1']))
]
],
Font[F1]("courier", size=14)
):
Maplets[Display](maplet2);
|
|
|
参照
|
|
Maplets パッケージの概要, Maplets/コマンド要素, Maplets[Display], Maplets/ElementOptions, Maplets[Elements] パッケージの紹介, Maplets[Elements][Action], Maplets[Elements][Argument], Maplets[Elements][Button], Maplets[Elements][Label], Maplets[Elements][Maplet], Maplets[Elements][Shutdown], Maplets[Elements][TextField], Maplets[Tools][Get], Maplets[Tools][Set]
|
|