文字內容與文字欄位 TextField

TextField 物件用於顯出文字或讓使用者輸入文字。屬性檢測器的動態文字和輸入文字都是 TextField 物件。

TextField 類別與物件 - flash.text 套件

另外可參考 UIComponent 裡的 Label, TextInput, TextArea 等組件提供不同目的且更加視覺化的文字處理。

建構 TextField 物件

  1. var tf:TextField=new TextField();
  2. tf.text="機會";
  3. addChild(tf);

TextField 的屬性與方法

TextField 繼承 InteractiveObject
[屬性]
text
  • 純文字方式的字串存取文字欄位內容。
  • text:String [讀寫]
  • tf.text="hello" //tf 物件內放入 hello 文字。
htmlText
  • html 方式的字串存取文字欄位內容，惟支援的 html 語法有限。
  • htmlText():String [讀寫]
  • tf.htmlText="<p>hello</p>" //tf 物件內放入 html 段落 hello 。
border
  • 文字欄位是否具有邊線。
  • border:Boolean [讀寫]，預設值為 false 。
  • tf.border=true //tf 物件具有邊線。
borderColor
  • 文字欄位邊線的顏色， border 值必須為 true 才有效。
  • borderColor:uint [讀寫]， 16 進位數值表示，預設值為 0x000000 (黑色) 。
  • tf.borderColor=0xff0000 //tf 物件邊線為紅色。
background
  • 文字欄位是否具有背景顏色。
  • background:Boolean [讀寫]，預設值為 false 。
  • tf.background=true //tf 物件具有背景顏色。
backgroundColor
  • 文字欄位背景的顏色， background 值必須為 true 才有效。
  • backgroundColor:uint [讀寫]， 16 進位數值表示，預設值為 0xffffff (白色) 。
  • tf.backgroundColor=0xffff00 //tf 物件背景為黃色。
textColor
  • 文字的顏色。
  • textColor:uint [讀寫]， 16 進位數值表示，預設值為 0 (黑色) 。
  • tf.textColor=0x0000ff //tf 物件的文字為藍色。
type
  • 文字欄位的類型：
    • TextFieldType.DYNAMIC ：使用者無法增修內容的動態文字欄位，此為預設值。
    • TextFieldType.INPUT ：允許使用者增修內容的輸入文字欄位。
  • type:String [讀寫]
  • tf.type=TextFieldType.INPUT //指定 tf 物件允許使用者增修文字內容。
autoSize
  • 指定是否依據文字多寡自動縮放欄位大小，並指定文字對齊的方向：
    • TextFieldAutoSize.NONE ：不縮放尺寸，此為預設值。
    • TextFieldAutoSize.LEFT ：文字靠左，欄位會朝右縮放。
    • TextFieldAutoSize.RIGHT ：文字靠右，欄位會朝左縮放。
    • TextFieldAutoSize.CENTER ：文字置中，欄位朝左右縮放。
  • autoSize:String [讀寫]
  • tf.autoSize=TextFieldAutoSize.CENTER // tf 物件文字置中對齊，欄位朝左右自動縮放。
length
  • 取得欄位中的字元總數。
  • length:int [唯讀]
  • var txTotal:int=tf.length // 將 tf 物件的總字元數指定給 txTotal 物件。
maxChars
  • 指出物件內限制使用者最多可輸入的字元數。
  • maxChars:int [讀寫]，預設值為 0 。
  • tf.maxChars=10 // tf 物件最多只能輸入 10 個字元。
multiline
  • 指定欄位是否可為多行文字。
  • multiline:Boolean [讀寫]，預設值為 false 。
  • tf.multiline=true // 指定 tf 物件內容可為多行文字。
wordWrap
  • 指定欄位內文字是否能夠換行。
  • wordWrap:Boolean [讀寫]，預設值為 false 。
  • tf.wordWrap=true // 指定 tf 物件內容會換行。
numLines
  • 取得欄位內的總行數。
  • numLines:int [唯讀]
  • var txLines:uint=tf.numLines // 將 tf 物件的總行數指定給 txLines 物件。
restrict
  • 限制使用者可輸入的字元， Script 仍舊可加入任何字元，可使用「-」 (減號) 指定字元範圍，使用「^」指定不可輸入的字元。指定 null 可輸入任何字元，而 "" 則不可輸入任何字元。
  • restrict:String [讀寫]，預設值為 null 。
  • tf.restrict="0-9 a-z" // tf 物件只能輸入數字，英文小寫字母及空格。 tf.restrict="^0-9" // tf 物件不能輸入數字，其餘皆可。 tf.restrict="A-Z^G" // tf 物件只能輸入英文大寫字母，但不包括 G 。
condenseWhite
  • 指出是否移除 html 文字串中的空白字元，如空格或斷行。
  • condenseWhite:Boolean [讀寫]，預設值為 false 。
  • tf.condenseWhite=true //指定 tf 物件移除空白字元。
selectable
  • 指出文字內容是否可由使用者選取。
  • selectable:Boolean [讀寫]，預設值為 true 。
  • tf.selectable=false // tf 物件的文字內容不能被選取。
displayAsPassword
  • 指出是否以密碼欄位顯示，不實際顯示文元而以星號代替。
  • displayAsPassword:Boolean [讀寫]，預設值為 false 。
  • tf.displayAsPassword=true // tf 物件以密碼方式顯示。
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()
  • 將 newText 參數的文字型態字串附加到物件之目前文字的末端。
  • public function appendText(newText:String):void
  • tf.appendText("先生") // 在目前 tf 物件內容的最後加上「先生」兩字。

Flash 支援的 html 元素

註： * 為 flash 擴充屬性或元素，非國際標準。

StyleSheet 類別與物件 - flash.text 套件

StyleSheet 的屬性與方法

StyleSheet 繼承 EventDispatcher
[方法]
parseCSS()
  • 解析包含 CSS 語言的純文字字串，轉為 StyleSheet 物件。
  • public function parseCSS(CSSText:String):void
  • css.parseCSS(strCSS) //將 strCSS 字串轉為 css 物件的樣式內容。

Flash 支援的 CSS 特性

註： * 為 flash 擴充特性，非國際標準。