Maplets[Elements][TextBox] - 入力または出力に関するテキストボックスの定義
使い方
TextBox(opts)
TextBox[refID](opts)
パラメータ
opts - option=value の形の等式; ここで option は background, editable, enabled, font, foreground, height, onchange, popupmenu, reference, tooltip, value, visible, width, wrapped のいずれか; TextBox 要素のためのオプション指定
refID - 名前または文字列; 要素の参照
|
説明
|
|
•
|
TextBox ウィンドウボディ要素は、maplet 内で入力または出力に関するテキストボックスを定義します。
|
•
|
TextBox 要素の特徴は、オプションを用いて修正が可能です。Maplets パッケージでのオプション指定を簡単にするために、等式を用いることなしにあるオプションと内容を設定することが可能です。次の表では、(左側の列に) 要素、記号、および型、そして (右側の列に) 型がデフォルトで割り当てられると入力を行う、対応するオプションまたは内容を一覧表示します。
|
Elements, Symbols, or Types Assumed Option or Content
Font element font option
range of positive integers height and width options, respectively
PopupMenu element popupmenu option
refID reference option
string or symbol value option
•
|
TextBox 要素は、Action または onchange オプションを指定するコマンド要素、font オプションを指定する Font 要素、および popupmenu オプションを指定する PopupMenu 要素を含むことが可能です。
|
•
|
TextBox 要素は、Maplet または BoxLayout 要素、ボックスレイアウトを表現する階層化されたリスト内にある Maplet 要素に、含めることが可能です。
|
•
|
TextBox 内のテキストが、ボックスのサイズを超える場合には、自動的に垂直方向のスクロールバーが表示されます。
|
•
|
次の表に、TextBox 要素のオプションの、制御および使用法について記述します。
|
|
I 列の x は、(要素の定義を行う) 呼び出し手順で指定される、初期化が可能なオプションを示す。
|
|
R 列の x は、呼び出し手順で必要となるオプションを示す。
|
|
G 列の x は、オプションが Get ツールを用いて取得できる、すなわち読み込み可能であることを示す。
|
|
S 列の x は、 SetOption 要素あるいは Set ツールを用いて設定される、書き出し可能なオプションを示す。
|
Option I R G S
append* x
appendline* x
background x x x
editable x x x
enabled x x x
font x x x
foreground x x x
height x x x
onchange x
popupmenu x
reference x
tooltip x x x
value x x x
visible x x x
width x x x
wrapped x x x
|
* append は、テキストボックス内のテキストの最後に、テキストを追加します。その構文は、 refID(append)="text" です。ここで、 refID はテキストボックスの参照を表します。
|
|
* appendline テキストボックス内のテキストの最後に、新しい行を追加します。その構文は、 refID(appendline)="text" です。ここで、 refID はテキストボックスの参照を表します。
|
•
|
opts 引数は、maplet のオプションを設定する、1 つまたは複数の以下の等式を含みます。
|
|
テキストボックスをハイライト表示する色。色の名前、RGB の色構造、または "#RRGGBB" という形の文字列 (ここで各文字の組は 2 桁の 16 進数) を、認識することができます。
|
|
editable = true または false
|
|
ユーザによるテキストボックスの編集が可能かどうかの指定。出力に関するボックスでは、このオプションを false に設定するべきです。editable = false の場合、editable オプション独自の設定として、そのテキストボックスは編集不可の状態になります。デフォルトの値は、true です。
|
|
テキストボックスがハイライト表示可能かどうかの指定。enabled が false に設定されると、テキストボックスは霞んだ表示となり、そのテキストボックスに関連する動作に進むことはできません。デフォルトの値は、true です。
|
|
font = Font 要素または Font 要素の参照 (name または string )
|
|
テキストボックスの高さ (単位は文字)。デフォルトの値は、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[refID] およびコマンド列内の reference が、両方ともインデックスで指定されている場合、インデックスによる参照が優先されます。
|
|
tooltip = string または symbol
|
|
value = string または symbol
|
|
テキストボックスの初期値。デフォルトでは、 value は空の状態です。
|
|
ユーザが見ることのできるテキストボックスかどうかの設定。デフォルトの値は、true です。
|
|
テキストボックスの幅 (単位は文字)。デフォルトの値は、20 文字分の幅です。
|
|
テキストボックスの内容を次の行へ改行するかどうかの設定。
|
|
|
例
|
|
ユーザにテキストの入力を求める maplet の例。そのテキストは、個々の単語に分割されます。
>
|
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);
|
テキストボックスへ新しい行を追加するために、Set 関数を使用する maplet の例:
>
|
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);
|
|
|
参照
|
|
Maplets パッケージの概要, Maplets/コマンド要素, Maplets[Display], Maplets[Elements] パッケージの紹介, Maplets[Elements][Action], Maplets[Elements][BoxCell], Maplets[Elements][Button], Maplets[Elements][Evaluate], Maplets[Elements][Font], Maplets[Elements][Maplet], Maplets[Elements][PopupMenu], Maplets[Elements][SetOption], Maplets[Elements][Shutdown], Maplets[Elements][TextField], Maplets[Tools][Get], Maplets[Tools][Set], Maplets/ウィンドウボディ要素, plot[color], 手続き, StringTools[Split], type
|
|