TextField ウィンドウボディ要素は、maplet 内で1行だけのテキストボックスからなる、テキストフィールドを定義します。

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

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

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

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

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

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

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

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

* append テキストフィールド内のテキストの最後に、テキストを追加します。その構文は、 refID(append)="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 

テキストフィールド表面の色。

halign = left, center または right 

テキストフィールドの、水平方向の配置。デフォルトの値は、left です。

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 

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

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

tooltip = string または symbol 

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

value = anything 

フィールドの初期値。この値が文字列でない場合、sprintf("%a", value) を用いて文字列へと変換されます。デフォルトでは、 value は空の状態です。

visible = true または false 

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

width = posint 

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

with(Maplets[Elements]):
maplet := Maplet([
   ["Enter your name: ", TextField['IB1'](30)],
   [Button("OK", Shutdown(['IB1'])), Button("Cancel", Shutdown())]
]):
Maplets[Display](maplet);

G:=proc() Maplets:-Tools:-Set('TF1' ('append') = " and on") end proc:
with(Maplets[Elements]):
maplet2 := Maplet(Window('layout'='BL1'),
   BoxLayout['BL1'](
      BoxCell( 'hscroll'='always', TextField['TF1']("And on", 100) ),
      BoxCell( Button("Append", Action( Evaluate( 'function'='G()' ) ) ) ),
      BoxCell( Button("Close", Shutdown()) )
   )
):
Maplets[Display](maplet2);