組件 TextInput 文字輸入

TextInput 物件可讓使用者輸入純文字或 html 格式文字內容，主要是處理單行的文字內容，具有與 TextField 類別雷同的屬性，有預設的寬度 100 px ，高度 22 px 。實際是個包裹著 TextField 物件的 Sprite 物件，。

TextInput 類別與物件 - fl.controls 套件

建構 TextInput 物件

從組件視窗將 TextInput 組件加入元件庫，
  1. import fl.controls.*;
  2. var txInp:TextInput=new TextInput();
  3. txInp.text="機會";
  4. addChild(txInp);
另外，也可從組件視窗將 TextInput 組件放入舞台，為 TextInput 實體命名，並在參數視窗指定屬性。

TextInput 的屬性與方法

TextInput 繼承 UIComponent
[屬性]
textField
  • 取得組件內部 TextField 物件。
  • public var textField:TextField
  • ti.textField.border=true // ti 物件內的 TextField 物件顯示外框。
editable
  • 指出物件是否讓使用者編輯內容。
  • editable:Boolean [讀寫]，預設值為 true 。
  • ti.editable=false // 指定 ti 物件內容會換行。
enabled
  • 指出物件是否接受使用者互動，如游標移入成為焦點、傳送某些事件。
  • enabled:Boolean [讀寫] [override]，預設值為 true 。
  • ti.enabled=false // ti 物件不讓使用者互動。
text
  • 純文字方式的字串存取物件內容。
  • text:String [讀寫]，預設值為 "" 。
  • var inp:String=ti.text // ti TextInput 物件內的文字指定給 inp 物件。
htmlText
  • html 方式的字串存取物件內容，惟支援的 html 語法有限。
  • htmlText():String [讀寫]，預設值為 "" 。
  • ti.htmlText="<p>hello</p>" // ti 物件內放入 html 段落 hello 。
condenseWhite
  • 指出是否移除 html 文字串中的空白字元，如空格或斷行。
  • condenseWhite:Boolean [讀寫]，預設值為 false 。
  • ti.condenseWhite=true //指定 ti 物件移除空白字元。
length
  • 取得物件中的字元總數。
  • length:int [唯讀]，預設值為 0 。
  • var txTotal:int=ti.length // 將 ti 物件的總字元數指定給 txTotal 物件。
maxChars
  • 指出物件內限制使用者最多可輸入的字元數。
  • maxChars:int [讀寫]，預設值為 0 。
  • ti.maxChars=10 // ti 物件最多只能輸入 10 個字元。
restrict
  • 限制使用者可輸入的字元，可使用「-」 (減號) 指定字元範圍，使用「^」指定不可輸入的字元。
  • restrict:String [讀寫]，預設值為 null 。
  • tf.restrict="0-9 a-z" // tf 物件只能輸入數字，英文小寫字母及空格。 tf.restrict="^0-9" // tf 物件不能輸入數字，其餘皆可。 tf.restrict="A-Z^G" // tf 物件只能輸入英文大寫字母，但不包括 G 。
displayAsPassword
  • 指出是否以密碼欄位顯示，不實際顯示文元而以星號代替。
  • displayAsPassword:Boolean [讀寫]，預設值為 false 。
  • ti.displayAsPassword=true // ti 物件以密碼方式顯示。
selectionBeginIndex
  • 取得字元選取範圍的第一個字元在物件內字元的索引位置值。
  • selectionBeginIndex:int [唯讀]，預設值為 0 。
  • var i:int=ti.selectionBeginIndex // ti TextInput 物件內被選取的字元的第一個字元的索引值，指定給 i 物件。
selectionBeginIndex
  • 取得字元選取範圍的最後一個字元在物件內字元的索引位置值。
  • selectionEndIndex:int [唯讀]，預設值為 0 。
  • var i:int=ti.selectionEndIndex // ti TextInput 物件內被選取的字元的最後一個字元的索引值，指定給 i 物件。
[方法]
appendText()
  • 將 text 參數的文字型態字串附加到物件之目前文字的末端。
  • public function appendText(text:String):void
  • ti.appendText("先生") // 在目前 ti 物件內容的最後加上「先生」兩字。
[事件]
change
  • 代表使用者變更物件目前內容的事件。
  • 建議使用 Event.CHANGE 靜態常數代表。
enter
  • 代表使用者按下 enter 鍵的事件。
  • 建議使用 ComponentEvent.ENTER 靜態常數代表。
textInput
  • 代表使用者輸入文字的事件。
  • 建議使用 TextEvent.TEXT_INPUT 靜態常數代表。