エディットボックス (EditBox) は、一般的なテキスト入力ウィンドウ要素です。
| EditBox | エディットボックス (EditBox) は、一般的なテキスト入力ウィンドウ要素です。 |
| 実装の詳細 | フォーカスがあっている場合、エディットボックスには明滅するカーソルが表示され、全てのキーボード入力を捕捉（および表示）します。 |
| XML定義 | |
| XMLタグ | |
| 任意属性 | |
| font | 使用するフォント定義の名前。 |
| maxchars | 表示可能な最大文字数。 |
| scrollbar | 入力されたテキストがウィンドウの縦幅を超える場合に用いる垂直スクロールバーの名前。 |
| background | 背景として使用するフルリサイズイメージの名前。 |
| linespacing | フォントラインスペース用のオーバーライド値。 |
| password | パスワードボックスのように、入力した文字のかわりにアスタリスクを表示します。 |
| scrolling | 使用するスクロールモードです。 |
| input | このエディットボックスが受け付ける入力タイプを指定します。 |
| history | 追跡する（Enterキーが押されたときに自動的に追跡される）入力履歴のサイズです。 |
| 要素 | |
| TextColor | テキスト色を設定します。 |
| TexCoords | 背景テクスチャの基準座標を設定します。 |
| TextOffset | エディットボックスに表示されているテキストのオフセットを設定します。 |
| ウィンドウ コールバック | |
| コールバック | |
| OnTextChanged | エディットボックス内のテキストが変化した時に呼び出されます。 |
| 関数 | |
| 関数 | |
| TextEditBoxSetText() | エディットボックスに表示するテキストを設定します。 |
| TextEditBoxGetText() | エディットボックスに現在表示されているテキストを返します。 |
| TextEditBoxInsertText() | 現在のカーソル位置にテキストを挿入します。 |
| TextEditBoxSetTextColor() | テキスト色を設定します。 |
| TextEditBoxGetTextColor() | 現在設定されているテキスト色を返します。 |
| TextEditBoxSelectAll() | エディットボックス内のテキストを全て選択します。 |
| TextEditBoxSetFont() | 表示するテキストのフォントを設定します。 |
| TextEditBoxGetFont() | 現在使用しているフォントの名前を返します。 |
| TextEditBoxGetHistory() | エディットボックスの入力履歴を返します。 |
| TextEditBoxSetHistory() | エディットボックスの入力履歴を設定します。 |
| TextEditBoxSetHandleKeyDown() | キーを押してもエディットボックスにテキストが追加されないように設定することができます。 |
フォーカスがあっている場合、エディットボックスには明滅するカーソルが表示され、全てのキーボード入力を捕捉（および表示）します。
手動で WindowAssignFocus() を呼び出すか、マウスでクリックすることでエディットボックスにフォーカスをあてることができます。
エディットボックスには2種類の異なるスクロールモードがあります。
| horizontal | テキストは常に一行で、カーソル位置に応じて左から右にスクロールします。 |
| vertical | ボックスの端にテキストが到達すると、改行とスクロールが行われます （注意: スクロールは現在正しく機能しておらず、ボックスの下端を超えてテキストを表示させることはできません）。 |
エディットボックスが特定の入力タイプを受け付けるように制限できます。
| ”all” | 全ての文字を受け付ける。 |
| ”nospaces” | スペース以外のあらゆる文字を受け付ける。 |
| ”text” | テキストのみ受け付ける。 |
| ”numbers” | 数値のみを受け付ける。 |
| 矢印キー | テキストの中でカーソルを上下左右に移動させます。 |
| Shift + 上/下矢印キー | 前後の入力履歴を呼び出します。 |
| 左Shift + 左/右矢印キー | カーソルの左/右の文字を選択します。 |
| Shift + Ctrl + 左/右矢印キー | カーソルの左/右の単語をまるごと選択します。 |
| Ctrl + 左/右矢印キー | カーソルを左/右へ1単語分移動します。 |
| Home | テキストの先頭にカーソルを移動します。 |
| Shift + Home | 先頭からカーソルまでの間にあるテキストを全て選択します。 |
| End | テキストの最後にカーソルを移動します。 |
| Shift + End | カーソルからテキストの最後までのテキストを全て選択します。 |
| Delete | 選択されたテキストまたはカーソルのすぐ後ろのテキストを削除します。 |
| Backspace | 選択したテキストもしくはカーソルの直前にあるテキストを削除します。 |
| Control + Backspace | カーソルの前にある単語を丸ごと削除します。 |
| Enter | 現在のテキストを入力履歴に追加する（履歴サイズが指定されていれば）。テキストを消去したい場合は、自分で OnKeyEnter() イベントの処理を扱う必要があります。 |
| Control-A | テキストを全て選択します。 |
| Control-C | 選択したテキストをクリップボードにコピーします。 |
| Control-V | クリックボードにあるテキストをエディットボックスに貼りつけます。 |
| Control-X | 選択したテキストをクリップボードに切り取ります。 |
| XMLタグ | |
| 任意属性 | |
| font | 使用するフォント定義の名前。 |
| maxchars | 表示可能な最大文字数。 |
| scrollbar | 入力されたテキストがウィンドウの縦幅を超える場合に用いる垂直スクロールバーの名前。 |
| background | 背景として使用するフルリサイズイメージの名前。 |
| linespacing | フォントラインスペース用のオーバーライド値。 |
| password | パスワードボックスのように、入力した文字のかわりにアスタリスクを表示します。 |
| scrolling | 使用するスクロールモードです。 |
| input | このエディットボックスが受け付ける入力タイプを指定します。 |
| history | 追跡する（Enterキーが押されたときに自動的に追跡される）入力履歴のサイズです。 |
| 要素 | |
| TextColor | テキスト色を設定します。 |
| TexCoords | 背景テクスチャの基準座標を設定します。 |
| TextOffset | エディットボックスに表示されているテキストのオフセットを設定します。 |
入力されたテキストがウィンドウの縦幅を超える場合に用いる垂直スクロールバーの名前。
| string | 有効な VerticalScrollbar の名前。 |
| コールバック | |
| OnTextChanged | エディットボックス内のテキストが変化した時に呼び出されます。 |
| 関数 | |
| TextEditBoxSetText() | エディットボックスに表示するテキストを設定します。 |
| TextEditBoxGetText() | エディットボックスに現在表示されているテキストを返します。 |
| TextEditBoxInsertText() | 現在のカーソル位置にテキストを挿入します。 |
| TextEditBoxSetTextColor() | テキスト色を設定します。 |
| TextEditBoxGetTextColor() | 現在設定されているテキスト色を返します。 |
| TextEditBoxSelectAll() | エディットボックス内のテキストを全て選択します。 |
| TextEditBoxSetFont() | 表示するテキストのフォントを設定します。 |
| TextEditBoxGetFont() | 現在使用しているフォントの名前を返します。 |
| TextEditBoxGetHistory() | エディットボックスの入力履歴を返します。 |
| TextEditBoxSetHistory() | エディットボックスの入力履歴を設定します。 |
| TextEditBoxSetHandleKeyDown() | キーを押してもエディットボックスにテキストが追加されないように設定することができます。 |
キーを押してもエディットボックスにテキストが追加されないように設定することができます。
| editBoxName | (string) エディットボックスの名前。 |
| handle | (boolean) true = 自動的にテキストを追加する, false =追加しない |
| nil | 戻り値無し。 |
TextEditBoxSetHandleKeyDown( "KeyMappingWindowTextInput", false )