組件 TextArea 文字輸入
TextArea 物件可讓使用者輸入純文字或 html 格式文字內容，主要是處理多行的文字內容，並有捲軸的功能，具有與 TextField 類別雷同的屬性，有預設的寬度 100 px ，高度 44 px 。實際是個包裹著 TextField 物件的 Sprite 物件，。
TextArea 類別與物件 - fl.controls 套件
建構 TextArea 物件
- 從組件視窗將 TextArea 組件加入元件庫，
-
import fl.controls.*;var txArea:TextArea=new TextArea();txArea.text="機會";addChild(txArea);
- 另外，也可從組件視窗將 TextArea 組件放入舞台，為 TextArea 實體命名，並在參數視窗指定屬性。
TextArea 的屬性與方法
- TextArea 繼承 UIComponent
- [屬性]
-
- horizontalScrollPolicy
-
- 指出物件產生水平捲軸的原則：
- ScrollPolicy.AUTO：只有在內容超過物件尺寸時自動產生捲軸，此為預設值。
- ScrollPolicy.ON：不論內容多寡總是出現捲軸。
- ScrollPolicy.OFF：不出現捲軸。
- horizontalScrollPolicy:String [讀寫]
ta.horizontalScrollPolicy=ScrollPolicy.ON //指定 ta 物件不論內容多寡都會出現水平捲軸。
- verticalScrollPolicy
-
- 指出物件產生垂直捲軸的原則：
- ScrollPolicy.AUTO：只有在內容超過物件尺寸時自動產生捲軸，此為預設值。
- ScrollPolicy.ON：不論內容多寡總是出現捲軸。
- ScrollPolicy.OFF：不出現捲軸。
- verticalScrollPolicy:String [讀寫]
ta.verticalScrollPolicy=ScrollPolicy.ON //指定 ta 物件不論內容多寡都會出現垂直捲軸。
- textField
-
- 取得組件內部 TextField 物件。
- public var textField:TextField
ta.textField.border=true // ta 物件內的 TextField 物件顯示外框。
- editable
-
- 指出物件是否讓使用者編輯內容。
- editable:Boolean [讀寫]，預設值為 true 。
ta.editable=false // 指定 ta 物件內容會換行。
- enabled
-
- 指出物件是否接受使用者互動，如游標移入成為焦點、傳送某些事件。
- enabled:Boolean [讀寫] [override]，預設值為 true 。
ta.enabled=false // ta 物件不讓使用者互動。
- text
-
- 純文字方式的字串存取物件內容。
- text:String [讀寫]，預設值為 "" 。
var inp:String=ta.text // ta TextInput 物件內的文字指定給 inp 物件。
- htmlText
-
- html 方式的字串存取物件內容，惟支援的 html 語法有限。
- htmlText():String [讀寫]，預設值為 "" 。
ta.htmlText="<p>hello</p>" // ta 物件內放入 html 段落 hello 。
- condenseWhite
-
- 指出是否移除 html 文字串中的空白字元，如空格或斷行。
- condenseWhite:Boolean [讀寫]，預設值為 false 。
ta.condenseWhite=true //指定 ta 物件移除空白字元。
- length
-
- 取得物件中的字元總數。
- length:int [唯讀]，預設值為 0 。
var txTotal:int=ta.length // 將 ta 物件的總字元數指定給 txTotal 物件。
- maxChars
-
- 指出物件內限制使用者最多可輸入的字元數。
- maxChars:int [讀寫]，預設值為 0 。
ta.maxChars=10 // ta 物件最多只能輸入 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 。
ta.displayAsPassword=true // ta 物件以密碼方式顯示。
- selectionBeginIndex
-
- 取得字元選取範圍的第一個字元在物件內字元的索引位置值。
- selectionBeginIndex:int [唯讀]，預設值為 0 。
var i:int=ta.selectionBeginIndex // ta TextInput 物件內被選取的字元的第一個字元的索引值，指定給 i 物件。
- selectionBeginIndex
-
- 取得字元選取範圍的最後一個字元在物件內字元的索引位置值。
- selectionEndIndex:int [唯讀]，預設值為 0 。
var i:int=ta.selectionEndIndex // ta TextInput 物件內被選取的字元的最後一個字元的索引值，指定給 i 物件。
- [方法]
-
- appendText()
-
- 將 text 參數的文字型態字串附加到物件之目前文字的末端。
- public function appendText(text:String):void
ta.appendText("先生") // 在目前 ta 物件內容的最後加上「先生」兩字。
- [事件]
-
- scroll
-
- 代表捲動捲軸或滾動滑鼠滾輪的事件。
- 建議使用 ScrollEvent.SCROLL 靜態常數代表。
- change
-
- 代表使用者變更物件目前內容的事件。
- 建議使用 Event.CHANGE 靜態常數代表。
- enter
-
- 代表使用者按下 enter 鍵的事件。
- 建議使用 ComponentEvent.ENTER 靜態常數代表。
- textInput
-
- 代表使用者輸入文字的事件。
- 建議使用 TextEvent.TEXT_INPUT 靜態常數代表。