組件 Label 顯示文字

Label 物件可顯示純文字或 html 格式文字內容,具有與 TextField 類別雷同的屬性。實際是個包裹著 TextField 物件的 Sprite 物件,。

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

建構 Label 物件

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

Label 的屬性與方法

Label 繼承 UIComponent
[屬性]
textField
  • 取得組件內部 TextField 物件。
  • public var textField:TextField
  • lab.textField.border=true // lab 物件內的 TextField 物件顯示外框。
text
  • 純文字方式的字串存取物件內容。
  • text:String [讀寫],預設值為 "Label" 。
  • lab.text="hello" // lab 物件內放入 hello 文字。
htmlText
  • html 方式的字串存取物件內容,惟支援的 html 語法有限。
  • htmlText():String [讀寫],預設值為 "" 。
  • lab.htmlText="<p>hello</p>" //lab 物件內放入 html 段落 hello 。
condenseWhite
  • 指出是否移除 html 文字串中的空白字元,如空格或斷行。
  • condenseWhite:Boolean [讀寫],預設值為 false 。
  • lab.condenseWhite=true //指定 lab 物件移除空白字元。
autoSize
  • 指定是否依據文字多寡自動縮放欄位大小,並指定文字對齊的方向:
    • TextFieldAutoSize.NONE :不縮放尺寸,此為預設值。
    • TextFieldAutoSize.LEFT :文字靠左,欄位會朝右縮放。
    • TextFieldAutoSize.RIGHT :文字靠右,欄位會朝左縮放。
    • TextFieldAutoSize.CENTER :文字置中,欄位朝左右縮放。
  • autoSize:String [讀寫]
  • lab.autoSize=TextFieldAutoSize.CENTER // lab 物件文字置中對齊,欄位朝左右自動縮放。
wordWrap
  • 指定欄位內文字是否能夠換行。
  • wordWrap:Boolean [讀寫],預設值為 false 。
  • lab.wordWrap=true // 指定 lab 物件內容會換行。
selectable
  • 指出文字內容是否可由使用者選取。
  • selectable:Boolean [讀寫],預設值為 false 。
  • lab.selectable=true // lab 物件的文字內容能被選取。
[事件]
resize
  • 代表寬高尺寸有變更的事件。
  • 建議使用 ComponentEvent.RESIZE 靜態常數代表。