TextBox ウィンドウボディ要素は、maplet 内で入力または出力に関するテキストボックスを定義します。

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

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

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

TextBox 内のテキストが、ボックスのサイズを超える場合には、自動的に垂直方向のスクロールバーが表示されます。

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

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

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

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

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

* append は、テキストボックス内のテキストの最後に、テキストを追加します。その構文は、 refID(append)="text" です。ここで、 refID はテキストボックスの参照を表します。

* appendline テキストボックス内のテキストの最後に、新しい行を追加します。その構文は、 refID(appendline)="text" です。ここで、 refID はテキストボックスの参照を表します。

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

background = color 

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

editable = true または false 

ユーザによるテキストボックスの編集が可能かどうかの指定。出力に関するボックスでは、このオプションを false に設定するべきです。editable = false の場合、editable オプション独自の設定として、そのテキストボックスは編集不可の状態になります。デフォルトの値は、true です。

enabled = true または false 

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

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

テキストボックス内の文字のフォント。

foreground = color 

テキストボックス前面の色。

height = posint 

テキストボックスの高さ (単位は文字)。デフォルトの値は、1 文字分の高さです。

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

ユーザがテキストボックスの値を変更したり、テキストボックスへの焦点が失われる (アクティブの状態でなくなる) 場合に起こる動作。 ユーザが ENTER を押す際には、この動作は起こりません。

popupmenu = PopupMenu 要素、あるいは PopupMenu 要素の参照 (name または string )

テキストボックスに関連する、ポップアップメニューあるいはポップアップメニューについての参照を表します。ポップアップメニューのデフォルト項目は、オプション editable が true であるとき、Cut, Copy, Paste, Delete, Select All となります。オプション editable が false であるときには、Copy および Select All となります。このオプションで指定された項目は、デフォルト項目に追加されます。

reference = name または string 

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

この参照、例えば TextBox[refID] およびコマンド列内の reference が、両方ともインデックスで指定されている場合、インデックスによる参照が優先されます。

tooltip = string または symbol 

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

value = string または symbol 

テキストボックスの初期値。デフォルトでは、 value は空の状態です。

visible = true または false 

ユーザが見ることのできるテキストボックスかどうかの設定。デフォルトの値は、true です。

width = posint 

テキストボックスの幅 (単位は文字)。デフォルトの値は、20 文字分の幅です。

wrapped = true または false 

テキストボックスの内容を次の行へ改行するかどうかの設定。

with(Maplets[Elements]):
maplet := Maplet([
   ["Enter some text:  ", BoxCell(TextBox['IB1'](3..30))],
   [Button("OK", Shutdown(['IB1'])), Button("Cancel", Shutdown())]
]):
result := Maplets[Display](maplet);
`if`(type(result, ['string']), StringTools[Split](result[1]), NULL);

G:=proc() Maplets:-Tools:-Set('TB1' ('appendline') = "and more") end proc:
with(Maplets[Elements]):
maplet2 := Maplet([[
   TextBox['TB1']("Some text "),
   Button("Append", Action(Evaluate('function'='G()'))),
   Button("Close", Shutdown())
]]):
Maplets[Display](maplet2);