ToggleButton ウィンドウボディ要素は、maplet 内でトグルボタンを定義します。

ToggleButton 要素の特徴は、オプションを用いて修正が可能です。Maplets パッケージでのオプション指定を簡単にするために、等式を用いることなしにあるオプションと内容を設定することが可能です。次の表では、(左側の列に) 要素、記号、および型、そして (右側の列に) 型がデフォルトで割り当てられると入力を行う、対応するオプションまたは内容を一覧表示します。

ToggleButton 要素は、Action または onchange オプションを指定するコマンド要素、font オプションを指定する Font 要素、および image オプションを指定する Image 要素を含むことが可能です。

ToggleButton 要素は、Maplet または BoxLayout 要素、ボックスレイアウトを表現する階層化されたリスト内にある Maplet 要素に、含めることが可能です。

次の表に、ToggleButton 要素のオプションの、制御および使用法について記述します。

I 列の x は、(要素の定義を行う) 呼び出し手順で指定される、初期化が可能なオプションを示す。

R 列の x は、呼び出し手順で必要となるオプションを示す。

G 列の x は、オプションが Get ツールを用いて取得できる、すなわち読み込み可能であることを示す。

S 列の x は、 SetOption 要素あるいは Set ツールを用いて設定される、書き出し可能なオプションを示す。

opts 引数は、maplet のオプションを設定する、1 つまたは複数の以下の等式を含みます。

background = color 

トグルボタンをハイライト表示する色。色の名前、RGB の色構造、または "#RRGGBB" という形の文字列 (ここで各文字の組は 2 桁の 16 進数) を、認識することができます。

caption = string または symbol 

トグルボタンの上に現れる表題。表題は、関連するニーモニックキーまたはアクセスキーを持ちます。詳細な情報については、Maplets ニーモニックキー を参照して下さい。

enabled = true または false 

トグルボタンがクリック可能かどうかの指定。enabled が false に設定されると、トグルボタンは霞んだ表示となり、そのトグルボタンに関連する動作に進むことはできません。デフォルトの値は、true です。

font = Font 要素または Font 要素の参照 (name または string )

トグルボタン上の文字のフォント。

foreground = color 

トグルボタン表面の色。

image = Image 要素または Image 要素の参照 (name または string )

トグルボタン上に表示される画像。

onchange = Action またはコマンド要素、あるいは Action 要素の参照 (name または string )

トグルボタンが変更される際に起こる動作。

reference = name または string 

ToggleButton 要素についての参照を表します。

tooltip = string または symbol 

ツールチップのヘルプウィンドウに現れるテキスト。

value = true または false 

トグルボタンの値。デフォルトの値は、false です。

visible = true または false 

ユーザが見ることのできるトグルボタンかどうかの設定。デフォルトの値は、true です。

with(Maplets[Elements]):
maplet := Maplet([
  [ToggleButton['TB1']("This is a Toggle Button", 'value'=true)],
  [Button("OK", Shutdown(['TB1'])), Button("Cancel", Shutdown())]
]):
Maplets[Display](maplet);