6.16.1 Textbox オブジェクト

以下のような Textbox オブジェクトをインスタンス生成することができます:

クラス Textbox( win)

テキストボックスウィジェットオブジェクトを返します。win 引数は、テキストボックスを入れるための WindowObject でなければなりません。テキストボックスの編集カーソルは、最初はテキストボックスが入っているウィンドウの左上角に配置され、その座標は (0, 0) です。インスタンスの stripspaces フラグの初期値はオンに設定されます。

Textbox オブジェクトは以下のメソッドを持ちます:

edit( [validator])

普段使うことになるエントリポイントです。終了キーストロークの一つが入力されるまで編集キーストロークを受け付けます。validator を与える場合、関数でなければなりません。validator はキーストロークが入力されるたびにそのキーストロークが引数となって呼び出されます; 返された値に対して、コマンドキーストロークとして解釈が行われます。このメソッドはウィンドウの内容を文字列として返します; ウィンドウ内の空白が含められるかどうかは stripspaces メンバで決められます。

do_command( ch)

単一のコマンドキーストロークを処理します。以下にサポートされている特殊キーストロークを示します:

キーストローク	動作
`Control-A`	ウィンドウの左端に移動します。
`Control-B`	カーソルを左へ移動し、必要なら前の行に折り返します。
`Control-D`	カーソル下の文字を削除します。
`Control-E`	右端 (stripspaces がオフのとき) または行末 (stripspaces がオンのとき) に移動します。
`Control-F`	カーソルを右に移動し、必要なら次の行に折り返します。
`Control-G`	ウィンドウを終了し、その内容を返します。
`Control-H`	逆方向に文字を削除します。(バックスペース)
`Control-J`	ウィンドウが 1 行であれば終了し、そうでなければ新しい行を挿入します。
`Control-K`	行が空白行ならその行全体を削除し、そうでなければカーソル以降行末までを消去します。
`Control-L`	スクリーンを更新します。
`Control-N`	カーソルを下に移動します; 1 行下に移動します。
`Control-O`	カーソルの場所に空行を 1 行挿入します。
`Control-P`	カーソルを上に移動します; 1 行上に移動します。

移動操作は、カーソルがウィンドウの縁にあって移動ができない場合には何も行いません。場合によっては、以下のような同義のキーストロークがサポートされています:

定数	キーストローク
`KEY_LEFT`	`Control-B`
`KEY_RIGHT`	`Control-F`
`KEY_UP`	`Control-P`
`KEY_DOWN`	`Control-N`
`KEY_BACKSPACE`	`Control-h`

他のキーストロークは、与えられた文字を挿入し、(行折り返し付きで) 右に移動するコマンドとして扱われます。

gather( )

このメソッドはウィンドウの内容を文字列として返します; ウィンドウ内の空白が含められるかどうかは stripspaces メンバ変数で決められます。

stripspaces

このデータメンバはウィンドウ内の空白領域の解釈方法を制御するためのフラグです。フラグがオンに設定されている場合、各行の末端にある空白領域は無視されます; すなわち、末端空白領域にカーソルが入ると、その場所の代わりに行の末尾にカーソルが移動します。また、末端の空白領域はウィンドウの内容を取得する際に剥ぎ取られます。

ご意見やご指摘をお寄せになりたい方は、 このドキュメントについて... をご覧ください。