適用於 Adobe® Flash® Platform 的 ActionScript® 3.0 參考
首頁  |  隱藏套件和類別清單 |  套件  |  類別  |  新增內容  |  索引  |  附錄  |  為什麼顯示英文?
篩選: 從伺服器擷取資料...
從伺服器擷取資料...
flashx.textLayout.container 

ContainerController  - AS3

套件flashx.textLayout.container
類別public class ContainerController
繼承ContainerController Inheritance Object
實作 IInteractionEventHandler, ITextLayoutFormat, ISandboxSupport

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

ContainerController 類別會定義 TextFlow 物件與容器之間的關係。TextFlow 可以有一或多個用於保留文字的矩形區域;據說文字是透過容器流動的。每一個容器是一個 Sprite,它是 TextLines 的父輩 DisplayObject。 每一個容器都有一個 ContainerController 來管理容器;控制器會保留文字區域的目標寬度和高度、在容器填入 TextLines,以及處理捲動。控制器也有一種與其相關的格式,可以允許部分格式屬性套用至容器中的文字。例如,這樣可以允許 TextFlow 有一個容器,讓文字顯示在其中的一個直欄中,同時在同一個 TextFlow 中有第二個內含兩個直欄的容器。並非所有可能套用至容器的格式屬性都會影響文字;只有影響容器層級版面的容器才會影響文字。以下的圖表會說明 TextFlow、其 flowComposer 以及顯示文字清單之間的關係。

IContainerController

檢視範例

相關 API 元素



公用屬性
 屬性定義自
  absoluteStart : int
[唯讀] 傳回容器中的第一個字元。
ContainerController
  alignmentBaseline : *
TextLayoutFormat:指定主基線對齊的基線。
ContainerController
  backgroundAlpha : *
TextLayoutFormat:背景的 Alpha (透明度) 值 (如果重疊顯示時未定義,則採用預設值)。
ContainerController
  backgroundColor : *
TextLayoutFormat:文字的背景色彩 (如果重疊顯示時未定義,則採用預設值)。
ContainerController
  baselineShift : *
TextLayoutFormat:從 dominantBaseline 值位移基線的量。
ContainerController
  blockProgression : *
TextLayoutFormat:指定行位置為垂直或水平走向。
ContainerController
  breakOpportunity : *
TextLayoutFormat:將換行文字斷行時,控制斷行的位置。
ContainerController
  cffHinting : *
TextLayoutFormat:用於此文字的 CFF 提示類型。
ContainerController
  clearFloats : *
TextLayoutFormat:控制文字包圍在浮動物件四周的方式。
ContainerController
  color : *
TextLayoutFormat:文字的色彩。
ContainerController
  columnCount : *
TextLayoutFormat:文字欄的數目 (如果重疊顯示時未定義,則採用預設值)。
ContainerController
  columnGap : *
TextLayoutFormat:以像素為單位,指定欄之間所留間距空間的量 (如果重疊顯示時未定義,則採用預設值)。
ContainerController
  columnState : ColumnState
[唯讀] 傳回 ColumnState 物件,其描述容器中直欄的數目與特性。
ContainerController
  columnWidth : *
TextLayoutFormat:以像素為單位的欄寬 (如果重疊顯示時未定義,則採用預設值)。
ContainerController
  compositionHeight : Number
[唯讀] 傳回容器內的文字允許的垂直範圍。
ContainerController
  compositionWidth : Number
[唯讀] 傳回容器內的文字允許的水平範圍。
ContainerController
  computedFormat : flashx.textLayout.formats:ITextLayoutFormat
[唯讀] 傳回特質已套用至此容器的 ITextLayoutFormat 實體,包括從其根元素繼承的特質。
ContainerController
 Inheritedconstructor : Object
類別物件的參照或是特定物件實體的建構函數。
Object
  container : Sprite
[唯讀] 傳回存放此 ContainerController 實體之文字行的容器顯示物件。
ContainerController
  containerControllerInitialFormat : flashx.textLayout.formats:ITextLayoutFormat
[靜態]
ContainerController
  coreStyles : Object
[唯讀] 傳回此 ContainerController 的 coreStyles。
ContainerController
  digitCase : *
TextLayoutFormat:用於此文字的數字大小寫類型。
ContainerController
  digitWidth : *
TextLayoutFormat:用於此文字的數字寬度類型。
ContainerController
  direction : *
TextLayoutFormat:指定文字區塊內文字的預設雙向內嵌層級。
ContainerController
  dominantBaseline : *
TextLayoutFormat:指定貼齊 alignmentBaseline 的元素基線,以決定行上元素的垂直位置。
ContainerController
  firstBaselineOffset : *
TextLayoutFormat:指定容器中第一行的基線位置。
ContainerController
  flowComposer : IFlowComposer
[唯讀] 傳回流排撰寫器物件,該物件可撰寫和反白此控制器管理之容器的文字。
ContainerController
  fontFamily : *
TextLayoutFormat:要使用的字體名稱,或是以逗號分隔的字體名稱清單。
ContainerController
  fontLookup : *
TextLayoutFormat:要使用字體查詢。
ContainerController
  fontSize : *
TextLayoutFormat:以像素為單位的文字大小。
ContainerController
  fontStyle : *
TextLayoutFormat:文字樣式。
ContainerController
  fontWeight : *
TextLayoutFormat:字體粗細。
ContainerController
  format : flashx.textLayout.formats:ITextLayoutFormat
儲存 ITextLayoutFormat 物件,該物件包含此容器的特質。
ContainerController
  horizontalScrollPolicy : String
指定水平捲動原則,可指定下列 ScrollPolicy 類別常數之一:ON、OFF 或 AUTO。
ContainerController
  horizontalScrollPosition : Number
指定舞台上目前的水平捲動位置。
ContainerController
  interactionManager : ISelectionManager
[唯讀] 與此 TextFlow 物件相關的 InteractionManager。
ContainerController
  justificationRule : *
TextLayoutFormat:對齊段落中文字所使用的規則。
ContainerController
  justificationStyle : *
TextLayoutFormat:段落對齊所用的樣式。
ContainerController
  kerning : *
TextLayoutFormat:字距微調會調整某些字元組之間的像素,以改善可讀性。
ContainerController
  leadingModel : *
TextLayoutFormat:指定行距模型,它結合了行距基礎及行距方向。
ContainerController
  ligatureLevel : *
TextLayoutFormat:控制字體中定義的哪些連字可用於文字。
ContainerController
  lineBreak : *
TextLayoutFormat:控制容器內的文字換行 (如果重疊顯示時未定義,則採用預設值)。
ContainerController
  lineHeight : *
TextLayoutFormat:文字的行距控制。
ContainerController
  lineThrough : *
TextLayoutFormat:若為 true,將套用刪除線,亦即通過文字中間的線。
ContainerController
  linkActiveFormat : *
TextLayoutFormat:定義正常狀態下的連結格式化特質。
ContainerController
  linkHoverFormat : *
TextLayoutFormat:定義滑鼠位於連結範圍 (滑入) 時,停留狀態連結的格式化特質。
ContainerController
  linkNormalFormat : *
TextLayoutFormat:定義正常狀態下的連結格式化特質。
ContainerController
  listAutoPadding : *
TextLayoutFormat:當清單開始邊緣該側的邊框距離值設為 auto 時,這會將清單的開始邊緣指定為自動縮排。
ContainerController
  listMarkerFormat : *
TextLayoutFormat:定義格式化特質清單標記。
ContainerController
  listStylePosition : *
TextLayoutFormat:有效值為 ListStylePosition.INSIDE、ListStylePosition.OUTSIDE、FormatValue.INHERIT。若未定義預設值,則表示未設定。如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。
ContainerController
  listStyleType : *
TextLayoutFormat:有效值為 ListStyleType.UPPER_ALPHA、ListStyleType.LOWER_ALPHA、ListStyleType.UPPER_ROMAN、ListStyleType.LOWER_ROMAN、ListStyleType.NONE、ListStyleType.DISC、ListStyleType.CIRCLE、ListStyleType.SQUARE、ListStyleType.BOX、ListStyleType.CHECK、ListStyleType.DIAMOND、ListStyleType.HYPHEN、ListStyleType.ARABIC_INDIC、ListStyleType.BENGALI、ListStyleType.DECIMAL、ListStyleType.DECIMAL_LEADING_ZERO、ListStyleType.DEVANAGARI、ListStyleType.GUJARATI、ListStyleType.GURMUKHI、ListStyleType.KANNADA、ListStyleType.PERSIAN、ListStyleType.THAI、ListStyleType.URDU、ListStyleType.CJK_EARTHLY_BRANCH、ListStyleType.CJK_HEAVENLY_STEM、ListStyleType.HANGUL、ListStyleType.HANGUL_CONSTANT、ListStyleType.HIRAGANA、ListStyleType.HIRAGANA_IROHA、ListStyleType.KATAKANA、ListStyleType.KATAKANA_IROHA、ListStyleType.LOWER_ALPHA、ListStyleType.LOWER_GREEK、ListStyleType.LOWER_LATIN、ListStyleType.UPPER_ALPHA、ListStyleType.UPPER_GREEK、ListStyleType.UPPER_LATIN、FormatValue.INHERIT。若未定義預設值,則表示未設定。如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。
ContainerController
  locale : *
TextLayoutFormat:文字的地區設定。
ContainerController
  paddingBottom : *
TextLayoutFormat:下方內移距 (像素)。
ContainerController
  paddingLeft : *
TextLayoutFormat:左方內移距 (像素)。
ContainerController
  paddingRight : *
TextLayoutFormat:右方內移距 (像素)。
ContainerController
  paddingTop : *
TextLayoutFormat:上方內移距 (像素)。
ContainerController
  paragraphEndIndent : *
TextLayoutFormat:指定段落結尾邊緣縮排量的數字 (以像素為單位)。
ContainerController
  paragraphSpaceAfter : *
TextLayoutFormat:一個數字,指定段落後面要保留的空間量 (像素)。
ContainerController
  paragraphSpaceBefore : *
TextLayoutFormat:一個數字,指定段落前面要保留的空間量 (像素)。
ContainerController
  paragraphStartIndent : *
TextLayoutFormat:指定段落開頭邊緣縮排量的數字 (以像素為單位)。
ContainerController
  renderingMode : *
TextLayoutFormat:用於此文字的顯示模式。
ContainerController
  rootElement : ContainerFormattedElement
[唯讀] 傳回在容器中顯示的根元素。
ContainerController
  styleName : *
TextLayoutFormat:指定元素的識別類別,如此只要參照此 styleName 就可以設定元素的樣式。
ContainerController
  styles : Object
[唯讀] 傳回此 ContainerController 的樣式。
ContainerController
  tabStops : *
TextLayoutFormat:指定段落關聯的定位停駐點。
ContainerController
  textAlign : *
TextLayoutFormat:段落中各行相對於容器的對齊方式。
ContainerController
  textAlignLast : *
TextLayoutFormat:段落中最後 (或唯一的) 一行相對於齊行文字中之容器的對齊方式。
ContainerController
  textAlpha : *
TextLayoutFormat:文字的 Alpha (透明) 值。
ContainerController
  textDecoration : *
TextLayoutFormat:文字上的裝飾。
ContainerController
  textFlow : flashx.textLayout.elements:TextFlow
[唯讀] 傳回其內容顯示於容器中的 TextFlow 物件。
ContainerController
  textIndent : *
TextLayoutFormat:以像素為單位,指定段落中第一行縮排量的數字。
ContainerController
  textJustify : *
TextLayoutFormat:指定對齊文字的選項。
ContainerController
  textLength : int
[唯讀] 傳回容器中的字元總數。
ContainerController
  textRotation : *
TextLayoutFormat:決定此文字要旋轉的度數。
ContainerController
  trackingLeft : *
TextLayoutFormat:以像素為單位代表要套用至每個字元左側字距調整 (手動字距微調) 量的數字 (或 fontSize 的百分比,例如,120%)。
ContainerController
  trackingRight : *
TextLayoutFormat:以像素為單位代表要套用至每個字元右側字距調整 (手動字距微調) 量的數字 (或 fontSize 的百分比,例如,120%)。
ContainerController
  typographicCase : *
TextLayoutFormat:用於此文字的印刷大小寫類型。
ContainerController
  userStyles : Object
可讓您讀寫 ContainerController 物件上的使用者樣式。
ContainerController
  verticalAlign : *
TextLayoutFormat:垂直對齊或齊行 (如果重疊顯示時未定義,則採用預設值)。
ContainerController
  verticalScrollPolicy : String
指定垂直捲動原則,可指定下列 ScrollPolicy 類別常數之一:ON、OFF 或 AUTO。
ContainerController
  verticalScrollPosition : Number
指定舞台上目前的垂直捲動位置。
ContainerController
  whiteSpaceCollapse : *
TextLayoutFormat:將文字匯入 TextFlow 時捨去或保留空格。
ContainerController
  wordSpacing : *
TextLayoutFormat:指定對齊時要使用之文字間的最佳、最小及最大間距 (標準間距寬度的倍數)。
ContainerController
公用方法
 方法定義自
  
ContainerController(container:Sprite, compositionWidth:Number = 100, compositionHeight:Number = 100)
建構函式 - 建立一個 ContainerController 實體。
ContainerController
  
當用戶端管理事件時,處理 Event.ACTIVATE 事件
ContainerController
  
在選擇「拖曳」時處理捲動事件。
ContainerController
  
呼叫時要求用戶端從安全執行程序之外開始轉送 mouseup 與 mousemove 事件。
ContainerController
  
從此 FlowElement 清除 styleProp 指定的樣式。
ContainerController
  
當用戶端管理事件時,處理 Event.DEACTIVATE 事件。
ContainerController
  
當用戶端管理事件時,處理編輯事件 (CUT、COPY、PASTE、SELECT_ALL)。
ContainerController
  
呼叫時通知用戶端不再需要從安全執行程序之外轉送 mouseup 與 mousemove 事件。
ContainerController
  
當用戶端管理事件時,處理 FocusEvent.KEY_FOCUS_CHANGE 與 FocusEvent.MOUSE_FOCUS_CHANGE 事件。
ContainerController
  
當用戶端管理事件時,處理 FocusEvent.FOCUS_IN 事件。
ContainerController
  
當用戶端管理事件時,處理 FocusEvent.FOCUS_OUT 事件。
ContainerController
  
傳回文字佔用的區域,如同最後的撰寫或更新作業所鏡射。
ContainerController
  
了解往上或往下捲動指定的行數時所需的捲動距離。
ContainerController
  
getStyle(styleProp:String):*
傳回 styleProp 參數指定的樣式值。
ContainerController
 Inherited
指出物件是否有已定義的指定屬性。
Object
  
當用戶端管理事件時,處理 IMEEvent.IME_START_COMPOSITION 事件。
ContainerController
  
將此容器中的所有文字標示為需要撰寫。
ContainerController
  
判斷容器是否有需要撰寫的文字。
ContainerController
 Inherited
指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。
Object
  
當用戶端管理事件時,處理 KeyboardEvent.KEY_DOWN 事件。
ContainerController
  
當用戶端管理事件時,處理 FocusEvent.KEY_FOCUS_CHANGE 事件。
ContainerController
  
當用戶端管理事件時,處理 Keyboard.KEY_UP 事件。
ContainerController
  
當用戶端管理事件時,處理 ContextMenuEvent.MENU_SELECT 事件。
ContainerController
  
當用戶端管理事件時,處理 MouseEvent.DOUBLE_CLICK 事件。
ContainerController
  
當用戶端管理事件時,處理 MouseEvent.MOUSE_DOWN 事件。
ContainerController
  
當用戶端管理事件時,處理 MouseEvent.MOUSE_MOVE 事件。
ContainerController
  
從安全執行程序之外轉送 mouseMove 事件的用戶端呼叫。
ContainerController
  
當用戶端管理事件時,處理 MouseEvent.MOUSE_OUT 事件。
ContainerController
  
當用戶端管理事件時,處理 MouseEvent.MOUSE_OVER 事件。
ContainerController
  
當用戶端管理事件時,處理 MouseEvent.MOUSE_UP 事件。
ContainerController
  
從安全執行程序之外轉送 mouseUp 事件的用戶端呼叫。
ContainerController
  
當用戶端管理事件時,處理 MouseEvent.MOUSE_WHEEL 事件。
ContainerController
 Inherited
指出指定的屬性是否存在,以及是否可列舉。
Object
  
scrollToRange(activePosition:int, anchorPosition:int):void
捲動以讓文字範圍顯示在容器中。
ContainerController
  
selectRange(anchorIndex:int, activeIndex:int):void
在實作 ITextSupport 的組件中設定選取文字的範圍。
ContainerController
  
設定容器中允許的文字寬度和高度。
ContainerController
 Inherited
為迴圈作業設定動態屬性的可用性。
Object
  
setStyle(styleProp:String, newValue:*):void
將 styleProp 參數指定的樣式值設定為 newValue 參數指定的值。
ContainerController
  
當用戶端管理事件時,處理 SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATING 事件。
ContainerController
  
當用戶端管理事件時,處理 TextEvent.TEXT_INPUT 事件。
ContainerController
 Inherited
傳回代表此物件的字串,根據地區特定慣例進行格式化。
Object
 Inherited
會傳回指定之物件的字串形式。
Object
 Inherited
會傳回指定之物件的基本值。
Object
保護方法
 方法定義自
  
新增 flash.display.Shape 物件,可在其上繪製背景形狀 (例如,背景色彩)。
ContainerController
  
新增 flash.display.DisplayObject 物件為父輩的後代。
ContainerController
  
新增 flash.display.DisplayObjectContainer 物件至選取範圍形狀 (例如,區塊選取反白標示、游標等等)。
ContainerController
  
新增 flash.text.engine.TextLine 物件為容器的後代。
ContainerController
  
為 ContainerController 建立內容選單。
ContainerController
  
取得第一行文字必須在其父輩顯示的索引。
ContainerController
  
移除可在其上繪製背景形狀 (例如,背景色彩) flash.display.Shape 物件。
ContainerController
  
將 flash.display.DisplayObject 物件從其父輩中移除。
ContainerController
  
移除包含選取範圍形狀 (例如,區塊選取反白標示、游標等等) 的 flash.display.DisplayObjectContainer 物件。
ContainerController
  
將 flash.text.engine.TextLine 物件從其父輩中移除。
ContainerController
  
如果捲動,請將捲動矩形設定為容器矩形,如此畫面中任何未能全部顯示的行就會剪裁至可捲動區域。
ContainerController
屬性詳細資訊

_mouseWheelListenerAttached

屬性
tlf_internal var _mouseWheelListenerAttached:Boolean = false

absoluteStart

屬性 
absoluteStart:int  [唯讀]

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

傳回容器中的第一個字元。如果這不是流排中的第一個容器,則撰寫文字時會更新此值,即呼叫 IFlowComposer's compose()updateAllControllers() 方法時。



實作
    public function get absoluteStart():int

相關 API 元素

alignmentBaseline

屬性 
alignmentBaseline:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:指定主基線對齊的基線。例如,如果設定 dominantBaseline 為 ASCENT,設定 alignmentBaseline 為 DESCENT 會使得文字上方對齊 DESCENT 基線,或在基線之下。通常是由字行中的最大元素決定基線。

baselines

有效值是 TextBaseline.ROMAN、TextBaseline.ASCENT、TextBaseline.DESCENT、TextBaseline.IDEOGRAPHIC_TOP、TextBaseline.IDEOGRAPHIC_CENTER、TextBaseline.IDEOGRAPHIC_BOTTOM、TextBaseline.USE_DOMINANT_BASELINE、FormatValue.INHERIT。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。如果沒有祖系設定此屬性,則值將為 TextBaseline.USE_DOMINANT_BASELINE。



實作
    public function get alignmentBaseline():*
    public function set alignmentBaseline(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

相關 API 元素

backgroundAlpha

屬性 
backgroundAlpha:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:背景的 Alpha (透明度) 值 (如果重疊顯示時未定義,則採用預設值)。值為 0 時表示完全透明,值為 1 時表示完全不透明。alpha 設為 0 的顯示物件都是作用中的狀態,即使看不見它們亦然。

有效值是從 0 到 1 的數字以及 FormatValue.INHERIT。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義,則此屬性的值就會是 1。



實作
    public function get backgroundAlpha():*
    public function set backgroundAlpha(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

backgroundColor

屬性 
backgroundColor:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:文字的背景色彩 (如果重疊顯示時未定義,則採用預設值)。可以是常數值 BackgroundColor.TRANSPARENT,或指定 3 個 8 位元 RGB (紅色、綠色、藍色) 值的 16 進位值;例如,0xFF0000 是紅色,而 0x00FF00 是綠色。

有效字串值為 BackgroundColor.TRANSPARENT、FormatValue.INHERIT 以及從 0x0 到 0xffffffff 的單位。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義,則此屬性的值就會是 BackgroundColor.TRANSPARENT。



實作
    public function get backgroundColor():*
    public function set backgroundColor(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

相關 API 元素

baselineShift

屬性 
baselineShift:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:從 dominantBaseline 值位移基線的量。單位為像素,或 fontSize 的百分比 (在此情況下,請輸入字串值,如 140%)。正值會將水平文字上移 (垂直文字則右移),負值則會將水平文字下移 (垂直文字則左移)。

有效值是 BaselineShift.SUPERSCRIPT、BaselineShift.SUBSCRIPT、FormatValue.INHERIT。

有效值是從 -1000 到 1000 之間的數字。

有效值是從 -1000 到 1000 之間數字的百分比。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。如果沒有祖系設定此屬性,則值將為 0.0。



實作
    public function get baselineShift():*
    public function set baselineShift(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

相關 API 元素

blockProgression

屬性 
blockProgression:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:指定行位置為垂直或水平走向。行由上到下 (BlockProgression.TB,用於水平文字) 排列,或由右向左 (BlockProgression.RL,用於垂直文字) 排列。

有效值是 BlockProgression.RL、BlockProgression.TB、FormatValue.INHERIT。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。如果沒有祖系設定此屬性,則值將為 BlockProgression.TB。



實作
    public function get blockProgression():*
    public function set blockProgression(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

相關 API 元素

breakOpportunity

屬性 
breakOpportunity:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:將換行文字斷行時,控制斷行的位置。設定為 BreakOpportunity.AUTO 以一般方式斷行。設定為 BreakOpportunity.NONE 則文字不斷行,除非文字超過度量且沒有其他空間可斷行。。設定為 BreakOpportunity.ANY 可在任意位置斷行,而非只限於在單字之間斷行。設定為 BreakOpportunity.ALL 使每個印刷群集放置於個別行 (對路徑上的文字很實用)。

有效值為 BreakOpportunity.ALL、BreakOpportunity.ANY、BreakOpportunity.AUTO、BreakOpportunity.NONE、FormatValue.INHERIT。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。如果沒有祖系設定此屬性,則值將為 BreakOpportunity.AUTO。



實作
    public function get breakOpportunity():*
    public function set breakOpportunity(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

相關 API 元素

cffHinting

屬性 
cffHinting:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:用於此文字的 CFF 提示類型。CFF 提示會決定 Flash 執行階段是否強制強式水平詞幹以符合子像素格線。只有當 renderingMode 屬性設定為 RenderingMode.CFF,且字體為內嵌時 (fontLookup 屬性設定為 FontLookup.EMBEDDED_CFF),才會套用此屬性。在小型螢幕上,提示會為讀者產生清晰、易辨識的文字。

有效值為 CFFHinting.NONE、CFFHinting.HORIZONTAL_STEM、FormatValue.INHERIT。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。如果沒有祖系設定此屬性,則值將為 CFFHinting.HORIZONTAL_STEM。



實作
    public function get cffHinting():*
    public function set cffHinting(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

相關 API 元素

clearFloats

屬性 
clearFloats:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:控制文字包圍在浮動物件四周的方式。若值為 none,將允許文字以最緊密的方式圍繞在浮動物件的四周。若值為 left,將導致文字略過含有左邊浮動物件之容器的任何部分;若值為 right,將導致文字略過含有右邊浮動物件之容器的任何部分。若值為 both,將導致文字略過所有的浮動物件。

有效值為 ClearFloats.START、ClearFloats.END、ClearFloats.LEFT、ClearFloats.RIGHT、ClearFloats.BOTH、ClearFloats.NONE、FormatValue.INHERIT。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義,則此屬性的值就會是 ClearFloats.NONE。



實作
    public function get clearFloats():*
    public function set clearFloats(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

相關 API 元素

color

屬性 
color:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:文字的色彩。指定 3 個 8 位元 RGB (紅色、綠色、藍色) 值的 16 進位數字;例如 0xFF0000 為紅色,而 0x00FF00 為綠色。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。如果沒有祖系設定此屬性,則值將為 0。



實作
    public function get color():*
    public function set color(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

columnCount

屬性 
columnCount:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:文字欄的數目 (如果重疊顯示時未定義,則採用預設值)。欄的數目會覆寫其他的欄設定。值為整數,如果未指定值,則為 FormatValue.AUTO。如果未指定 columnCount,則會使用 columnWidth 建立容器內可容納的最大欄位數目。

有效字串值為 FormatValue.AUTO、FormatValue.INHERIT 以及從 1 至 50 的整數。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義,則此屬性的值就會是 FormatValue.AUTO。



實作
    public function get columnCount():*
    public function set columnCount(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

相關 API 元素

columnGap

屬性 
columnGap:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:以像素為單位,指定欄之間所留間距空間的量 (如果重疊顯示時未定義,則採用預設值)。值為數字

有效值是從 0 到 1000 的數字以及 FormatValue.INHERIT。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義,則此屬性的值就會是 20。



實作
    public function get columnGap():*
    public function set columnGap(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

columnState

屬性 
columnState:ColumnState  [唯讀]

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

傳回 ColumnState 物件,其描述容器中直欄的數目與特性。無論是 IFlowComposer.compose()IFlowComposer.updateAllControllers(),只要重新撰寫文字時,就會更新這些值。



實作
    public function get columnState():ColumnState

相關 API 元素

columnWidth

屬性 
columnWidth:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:以像素為單位的欄寬 (如果重疊顯示時未定義,則採用預設值)。如果您指定欄的寬度,而非數目,則在具有容器寬度和 columnGap 設定的情況下,TextLayout 會儘可能建立符合該寬度的最大欄數。在最後一欄之後,任何剩餘的空格都是靠左對齊。值為數字。

有效字串值為 FormatValue.AUTO、FormatValue.INHERIT 以及從 0 到 8000 的數字。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義,則此屬性的值就會是 FormatValue.AUTO。



實作
    public function get columnWidth():*
    public function set columnWidth(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

相關 API 元素

compositionHeight

屬性 
compositionHeight:Number  [唯讀]

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

傳回容器內的文字允許的垂直範圍。指定的值是以像素為單位。



實作
    public function get compositionHeight():Number

相關 API 元素

compositionWidth

屬性 
compositionWidth:Number  [唯讀]

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

傳回容器內的文字允許的水平範圍。指定的值是以像素為單位。



實作
    public function get compositionWidth():Number

相關 API 元素

computedFormat

屬性 
computedFormat:flashx.textLayout.formats:ITextLayoutFormat  [唯讀]

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

傳回特質已套用至此容器的 ITextLayoutFormat 實體,包括從其根元素繼承的特質。



實作
    public function get computedFormat():flashx.textLayout.formats:ITextLayoutFormat

相關 API 元素

container

屬性 
container:Sprite  [唯讀]

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

傳回存放此 ContainerController 實體之文字行的容器顯示物件。



實作
    public function get container():Sprite

相關 API 元素

containerControllerInitialFormat

屬性 
containerControllerInitialFormat:flashx.textLayout.formats:ITextLayoutFormat



實作
    public static function get containerControllerInitialFormat():flashx.textLayout.formats:ITextLayoutFormat
    public static function set containerControllerInitialFormat(value:flashx.textLayout.formats:ITextLayoutFormat):void

coreStyles

屬性 
coreStyles:Object  [唯讀]

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

傳回此 ContainerController 的 coreStyles。注意:getter 會複製核心樣式字典。傳回的物件包含由 TextLayoutFormat 定義且位於 TextLayoutFormat.description 中的格式。傳回的物件包含一個 stylename-value 組的陣列。



實作
    public function get coreStyles():Object

相關 API 元素

digitCase

屬性 
digitCase:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:用於此文字的數字大小寫類型。設定值為 DigitCase.OLD_STYLE 會使用不同的字母上緣和字母下緣模擬小寫字體。數字是等比例的間距。只有在選取的字樣中可使用此樣式,大部分是在補充或專業字體中。DigitCase.LINING 設定具有全部大寫字高度,而且通常在圖表中以固定間距排列。

digitCase

有效值為 DigitCase.DEFAULT、DigitCase.LINING、DigitCase.OLD_STYLE、FormatValue.INHERIT。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。如果沒有祖系設定此屬性,則值將為 DigitCase.DEFAULT。



實作
    public function get digitCase():*
    public function set digitCase(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

相關 API 元素

digitWidth

屬性 
digitWidth:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:用於此文字的數字寬度類型。這可以是 DigitWidth.PROPORTIONAL (對於個別數字的顯示效果最佳) 或 DigitWidth.TABULAR (最適用於表格、圖表及垂直行中的數字)。

digitWidth

有效值為 DigitWidth.DEFAULT、DigitWidth.PROPORTIONAL、DigitWidth.TABULAR、FormatValue.INHERIT。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。如果沒有祖系設定此屬性,則值將為 DigitWidth.DEFAULT。



實作
    public function get digitWidth():*
    public function set digitWidth(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

相關 API 元素

direction

屬性 
direction:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:指定文字區塊內文字的預設雙向內嵌層級。由左向右的讀取順序,如同拉丁文樣式手寫體,或由右向左的讀取順序,如同阿拉伯文或希伯來文。在容器層級套用此屬性時,它也會影響欄方向。就像文字一樣,欄可以由左向右或由右向左。下面是一些範例:

direction

有效值為 Direction.LTR、Direction.RTL、FormatValue.INHERIT。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。如果沒有祖系設定此屬性,則值將為 Direction.LTR。



實作
    public function get direction():*
    public function set direction(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

相關 API 元素

dominantBaseline

屬性 
dominantBaseline:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:指定貼齊 alignmentBaseline 的元素基線,以決定行上元素的垂直位置。TextBaseline.AUTO 的值根據父段落的 locale 屬性選取主基線。針對日文與中文,選取的基線值為 TextBaseline.IDEOGRAPHIC_CENTER;其他則為 TextBaseline.ROMAN。這些基線的選擇是由字體及字體大小的選擇所決定。

baselines

有效值為 FormatValue.AUTO、TextBaseline.ROMAN、TextBaseline.ASCENT、TextBaseline.DESCENT、TextBaseline.IDEOGRAPHIC_TOP、TextBaseline.IDEOGRAPHIC_CENTER、TextBaseline.IDEOGRAPHIC_BOTTOM、FormatValue.INHERIT。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。如果沒有祖系設定此屬性,則值將為 FormatValue.AUTO。



實作
    public function get dominantBaseline():*
    public function set dominantBaseline(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

相關 API 元素

firstBaselineOffset

屬性 
firstBaselineOffset:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:指定容器中第一行的基線位置。此屬性參照的基線,是依據容器層級地區而定。對於日文和中文,它會是 TextBaseline.IDEOGRAPHIC_BOTTOM;而對於所有其他語言,則為 TextBaseline.ROMAN。從容器的上方內移距 (或如果 blockProgression 是 RL,則為右方內移距) 到首行基線的偏移量,可以是 BaselineOffset.ASCENT (相當於字行上緣)、BaselineOffset.LINE_HEIGHT (相當於首行高度),或任何固定值數字,以指定絕對距離。BaselineOffset.AUTO 對齊字行上緣與容器上方內移距。

firstBaselineOffset1firstBaselineOffset2firstBaselineOffset3firstBaselineOffset4

有效字串值為 BaselineOffset.AUTO、BaselineOffset.ASCENT、BaselineOffset.LINE_HEIGHT、FormatValue.INHERIT 以及從 0 到 1000 的數字。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。如果沒有祖系設定此屬性,則值將為 BaselineOffset.AUTO。



實作
    public function get firstBaselineOffset():*
    public function set firstBaselineOffset(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

相關 API 元素

flowComposer

屬性 
flowComposer:IFlowComposer  [唯讀]

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

傳回流排撰寫器物件,該物件可撰寫和反白此控制器管理之容器的文字。



實作
    public function get flowComposer():IFlowComposer

相關 API 元素

fontFamily

屬性 
fontFamily:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:要使用的字體名稱,或是以逗號分隔的字體名稱清單。Flash 執行階段會以清單中的第一個可用字體來顯示元素。例如,Arial, Helvetica, _sans 會讓 Player 先搜尋 Arial,如果找不到 Arial 則搜尋 Helvetica,如果這兩項都找不到,則搜尋 _sans。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。如果沒有祖系設定此屬性,則值將為 Arial。



實作
    public function get fontFamily():*
    public function set fontFamily(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

fontLookup

屬性 
fontLookup:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:要使用字體查詢。指定 FontLookup.DEVICE 使用執行 SWF 檔案之系統上所安裝的字體。裝置字體會導致影片大小變得較小,但文字在不同系統及平台間的顯示不盡相同。指定 FontLookup.EMBEDDED_CFF 使用內嵌於已發佈的 SWF 檔案的字體外框。內嵌的字體會增加 SWF 檔案的大小 (有時差距極大),但文字會一律以所選的字體顯示。

有效值為 FontLookup.DEVICE、FontLookup.EMBEDDED_CFF、FormatValue.INHERIT。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。如果沒有祖系設定此屬性,則值將為 FontLookup.DEVICE。



實作
    public function get fontLookup():*
    public function set fontLookup(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

相關 API 元素

fontSize

屬性 
fontSize:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:以像素為單位的文字大小。

有效值是從 1 到 720 的數字以及 FormatValue.INHERIT。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。如果沒有祖系設定此屬性,則值將為 12。



實作
    public function get fontSize():*
    public function set fontSize(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

fontStyle

屬性 
fontStyle:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:文字樣式。可以是 FontPosture.NORMAL (用於純文字) 或 FontPosture.ITALIC (用於斜體字)。此屬性只套用到裝置字體 (fontLookup 屬性設定為 flash.text.engine.FontLookup.DEVICE)。

有效值是 FontPosture.NORMAL、FontPosture.ITALIC、FormatValue.INHERIT。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。如果沒有祖系設定此屬性,則值將為 FontPosture.NORMAL。



實作
    public function get fontStyle():*
    public function set fontStyle(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

相關 API 元素

fontWeight

屬性 
fontWeight:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:字體粗細。可以是 FontWeight.NORMAL (用於純文字) 或 FontWeight.BOLD。只套用到裝置字體 (fontLookup 屬性設定為 flash.text.engine.FontLookup.DEVICE)。

有效值為 FontWeight.NORMAL、FontWeight.BOLD、FormatValue.INHERIT。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。如果沒有祖系設定此屬性,則值將為 FontWeight.NORMAL。



實作
    public function get fontWeight():*
    public function set fontWeight(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

相關 API 元素

format

屬性 
format:flashx.textLayout.formats:ITextLayoutFormat

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

儲存 ITextLayoutFormat 物件,該物件包含此容器的特質。控制器會繼承所屬 TextFlow 的容器屬性。此屬性允許相同文字流排中的不同控制器擁有不同的直欄設定或邊框距離等。



實作
    public function get format():flashx.textLayout.formats:ITextLayoutFormat
    public function set format(value:flashx.textLayout.formats:ITextLayoutFormat):void

相關 API 元素

horizontalScrollPolicy

屬性 
horizontalScrollPolicy:String

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

指定水平捲動原則,可指定下列 ScrollPolicy 類別常數之一:ON、OFF 或 AUTO。



實作
    public function get horizontalScrollPolicy():String
    public function set horizontalScrollPolicy(value:String):void

相關 API 元素

horizontalScrollPosition

屬性 
horizontalScrollPosition:Number

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

指定舞台上目前的水平捲動位置。此值會指定從左側算起的像素數目。



實作
    public function get horizontalScrollPosition():Number
    public function set horizontalScrollPosition(value:Number):void

interactionManager

屬性 
interactionManager:ISelectionManager  [唯讀]

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

與此 TextFlow 物件相關的 InteractionManager。

控制文字的所有選取及編輯。如果 TextFlow 是無法選取的,則 interactionManager 會是 null。若要讓 TextFlow 成為可編輯的,請指定同時為 ISelectionManager 及 IEditManager 的 interactionManager。若要讓 TextFlow 成為唯讀且允許選取,則請指定僅有 ISelectionManager 身分的 interactionManager。



實作
    public function get interactionManager():ISelectionManager

相關 API 元素

justificationRule

屬性 
justificationRule:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:對齊段落中文字所使用的規則。預設值為 FormatValue.AUTO,可根據段落的 locale 屬性來對齊文字。除了日文與中文之外的所有語言,FormatValue.AUTO 會成為 JustificationRule.SPACE,可為空白字元增加額外的空間。針對日文與中文,FormatValue.AUTO 會成為 JustficationRule.EAST_ASIAN。對齊在某種程度上會變更標點符號的間距。在羅馬文字中,逗號與日文句號佔用完整的字元寬度,但是在東亞文字中,則只有一半的字元寬度。此外,在東亞文字中,連續標點符號之間的間距會變得較小,以遵循傳統東亞印刷慣例。請注意,下列範例中,行距會套用至段落的第二行。在東亞版本中,最後兩行向左推送。在羅馬版本中,第二行以及接續的字行向左推送。

justificationRule

有效值為 JustificationRule.EAST_ASIAN、JustificationRule.SPACE、FormatValue.AUTO、FormatValue.INHERIT。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。如果沒有祖系設定此屬性,則值將為 FormatValue.AUTO。



實作
    public function get justificationRule():*
    public function set justificationRule(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

相關 API 元素

justificationStyle

屬性 
justificationStyle:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:段落對齊所用的樣式。只能與 JustificationRule.EAST_ASIANjustificationRule 設定一起使用。FormatValue.AUTO 的預設值針對所有地區設定解析為 JustificationStyle.PUSH_IN_KINSOKU。JustificationStyle 類別定義的常數指定處理避頭尾字元 (不能在字行開頭或結尾出現的日文字元) 的選項。如果您要加寬文字,請指定 JustificationStyle.PUSH-OUT-ONLY。如果您想要讓行為的效果類似使用 JustificationRule.SPACEjustificationRule 的效果,請使用 JustificationStyle.PRIORITIZE-LEAST-ADJUSTMENT

有效值為 JustificationStyle.PRIORITIZE_LEAST_ADJUSTMENT、JustificationStyle.PUSH_IN_KINSOKU、JustificationStyle.PUSH_OUT_ONLY、FormatValue.AUTO、FormatValue.INHERIT。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。如果沒有祖系設定此屬性,則值將為 FormatValue.AUTO。



實作
    public function get justificationStyle():*
    public function set justificationStyle(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

相關 API 元素

kerning

屬性 
kerning:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:字距微調會調整某些字元組之間的像素,以改善可讀性。具有特殊字距表的所有字體都支援特殊字距。

有效值為 Kerning.ON、Kerning.OFF、Kerning.AUTO、FormatValue.INHERIT。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。如果沒有祖系設定此屬性,則值將為 Kerning.AUTO。



實作
    public function get kerning():*
    public function set kerning(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

相關 API 元素

leadingModel

屬性 
leadingModel:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:指定行距模型,它結合了行距基礎及行距方向。行距基礎是 lineHeight 屬性參照的基線。行矩方向決定 lineHeight 屬性參照的是某線條基線與其前線條之間的距離,或是與其後線條之間的距離。FormatValue.AUTO 的預設值乃是根據段落的 locale 屬性來解析。對於日文和中文,它會是 LeadingModel.IDEOGRAPHIC_TOP_DOWN,而對於所有其他語言,則是 LeadingModel.ROMAN_UP

行距基礎:

leadingBasis1 leadingBasis2 leadingBasis3

行距方向:

leadingDirection1 leadingDirection2 leadingDirection3

有效值為 LeadingModel.ROMAN_UP、LeadingModel.IDEOGRAPHIC_TOP_UP、LeadingModel.IDEOGRAPHIC_CENTER_UP、LeadingModel.IDEOGRAPHIC_TOP_DOWN、LeadingModel.IDEOGRAPHIC_CENTER_DOWN、LeadingModel.APPROXIMATE_TEXT_FIELD、LeadingModel.ASCENT_DESCENT_UP、LeadingModel.BOX、LeadingModel.AUTO、FormatValue.INHERIT。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。如果沒有祖系設定此屬性,則值將為 LeadingModel.AUTO。



實作
    public function get leadingModel():*
    public function set leadingModel(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

相關 API 元素

ligatureLevel

屬性 
ligatureLevel:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:控制字體中定義的哪些連字可用於文字。這些設定的每一個所顯示的連字與字體有相依性。當兩個以上的字母形式接合為單一字符時,會發生連字。連字通常會取代共享相同組件的連續字元,如字母組「fi」、「fl」或「ae」。連字可用於拉丁文和非拉丁文字元集。由於 LigatureLevel 類別的值 - MINIMUMCOMMONUNCOMMONEXOTIC 所啟用的連字具有累增效果。每個值啟用一組新的連字,但也包括先前類型。

注意:使用阿拉伯文或斯拉夫文字體時,ligatureLevel 必須設為 MINIMUM 或更大值。

ligatureLevel

有效值為 LigatureLevel.MINIMUM、LigatureLevel.COMMON、LigatureLevel.UNCOMMON、LigatureLevel.EXOTIC、FormatValue.INHERIT。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。如果沒有祖系設定此屬性,則值將為 LigatureLevel.COMMON。



實作
    public function get ligatureLevel():*
    public function set ligatureLevel(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

相關 API 元素

lineBreak

屬性 
lineBreak:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:控制容器內的文字換行 (如果重疊顯示時未定義,則採用預設值)。容器中的文字可設定為符合容器寬度 (LineBreak.TO_FIT),或者可設定為只在明確的歸位字元或換行字元 (LineBreak.EXPLICIT) 時斷行。

有效值是 LineBreak.EXPLICIT、LineBreak.TO_FIT、FormatValue.INHERIT。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義,則此屬性的值就會是 LineBreak.TO_FIT。



實作
    public function get lineBreak():*
    public function set lineBreak(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

相關 API 元素

lineHeight

屬性 
lineHeight:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:文字的行距控制。上一行或下一行基線 (根據 LeadingModel) 到目前字行基線的距離等於字行中任一字元所套用的最大行距。這可以是數字或百分比。如果指定百分比,請輸入字串值,如 140%。

lineHeight1lineHeight2

有效值是從 -720 到 720 之間的數字。

有效值是從 -1000% 到 1000% 之間數字的百分比。

有效值包括 FormatValue.INHERIT。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。如果沒有祖系設定此屬性,則值將為 120%。



實作
    public function get lineHeight():*
    public function set lineHeight(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

lineThrough

屬性 
lineThrough:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:若為 true,將套用刪除線,亦即通過文字中間的線。

有效值為 true、false 與 FormatValue.INHERIT。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。如果沒有祖系設定此屬性,則值將為 false。



實作
    public function get lineThrough():*
    public function set lineThrough(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

linkActiveFormat

屬性 
linkActiveFormat:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:定義正常狀態下的連結格式化特質。這個值會貫穿整個階層而且會套用至任何為後代的連結。接受 inheritITextLayoutFormat 或將具有索引鍵及值做為成員的物件陣列轉換為 TextLayoutFormat。

有效值包括 FormatValue.INHERIT。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。如果沒有祖系設定此屬性,則值將為 null。



實作
    public function get linkActiveFormat():*
    public function set linkActiveFormat(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

linkHoverFormat

屬性 
linkHoverFormat:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:定義滑鼠位於連結範圍 (滑入) 時,停留狀態連結的格式化特質。這個值會貫穿整個階層而且會套用至任何為後代的連結。接受 inheritITextLayoutFormat 或將具有索引鍵及值做為成員的物件陣列轉換為 TextLayoutFormat。

有效值包括 FormatValue.INHERIT。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。如果沒有祖系設定此屬性,則值將為 null。



實作
    public function get linkHoverFormat():*
    public function set linkHoverFormat(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

linkNormalFormat

屬性 
linkNormalFormat:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:定義正常狀態下的連結格式化特質。這個值會貫穿整個階層而且會套用至任何為後代的連結。接受 inheritITextLayoutFormat 或將具有索引鍵及值做為成員的物件陣列轉換為 TextLayoutFormat。

有效值包括 FormatValue.INHERIT。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。如果沒有祖系設定此屬性,則值將為 null。



實作
    public function get linkNormalFormat():*
    public function set linkNormalFormat(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

listAutoPadding

屬性 
listAutoPadding:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:當清單開始邊緣該側的邊框距離值設為 auto 時,這會將清單的開始邊緣指定為自動縮排。

有效值是從 -1000 到 1000 的數字以及 FormatValue.INHERIT。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。如果沒有祖系設定此屬性,則值將為 40。



實作
    public function get listAutoPadding():*
    public function set listAutoPadding(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

listMarkerFormat

屬性 
listMarkerFormat:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:定義格式化特質清單標記。這個值會貫穿整個階層而且會套用至任何為後代的連結。接受 inheritIListMarkerFormat 或將具有索引鍵及值做為成員的物件陣列轉換為 ListMarkerFormat。

有效值包括 FormatValue.INHERIT。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。如果沒有祖系設定此屬性,則值將為 null。



實作
    public function get listMarkerFormat():*
    public function set listMarkerFormat(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

listStylePosition

屬性 
listStylePosition:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:

有效值為 ListStylePosition.INSIDE、ListStylePosition.OUTSIDE、FormatValue.INHERIT。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。如果沒有祖系設定此屬性,則值將為 ListStylePosition.OUTSIDE。



實作
    public function get listStylePosition():*
    public function set listStylePosition(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

相關 API 元素

listStyleType

屬性 
listStyleType:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:

有效值為 ListStyleType.UPPER_ALPHA、ListStyleType.LOWER_ALPHA、ListStyleType.UPPER_ROMAN、ListStyleType.LOWER_ROMAN、ListStyleType.NONE、ListStyleType.DISC、ListStyleType.CIRCLE、ListStyleType.SQUARE、ListStyleType.BOX、ListStyleType.CHECK、ListStyleType.DIAMOND、ListStyleType.HYPHEN、ListStyleType.ARABIC_INDIC、ListStyleType.BENGALI、ListStyleType.DECIMAL、ListStyleType.DECIMAL_LEADING_ZERO、ListStyleType.DEVANAGARI、ListStyleType.GUJARATI、ListStyleType.GURMUKHI、ListStyleType.KANNADA、ListStyleType.PERSIAN、ListStyleType.THAI、ListStyleType.URDU、ListStyleType.CJK_EARTHLY_BRANCH、ListStyleType.CJK_HEAVENLY_STEM、ListStyleType.HANGUL、ListStyleType.HANGUL_CONSTANT、ListStyleType.HIRAGANA、ListStyleType.HIRAGANA_IROHA、ListStyleType.KATAKANA、ListStyleType.KATAKANA_IROHA、ListStyleType.LOWER_ALPHA、ListStyleType.LOWER_GREEK、ListStyleType.LOWER_LATIN、ListStyleType.UPPER_ALPHA、ListStyleType.UPPER_GREEK、ListStyleType.UPPER_LATIN、FormatValue.INHERIT。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。如果沒有祖系設定此屬性,則值將為 ListStyleType.DISC。



實作
    public function get listStyleType():*
    public function set listStyleType(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

相關 API 元素

locale

屬性 
locale:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:文字的地區設定。控制大小寫轉換和形狀。使用 Unicode Technical Standard #35 中描述的標準地區識別名稱。例如 en、en_US 以及 en-US 都是英文,ja 則是日文。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。如果沒有祖系設定此屬性,則值將為 en。



實作
    public function get locale():*
    public function set locale(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

paddingBottom

屬性 
paddingBottom:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:下方內移距 (像素)。除了開端邊框距離為 45 的清單以外,auto 的預設值均為零 (如果重疊顯示時未定義,則採用預設值)。容器下方邊緣與文字之間的間距。值為 Number 或 auto。

使用水平文字時,在具有多欄的可捲動容器中,第一欄及接續各欄會在容器結尾以空格顯示邊框距離,但在最後一欄,如果文字無法完全填入,則必須捲動才能看到邊框距離。

有效字串值為 FormatValue.AUTO、FormatValue.INHERIT 以及從 -8000 到 8000 的數字。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義,則此屬性的值就會是 FormatValue.AUTO。



實作
    public function get paddingBottom():*
    public function set paddingBottom(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

相關 API 元素

paddingLeft

屬性 
paddingLeft:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:左方內移距 (像素)。除了開端邊框距離為 45 的清單以外,auto 的預設值均為零 (如果重疊顯示時未定義,則採用預設值)。容器左方邊緣與文字之間的間距。值為 Number 或 auto。

使用垂直文字時,在具有多欄的可捲動容器中,第一欄及接續各欄會在容器結尾以空格顯示邊框距離,但在最後一欄,如果文字無法完全填入,則必須捲動才能看到邊框距離。

有效字串值為 FormatValue.AUTO、FormatValue.INHERIT 以及從 -8000 到 8000 的數字。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義,則此屬性的值就會是 FormatValue.AUTO。



實作
    public function get paddingLeft():*
    public function set paddingLeft(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

相關 API 元素

paddingRight

屬性 
paddingRight:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:右方內移距 (像素)。除了開端邊框距離為 45 的清單以外,auto 的預設值均為零 (如果重疊顯示時未定義,則採用預設值)。容器右方邊緣與文字之間的間距。值為 Number 或 auto。

有效字串值為 FormatValue.AUTO、FormatValue.INHERIT 以及從 -8000 到 8000 的數字。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義,則此屬性的值就會是 FormatValue.AUTO。



實作
    public function get paddingRight():*
    public function set paddingRight(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

相關 API 元素

paddingTop

屬性 
paddingTop:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:上方內移距 (像素)。除了開端邊框距離為 45 的清單以外,auto 的預設值均為零 (如果重疊顯示時未定義,則採用預設值)。容器上方邊緣與文字之間的間距。值為 Number 或 auto。

有效字串值為 FormatValue.AUTO、FormatValue.INHERIT 以及從 -8000 到 8000 的數字。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義,則此屬性的值就會是 FormatValue.AUTO。



實作
    public function get paddingTop():*
    public function set paddingTop(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

相關 API 元素

paragraphEndIndent

屬性 
paragraphEndIndent:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:指定段落結尾邊緣縮排量的數字 (以像素為單位)。參考由左至右文字的右邊,與由右至左文字的左邊。

有效值是從 0 到 8000 的數字以及 FormatValue.INHERIT。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。如果沒有祖系設定此屬性,則值將為 0。



實作
    public function get paragraphEndIndent():*
    public function set paragraphEndIndent(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

paragraphSpaceAfter

屬性 
paragraphSpaceAfter:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:一個數字,指定段落後面要保留的空間量 (像素)。使用 paragraphSpaceBefore 在前後收合。

有效值是從 0 到 8000 的數字以及 FormatValue.INHERIT。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。如果沒有祖系設定此屬性,則值將為 0。



實作
    public function get paragraphSpaceAfter():*
    public function set paragraphSpaceAfter(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

paragraphSpaceBefore

屬性 
paragraphSpaceBefore:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:一個數字,指定段落前面要保留的空間量 (像素)。使用 paragraphSpaceAfter 在前後收合。

有效值是從 0 到 8000 的數字以及 FormatValue.INHERIT。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。如果沒有祖系設定此屬性,則值將為 0。



實作
    public function get paragraphSpaceBefore():*
    public function set paragraphSpaceBefore(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

paragraphStartIndent

屬性 
paragraphStartIndent:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:指定段落開頭邊緣縮排量的數字 (以像素為單位)。參考由左至右文字的左邊,與由右至左文字的右邊。

有效值是從 0 到 8000 的數字以及 FormatValue.INHERIT。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。如果沒有祖系設定此屬性,則值將為 0。



實作
    public function get paragraphStartIndent():*
    public function set paragraphStartIndent(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

renderingMode

屬性 
renderingMode:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:用於此文字的顯示模式。只套用到內嵌字體 (fontLookup 屬性設定為 FontLookup.EMBEDDED_CFF)。

有效值是 RenderingMode.NORMAL、RenderingMode.CFF、FormatValue.INHERIT。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。如果沒有祖系設定此屬性,則值將為 RenderingMode.CFF。



實作
    public function get renderingMode():*
    public function set renderingMode(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

相關 API 元素

rootElement

屬性 
rootElement:ContainerFormattedElement  [唯讀]

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

傳回在容器中顯示的根元素。例如,根元素可以是 DivElement 或 TextFlow 實體。



實作
    public function get rootElement():ContainerFormattedElement

相關 API 元素

styleName

屬性 
styleName:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:指定元素的識別類別,如此只要參照此 styleName 就可以設定元素的樣式。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義,則此屬性的值就會是 null。



實作
    public function get styleName():*
    public function set styleName(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

styles

屬性 
styles:Object  [唯讀]

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

傳回此 ContainerController 的樣式。注意:getter 會複製樣式字典。傳回的物件包括已設定於包含核心與使用者樣式之格式屬性的所有樣式。傳回的物件包含一個 stylename-value 組的陣列。



實作
    public function get styles():Object

相關 API 元素

tabStops

屬性 
tabStops:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:指定段落關聯的定位停駐點。Setter 可以使用 TabStopFormat 的陣列、壓縮字串表示法、未定義或 FormatValue.INHERIT。壓縮字串表示法一律轉換為 TabStopFormat 的陣列。

字串基礎格式是一份定位停駐點清單,其中使用一或多個空格分隔每個定位停駐點。

定位停駐點會採用下列格式:<alignment type><alignment position>|<alignment token>。

對齊類型是單一字元,可以是 S、E、C 或 D (或對等的小寫字母)。S 或 s 表示開頭 (start),E 或 e 表示結尾 (end),C 或 c 表示中間 (center),D 或 d 表示小數 (decimal)。對齊類型是選擇性項目,如果未指定,則預設為 S。

對齊位置是一個數字,並根據數字 (小數或科學標記法) 的 FXG 規格指定。需要有對齊位置。

垂直分隔列用於分隔對齊位置與對齊字符,並應只在對齊字符存在時才出現。

如果對齊類型是 D,則對齊字符為選擇性,而且如果對齊類型不是 D,就不應出現。對齊字符可以是由任何結束定位停駐點的空格所終止的字元順序 (對於最後一個定位停駐點而言,終止間距是選擇性的;對齊字符的結尾是隱含的)。如果使用反斜線 (\) 跳開,則空格可做為對齊字符的一部分。如果使用另一個反斜線 (\\) 跳開,則反斜線可做為對齊字符的一部分。如果對齊方式類型為 D,且未指定對齊字符,則會採用 null 預設值。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。如果沒有祖系設定此屬性,則值將為 null。



實作
    public function get tabStops():*
    public function set tabStops(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

相關 API 元素

textAlign

屬性 
textAlign:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:段落中各行相對於容器的對齊方式。TextAlign.LEFT 沿著容器左方邊緣對齊字行。TextAlign.RIGHT 對齊右方邊緣。TextAlign.CENTER 讓字行的左方及右方邊緣等距。TextAlign.JUSTIFY 會延展行以填滿空間。TextAlign.START 等同於設定由左向右文字的靠左對齊,或由右向左文字的靠右對齊。TextAlign.END 等同於設定由左向右文字的靠右對齊,或由右向左文字的靠左對齊。

有效值為 TextAlign.LEFT、TextAlign.RIGHT、TextAlign.CENTER、TextAlign.JUSTIFY、TextAlign.START、TextAlign.END、FormatValue.INHERIT。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。如果沒有祖系設定此屬性,則值將為 TextAlign.START。



實作
    public function get textAlign():*
    public function set textAlign(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

相關 API 元素

textAlignLast

屬性 
textAlignLast:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:段落中最後 (或唯一的) 一行相對於齊行文字中之容器的對齊方式。如果 textAlign 設定為 TextAlign.JUSTIFYtextAlignLast 會指定最後一行 (或唯一的一行,如果這是一個單行區塊時) 的對齊方式。值類似於 textAlign

有效值為 TextAlign.LEFT、TextAlign.RIGHT、TextAlign.CENTER、TextAlign.JUSTIFY、TextAlign.START、TextAlign.END、FormatValue.INHERIT。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。如果沒有祖系設定此屬性,則值將為 TextAlign.START。



實作
    public function get textAlignLast():*
    public function set textAlignLast(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

相關 API 元素

textAlpha

屬性 
textAlpha:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:文字的 Alpha (透明) 值。值為 0 時表示完全透明,值為 1 時表示完全不透明。textAlpha 設為 0 的顯示物件都是作用中狀態,即便看不見亦是如此。

有效值是從 0 到 1 的數字以及 FormatValue.INHERIT。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。如果沒有祖系設定此屬性,則值將為 1。



實作
    public function get textAlpha():*
    public function set textAlpha(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

textDecoration

屬性 
textDecoration:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:文字上的裝飾。用於套用底線;預設為 none。

有效值為 TextDecoration.NONE、TextDecoration.UNDERLINE、FormatValue.INHERIT。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。如果沒有祖系設定此屬性,則值將為 TextDecoration.NONE。



實作
    public function get textDecoration():*
    public function set textDecoration(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

相關 API 元素

textFlow

屬性 
textFlow:flashx.textLayout.elements:TextFlow  [唯讀]

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

傳回其內容顯示於容器中的 TextFlow 物件。可能是 textFlowrootElement 值相同,或此為根元素的 TextFlow 物件。例如,如果容器的根元素為 DivElement,值會是 DivElement 元素所屬的 TextFlow 物件。



實作
    public function get textFlow():flashx.textLayout.elements:TextFlow

相關 API 元素

textIndent

屬性 
textIndent:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:以像素為單位,指定段落中第一行縮排量的數字。負值縮排會將行推向邊界,因而可能超出容器。

有效值是從 -8000 到 8000 的數字以及 FormatValue.INHERIT。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。如果沒有祖系設定此屬性,則值將為 0。



實作
    public function get textIndent():*
    public function set textIndent(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

textJustify

屬性 
textJustify:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:指定對齊文字的選項。預設值為 TextJustify.INTER_WORD,表示將額外空間增加到空白字元。TextJustify.DISTRIBUTE 將額外空間增加到空白字元以及個別字母之間。僅與 JustificationRule.SPACEjustificationRule 值一併使用。

有效值為 TextJustify.INTER_WORD、TextJustify.DISTRIBUTE、FormatValue.INHERIT。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。如果沒有祖系設定此屬性,則值將為 TextJustify.INTER_WORD。



實作
    public function get textJustify():*
    public function set textJustify(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

相關 API 元素

textLength

屬性 
textLength:int  [唯讀]

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

傳回容器中的字元總數。如果容器是可捲動的,這樣可以包括目前未顯示的文字。撰寫文字時會更新此值 (呼叫 IFlowComposer 的 compose()updateAllControllers() 方法時)。



實作
    public function get textLength():int

相關 API 元素

textRotation

屬性 
textRotation:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:決定此文字要旋轉的度數。

有效值為 TextRotation.ROTATE_0、TextRotation.ROTATE_180、TextRotation.ROTATE_270、TextRotation.ROTATE_90、TextRotation.AUTO、FormatValue.INHERIT。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。如果沒有祖系設定此屬性,則值將為 TextRotation.AUTO。



實作
    public function get textRotation():*
    public function set textRotation(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

相關 API 元素

trackingLeft

屬性 
trackingLeft:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:以像素為單位代表要套用至每個字元左側字距調整 (手動字距微調) 量的數字 (或 fontSize 的百分比,例如,120%)。如果已啟用特殊字距,trackingLeft 值就會加入到該字體之特殊字距表中的值。如果已停用特殊字距,trackingLeft 值會當做手動特殊字距值來使用。同時支援正值與負值。

有效值是從 -1000 到 1000 之間的數字。

有效值是從 -1000% 到 1000% 之間數字的百分比。

有效值包括 FormatValue.INHERIT。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。如果沒有祖系設定此屬性,則值將為 0。



實作
    public function get trackingLeft():*
    public function set trackingLeft(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

trackingRight

屬性 
trackingRight:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:以像素為單位代表要套用至每個字元右側字距調整 (手動字距微調) 量的數字 (或 fontSize 的百分比,例如,120%)。如果已啟用特殊字距,trackingRight 值就會加入到該字體之特殊字距表中的值。如果已停用特殊字距,trackingRight 值會當做手動特殊字距值來使用。同時支援正值與負值。

有效值是從 -1000 到 1000 之間的數字。

有效值是從 -1000% 到 1000% 之間數字的百分比。

有效值包括 FormatValue.INHERIT。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。如果沒有祖系設定此屬性,則值將為 0。



實作
    public function get trackingRight():*
    public function set trackingRight(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

typographicCase

屬性 
typographicCase:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:用於此文字的印刷大小寫類型。下面是一些範例:

typographicCase

有效值是 TLFTypographicCase.DEFAULT、TLFTypographicCase.CAPS_TO_SMALL_CAPS、TLFTypographicCase.UPPERCASE、TLFTypographicCase.LOWERCASE、TLFTypographicCase.LOWERCASE_TO_SMALL_CAPS、FormatValue.INHERIT。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。如果沒有祖系設定此屬性,則值將為 TLFTypographicCase.DEFAULT。



實作
    public function get typographicCase():*
    public function set typographicCase(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

相關 API 元素

userStyles

屬性 
userStyles:Object

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

可讓您讀寫 ContainerController 物件上的使用者樣式。注意:讀取此屬性會複製設定於此元素格式中的 userStyles。



實作
    public function get userStyles():Object
    public function set userStyles(value:Object):void

verticalAlign

屬性 
verticalAlign:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:垂直對齊或齊行 (如果重疊顯示時未定義,則採用預設值)。決定容器內 TextFlow 元素的對齊方式。

有效值是 VerticalAlign.TOP、VerticalAlign.MIDDLE、VerticalAlign.BOTTOM、VerticalAlign.JUSTIFY、FormatValue.INHERIT。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義,則此屬性的值就會是 VerticalAlign.TOP。



實作
    public function get verticalAlign():*
    public function set verticalAlign(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

相關 API 元素

verticalScrollPolicy

屬性 
verticalScrollPolicy:String

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

指定垂直捲動原則,可指定下列 ScrollPolicy 類別常數之一:ON、OFF 或 AUTO。



實作
    public function get verticalScrollPolicy():String
    public function set verticalScrollPolicy(value:String):void

相關 API 元素

verticalScrollPosition

屬性 
verticalScrollPosition:Number

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

指定舞台上目前的垂直捲動位置。此值會指定從上方算起的像素數目。



實作
    public function get verticalScrollPosition():Number
    public function set verticalScrollPosition(value:Number):void

whiteSpaceCollapse

屬性 
whiteSpaceCollapse:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:將文字匯入 TextFlow 時捨去或保留空格。WhiteSpaceCollapse.PRESERVE 保留所有空白字元。WhiteSpaceCollapse.COLLAPSE 移除匯入文字區塊內的換行、定位點以及開頭和結尾空白。斷行標籤 () 和 Unicode 字行分隔符號字元都將保留。

有效值為 WhiteSpaceCollapse.PRESERVE、WhiteSpaceCollapse.COLLAPSE、FormatValue.INHERIT。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。如果沒有祖系設定此屬性,則值將為 WhiteSpaceCollapse.COLLAPSE。



實作
    public function get whiteSpaceCollapse():*
    public function set whiteSpaceCollapse(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內

相關 API 元素

wordSpacing

屬性 
wordSpacing:*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

TextLayoutFormat:指定對齊時要使用之文字間的最佳、最小及最大間距 (標準間距寬度的倍數)。最佳間距可用來指定所需的間距大小,以作為字體中定義之值的分數。textJustify 為均分時會使用最小和最大值,以決定文字之間的間距寬窄,然後才使用字元間距來對齊行。

有效值是從 -1000% 到 1000% 之間數字的百分比。

有效值包括 FormatValue.INHERIT。

若未定義預設值,則表示未設定。

如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。如果沒有祖系設定此屬性,則值將為 100%、50%、150%。



實作
    public function get wordSpacing():*
    public function set wordSpacing(value:any):void

擲回值
RangeError — 設定時值不在此屬性的範圍內
建構函式詳細資料

ContainerController

()建構函式
public function ContainerController(container:Sprite, compositionWidth:Number = 100, compositionHeight:Number = 100)

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

建構函式 - 建立一個 ContainerController 實體。ContainerController 有一個預設的 compositionWidthcompositionHeight,如果您未指定其寬度和高度,部分文字就會顯示在容器中。

參數
container:Sprite — 要管理其中之文字行的 DisplayObjectContainer。
 
compositionWidth:Number (default = 100) — 撰寫容器中的文字時使用的初始寬度。
 
compositionHeight:Number (default = 100) — 撰寫容器中的文字時使用的初始高度。
方法詳細資訊

activateHandler

()方法
public function activateHandler(event:Event):void

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

當用戶端管理事件時,處理 Event.ACTIVATE 事件。

參數

event:Event — Event 物件。

相關 API 元素


範例  ( 如何使用本範例 )

這個範例會擴充 ContainerController,以便將它的 activateHandler() 方法置換成自訂 activateHandler() 方法。這個範例需要一個可以觸發 activateHandler() 方法的應用程式。
package flashx.textLayout.container.examples
{
    import flash.display.Sprite;
     import flash.events.Event;
     import flashx.textLayout.container.ContainerController;
     
    public class ContainerController_activateHandlerExample extends ContainerController
    {
        public function ContainerController_activateHandlerExample(container:Sprite, compositionWidth:Number=100, compositionHeight:Number=100)
        {
            super(container, compositionWidth, compositionHeight);
        }
        override public function activateHandler(event:Event):void
        {    
            // run the TLF handler for the activate event
            super.activateHandler(event);
            // and add your own code for the event 
            trace("You are in activateHandler()");        
        }
    }
}

addBackgroundShape

()方法 
protected function addBackgroundShape(shape:Shape):void

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

新增 flash.display.Shape 物件,可在其上繪製背景形狀 (例如,背景色彩)。此方法的預設實作 (可能被覆寫) 會新增物件至 container,位於第一個 flash.text.engine.TextLine 子系之前 (若有此子系),否則會位於最後一個現有子系之後。

參數

shape:Shape — 要新增的 flash.display.Shape 物件

相關 API 元素

addInlineGraphicElement

()方法 
protected function addInlineGraphicElement(parent:DisplayObjectContainer, inlineGraphicElement:DisplayObject, index:int):void

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 2.0

新增 flash.display.DisplayObject 物件為 parent 的後代。此方法的預設實作 (可能被覆寫) 會在指定的索引將物件新增為 parent 的直接子系。這會呼叫以將 InlineGraphicElements 新增至 TextLine 或容器中。

參數

parent:DisplayObjectContainer — 要新增 inlineGraphicElement 的 flash.display.DisplayObjectContainer 物件
 
inlineGraphicElement:DisplayObject — 要新增的 flash.display.DisplayObject 物件
 
index:int — 在浮動物件的父輩中插入其索引

相關 API 元素

addSelectionContainer

()方法 
protected function addSelectionContainer(selectionContainer:DisplayObjectContainer):void

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

新增 flash.display.DisplayObjectContainer 物件至選取範圍形狀 (例如,區塊選取反白標示、游標等等)。此方法的預設實作 (可能被覆寫) 具有下列行為:新增物件至 container 的第一個 flash.text.engine.TextLine 子系之前 (若有此子系),且物件為不透明並具有正常的混合模式。在所有其他狀況下,將新增為 container 的最後一個子系。

參數

selectionContainer:DisplayObjectContainer — 要新增的 flash.display.DisplayObjectContainer

相關 API 元素

addTextLine

()方法 
protected function addTextLine(textLine:flash.text.engine:TextLine, index:int):void

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

新增 flash.text.engine.TextLine 物件為 container 的後代。此方法的預設實作 (可能被覆寫) 會在指定的索引將物件新增為 container 的直接子系。

參數

textLine:flash.text.engine:TextLine — 要新增的 flash.text.engine.TextLine 物件
 
index:int — 在文字行的父輩中插入其索引

相關 API 元素

autoScrollIfNecessary

()方法 
public function autoScrollIfNecessary(mouseX:int, mouseY:int):void

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

在選擇「拖曳」時處理捲動事件。

參數

mouseX:int — 滑鼠游標在舞台上的水平位置。
 
mouseY:int — 滑鼠游標在舞台上的垂直位置。

beginMouseCapture

()方法 
public function beginMouseCapture():void

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

呼叫時要求用戶端從安全執行程序之外開始轉送 mouseup 與 mousemove 事件。

clearStyle

()方法 
public function clearStyle(styleProp:String):void

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

從此 FlowElement 清除 styleProp 指定的樣式。將值設定成 undefined

參數

styleProp:String

createContextMenu

()方法 
protected function createContextMenu():ContextMenu

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

為 ContainerController 建立內容選單。使用 ContextMenu 類別的方法,將項目新增至選單。

您可以覆寫此方法來定義自訂的內容選單。

傳回值
ContextMenu

相關 API 元素

deactivateHandler

()方法 
public function deactivateHandler(event:Event):void

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

當用戶端管理事件時,處理 Event.DEACTIVATE 事件。

參數

event:Event — Event 物件。

相關 API 元素

editHandler

()方法 
public function editHandler(event:Event):void

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

當用戶端管理事件時,處理編輯事件 (CUT、COPY、PASTE、SELECT_ALL)。

參數

event:Event — Event 物件。

相關 API 元素


範例  ( 如何使用本範例 )

這個範例會擴充 ContainerController,以便將它的 editHandler() 方法置換成自訂 editHandler() 方法。這個範例需要一個可以觸發 editHandler() 方法的應用程式。
package flashx.textLayout.container.examples 
{
    import flash.events.Event;
    import flash.display.Sprite;
    import flashx.textLayout.container.ContainerController;
    
    public class ContainerController_editHandlerExample extends ContainerController
    {
        public function ContainerController_editHandlerExample(container:Sprite, compositionWidth:Number=100, compositionHeight:Number=100)
        {
            super(container, compositionWidth, compositionHeight);
        }
        override public function editHandler(event:Event):void
        {    
            // run the TLF handler for the focus event
            super.editHandler(event);
            // and add your own code for the event 
            trace("You are in editHandler()");        
        }
    }
}

endMouseCapture

()方法 
public function endMouseCapture():void

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

呼叫時通知用戶端不再需要從安全執行程序之外轉送 mouseup 與 mousemove 事件。

focusChangeHandler

()方法 
public function focusChangeHandler(event:FocusEvent):void

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

當用戶端管理事件時,處理 FocusEvent.KEY_FOCUS_CHANGEFocusEvent.MOUSE_FOCUS_CHANGE 事件。

參數

event:FocusEvent — FocusEvent 物件

相關 API 元素

focusInHandler

()方法 
public function focusInHandler(event:FocusEvent):void

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

當用戶端管理事件時,處理 FocusEvent.FOCUS_IN 事件。

參數

event:FocusEvent — FocusEvent 物件

相關 API 元素


範例  ( 如何使用本範例 )

這個範例會擴充 ContainerController,以便將它的 focusInHandler() 方法置換成自訂 focusInHandler() 方法。這個範例需要一個可以觸發 focusInHandler() 方法的應用程式。
package flashx.textLayout.container.examples 
{
    import flash.events.FocusEvent;
    import flash.display.Sprite;
    import flashx.textLayout.container.ContainerController;
    
    public class ContainerController_focusInHandlerExample extends ContainerController
    {
        public function ContainerController_focusInHandlerExample(container:Sprite, compositionWidth:Number=100, compositionHeight:Number=100)
        {
            super(container, compositionWidth, compositionHeight);
        }
        override public function focusInHandler(event:FocusEvent):void
        {    
            // run the TLF handler for the focus event
            super.focusInHandler(event);
            // and add your own code for the event 
            trace("You are in focusInHandler()");        
        }
    }
}

focusOutHandler

()方法 
public function focusOutHandler(event:FocusEvent):void

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

當用戶端管理事件時,處理 FocusEvent.FOCUS_OUT 事件。

參數

event:FocusEvent — FocusEvent 物件

相關 API 元素

getContentBounds

()方法 
public function getContentBounds():Rectangle

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

傳回文字佔用的區域,如同最後的撰寫或更新作業所鏡射。如果容器可以捲動,且文字超過可見區域,就可以估計寬度和高度。

傳回值
Rectangle — 描述文字佔用的區域。

相關 API 元素


範例  ( 如何使用本範例 )

這個範例使用 getContentBounds(),在文字周圍繪製一個邊框。
package flashx.textLayout.container.examples
{
    import flash.geom.Rectangle;
    import flash.display.Sprite;
    import flashx.textLayout.elements.TextFlow;
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.conversion.TextConverter;

    public class ContainerController_getContentBoundsExample extends Sprite
    {    
        private const textMarkup:String = "<flow:TextFlow xmlns:flow='http://ns.adobe.com/textLayout/2008' fontSize='08' " + 
            "textIndent='10' paragraphSpaceBefore='6' paddingTop='8' paddingLeft='8' paddingRight='8'>" +
            "<flow:p paragraphSpaceBefore='inherit'>" +
            "<flow:span>There are many </flow:span>" + 
            "<flow:span fontStyle='italic'>such</flow:span>" + 
            "<flow:span> lime-kilns in that tract of country, for the purpose of burning the white" + 
            " marble which composes a large part of the substance of the hills. Some of them, built " + 
            "years ago, and long deserted, with weeds growing in the vacant round of the interior, " + 
            "which is open to the sky, and grass and wild-flowers rooting themselves into the chinks" + 
            "of the stones, look already like relics of antiquity, and may yet be overspread with the" + 
            " lichens of centuries to come.</flow:span>" +
            "</flow:p>" +
            "</flow:TextFlow>";
        
        public function ContainerController_getContentBoundsExample(textFlow:TextFlow):void
        {        
            // Body text TextFlow and flow composer
            var textFlow:TextFlow = new TextFlow();
            textFlow = TextConverter.importToFlow(textMarkup, TextConverter.TEXT_LAYOUT_FORMAT);
            var container:Sprite = new Sprite();
            var controller:ContainerController = new ContainerController(container, 120, 200);
            container.x = 150;
            container.y = 50;
            // Add controller to text flow; add container to stage and display text
            textFlow.flowComposer.addController(controller);
            addChild(container);
            textFlow.flowComposer.updateAllControllers();
            // draw a border around the text
            drawBorder(controller);
        }
        
        private function drawBorder(controller:ContainerController):void
        {
            // get the rectangle that makes up the bounds of the content
            var bounds:Rectangle = controller.getContentBounds();
            // retrieve the container and draw the border 
            var container:Sprite = controller.container as Sprite;
            container.graphics.lineStyle(.5);
            container.graphics.moveTo(bounds.left,bounds.top);
            container.graphics.lineTo(bounds.right,bounds.top);
            container.graphics.lineTo(bounds.right,bounds.bottom);
            container.graphics.lineTo(bounds.left,bounds.bottom);
            container.graphics.lineTo(bounds.left,bounds.top);
            container.graphics.drawRect(bounds.left, bounds.top, bounds.width, bounds.height );
        }
    }
}

        

getFirstTextLineChildIndex

()方法 
protected function getFirstTextLineChildIndex():int

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

取得第一行文字必須在其父輩顯示的索引。此方法的預設實作 (可能被覆寫) 傳回 container 的第一個 flash.text.engine.TextLine 子系的子索引 (若有此子系),否則傳回 container 的最後一個子系的索引。

傳回值
int — 第一行文字必須在其父輩顯示的索引。

相關 API 元素

getScrollDelta

()方法 
public function getScrollDelta(numLines:int):Number

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

了解往上或往下捲動指定的行數時所需的捲動距離。負數會往上捲動,顯示 TextFlow 上方更多的內容。正數會向下捲動,從下一行的底部開始完整顯示。

例如,往上捲動時,此方法會完全顯示下一行。如果下一行部分被遮住而指定的行數為 1,則部分遮住的那一行就會完整顯示。

參數

numLines:int — 要捲動的行數。

傳回值
Number — 要捲動的空間差異量

getStyle

()方法 
public function getStyle(styleProp:String):*

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

傳回 styleProp 參數指定的樣式值。

參數

styleProp:String — 您要取得其值的樣式屬性名稱。

傳回值
* — 指定樣式目前的值。

imeStartCompositionHandler

()方法 
public function imeStartCompositionHandler(event:IMEEvent):void

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

當用戶端管理事件時,處理 IMEEvent.IME_START_COMPOSITION 事件。

參數

event:IMEEvent — IMEEvent 物件。

相關 API 元素

flash.events.IMEEvent.IME_START_COMPOSITION

invalidateContents

()方法 
public function invalidateContents():void

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

將此容器中的所有文字標示為需要撰寫。


範例  ( 如何使用本範例 )

這個範例會檢查 invalidateContents() 是否造成文字方向被破壞。
package flashx.textLayout.container.examples 
{
    import flash.display.Sprite;
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.elements.TextFlow;
    import flashx.textLayout.conversion.TextConverter;
    
    public class ContainerController_invalidateContentsExample extends Sprite
    {
        public function ContainerController_invalidateContentsExample()
        {
            // create container, text flow, composer, paragraph, and span
            var container:Sprite = new Sprite();
            var textFlow:TextFlow = new TextFlow();
            var paragraph:ParagraphElement = new ParagraphElement();
            var span:SpanElement = new SpanElement;
            // add container to the stage; create controller and add it to the text flow
            addChild(container);
            container.x = 100;
            container.y = 50;
            var controller:ContainerController = new ContainerController(container, 200, 200);
            textFlow.flowComposer.addController(controller);
            // set font size and add text to the span; add the span to the paragraph
            textFlow.fontSize = 16;
            span.text = "Does invalidateContents() cause this text to be damaged?";
            paragraph.addChild(span);
            textFlow.addChild(paragraph);  
            //update controller to display text
            textFlow.flowComposer.updateAllControllers(); 
            // invalidate the controller contents and check to see if they are damaged
            controller.invalidateContents();
            if(controller.isDamaged())
                span.text += "\nYes, it does.";
            else
                span.text += "\nNo, it doesn't";
            textFlow.flowComposer.updateAllControllers();   
        }
    }
}

isDamaged

()方法 
public function isDamaged():Boolean

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

判斷容器是否有需要撰寫的文字。

傳回值
Boolean — 如果容器需要撰寫則為 true。

範例  ( 如何使用本範例 )

這個範例會檢查當範圍中的文字被取代之後,是否會破壞文字方向。
 

package flashx.textLayout.container.examples 
{
    import flash.display.Sprite;
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.elements.TextFlow;
    import flashx.textLayout.conversion.TextConverter;
    
    public class ContainerController_isDamagedExample extends Sprite
    {
        public function ContainerController_isDamagedExample()
        {
            // create container, composer, text flow, paragraph, and span
            var container:Sprite = new Sprite();
            var textFlow:TextFlow = new TextFlow();
            var paragraph:ParagraphElement = new ParagraphElement();
            var span:SpanElement = new SpanElement;
            // add container to the stage; create controller and add it to the text flow
            addChild(container);
            var controller:ContainerController = new ContainerController(container, 200, 700 );
            textFlow.flowComposer.addController(controller);
            //set font size, add text to the span and the paragraph to the text flow
                        textFlow.fontSize = 24;
            span.text = "Does this text flow need to be composed?";
            paragraph.addChild(span);
            textFlow.addChild(paragraph); 
            // display the text               
            textFlow.flowComposer.updateAllControllers();
            // replace 'this' with 'your' and check to see if text flow is damaged
            span.replaceText(5, 9, "your");
            if(controller.isDamaged())
            {
                span.text += " Yes it does.";
            }
            textFlow.flowComposer.updateAllControllers();   
        }
    }
}

keyDownHandler

()方法 
public function keyDownHandler(event:KeyboardEvent):void

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

當用戶端管理事件時,處理 KeyboardEvent.KEY_DOWN 事件。

參數

event:KeyboardEvent — KeyboardEvent 物件。

相關 API 元素

keyFocusChangeHandler

()方法 
public function keyFocusChangeHandler(event:FocusEvent):void

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

當用戶端管理事件時,處理 FocusEvent.KEY_FOCUS_CHANGE 事件。

參數

event:FocusEvent — FocusEvent 物件

相關 API 元素

keyUpHandler

()方法 
public function keyUpHandler(event:KeyboardEvent):void

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

當用戶端管理事件時,處理 Keyboard.KEY_UP 事件。

參數

event:KeyboardEvent — KeyboardEvent 物件。

相關 API 元素


範例  ( 如何使用本範例 )

這個範例會擴充 ContainerController,以便將它的 keyUpHandler() 方法置換成自訂 keyUpHandler() 方法。這個範例需要一個可以觸發 keyUpHandler() 方法的應用程式。
package flashx.textLayout.container.examples  
{
    import flash.events.KeyboardEvent;
    import flash.display.Sprite;
    import flashx.textLayout.container.ContainerController;
    
    public class ContainerController_keyUpHandlerExample extends ContainerController
    {
        public function ContainerController_keyUpHandlerExample(container:Sprite, compositionWidth:Number=100, compositionHeight:Number=100)
        {
            super(container, compositionWidth, compositionHeight);
        }
        override public function keyUpHandler(event:KeyboardEvent):void
        {    
            // run the TLF handler for the KEY_UP event
            super.keyUpHandler(event);
            // and add your own code for the event 
            trace("You are in keyUpHandler()");        
        }
    }
}

menuSelectHandler

()方法 
public function menuSelectHandler(event:ContextMenuEvent):void

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

當用戶端管理事件時,處理 ContextMenuEvent.MENU_SELECT 事件。

參數

event:ContextMenuEvent — ContextMenuEvent 物件。

相關 API 元素


範例  ( 如何使用本範例 )

這個範例會擴充 ContainerController,以便將它的 menuSelectHandler() 方法置換成自訂 menuSelectHandler() 方法。這個範例需要一個可以觸發 menuSelectHandler() 方法的應用程式。
package flashx.textLayout.container.examples 
{
    import flash.events.ContextMenuEvent;
    import flash.display.Sprite;
    import flashx.textLayout.container.ContainerController;
     
    public class ContainerController_menuSelectHandlerExample extends ContainerController
    {
        public function ContainerController_menuSelectHandlerExample(container:Sprite, compositionWidth:Number=100, compositionHeight:Number=100)
         {
             super(container, compositionWidth, compositionHeight);
         }
        override public function menuSelectHandler(event:ContextMenuEvent):void
        {    
            // run the TLF handler for the MENU_SELECT event
            super.menuSelectHandler(event);
            // and add your own code for the event 
            trace("You are in menuSelectHandler()");        
        }
    }
}

mouseDoubleClickHandler

()方法 
public function mouseDoubleClickHandler(event:MouseEvent):void

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

當用戶端管理事件時,處理 MouseEvent.DOUBLE_CLICK 事件。

參數

event:MouseEvent — MouseEvent 物件。

相關 API 元素


範例  ( 如何使用本範例 )

這個範例會擴充 ContainerController,以便將它的 mouseDoubleClickHandler() 方法置換成自訂 mouseDoubleClickHandler() 方法。這個範例需要一個可以觸發 mouseDoubleClickHandler() 方法的應用程式。
package flashx.textLayout.container.examples  
{
    import flash.events.MouseEvent;
    import flash.display.Sprite;
    import flashx.textLayout.container.ContainerController;
    
    public class ContainerController_mouseDoubleClickHandlerExample extends ContainerController
    {
        public function ContainerController_mouseDoubleClickHandlerExample(container:Sprite, compositionWidth:Number=100, compositionHeight:Number=100)
        {
            super(container, compositionWidth, compositionHeight);
        }
        override public function mouseDoubleClickHandler(event:MouseEvent):void
        {    
            // run the TLF handler for the MOUSE_OVER event
            super.mouseDoubleClickHandler(event);
            // and add your own code for the event 
            trace("You are in mouseDoubleClickHandler()");        
        }
    }
}

mouseDownHandler

()方法 
public function mouseDownHandler(event:MouseEvent):void

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

當用戶端管理事件時,處理 MouseEvent.MOUSE_DOWN 事件。

參數

event:MouseEvent — MouseEvent 物件。

相關 API 元素

mouseMoveHandler

()方法 
public function mouseMoveHandler(event:MouseEvent):void

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

當用戶端管理事件時,處理 MouseEvent.MOUSE_MOVE 事件。

參數

event:MouseEvent — MouseEvent 物件。

相關 API 元素

mouseMoveSomewhere

()方法 
public function mouseMoveSomewhere(event:Event):void

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

從安全執行程序之外轉送 mouseMove 事件的用戶端呼叫。不需要滑鼠移動的座標。

參數

event:Event

mouseOutHandler

()方法 
public function mouseOutHandler(event:MouseEvent):void

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

當用戶端管理事件時,處理 MouseEvent.MOUSE_OUT 事件。

參數

event:MouseEvent — MouseEvent 物件。

相關 API 元素

mouseOverHandler

()方法 
public function mouseOverHandler(event:MouseEvent):void

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

當用戶端管理事件時,處理 MouseEvent.MOUSE_OVER 事件。

參數

event:MouseEvent — MouseEvent 物件。

相關 API 元素


範例  ( 如何使用本範例 )

這個範例會擴充 ContainerController,以便將它的 mouseOverHandler() 方法置換成自訂 mouseOverHandler() 方法。這個範例需要一個可以觸發 mouseOverHandler() 方法的應用程式。
package flashx.textLayout.container.examples  
{
    import flash.events.MouseEvent;
    import flash.display.Sprite;
    import flashx.textLayout.container.ContainerController;
    
    public class ContainerController_mouseOverHandlerExample extends ContainerController
    {
        public function ContainerController_mouseOverHandlerExample(container:Sprite, compositionWidth:Number=100, compositionHeight:Number=100)
        {
            super(container, compositionWidth, compositionHeight);
        }
        override public function mouseOverHandler(event:MouseEvent):void
        {    
            // run the TLF handler for the MOUSE_OVER event
            super.mouseOverHandler(event);
            // and add your own code for the event 
            trace("You are in mouseOverHandler()");        
        }
    }
}

mouseUpHandler

()方法 
public function mouseUpHandler(event:MouseEvent):void

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

當用戶端管理事件時,處理 MouseEvent.MOUSE_UP 事件。

參數

event:MouseEvent — MouseEvent 物件。

相關 API 元素

mouseUpSomewhere

()方法 
public function mouseUpSomewhere(event:Event):void

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

從安全執行程序之外轉送 mouseUp 事件的用戶端呼叫。不需要放開滑鼠的座標。

參數

event:Event

mouseWheelHandler

()方法 
public function mouseWheelHandler(event:MouseEvent):void

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

當用戶端管理事件時,處理 MouseEvent.MOUSE_WHEEL 事件。

參數

event:MouseEvent — MouseEvent 物件。

相關 API 元素

removeBackgroundShape

()方法 
protected function removeBackgroundShape(shape:Shape):void

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

移除可在其上繪製背景形狀 (例如,背景色彩) flash.display.Shape 物件。此方法的預設實作 (可能被覆寫) 會將物件從其 parent 中移除。

參數

shape:Shape — 要移除的 flash.display.Shape 物件

相關 API 元素

removeInlineGraphicElement

()方法 
protected function removeInlineGraphicElement(parent:DisplayObjectContainer, inlineGraphicElement:DisplayObject):void

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 2.0

flash.display.DisplayObject 物件從其父輩中移除。此方法的預設實作 (可能被覆寫) 將物件從 container 中移除 (如果物件為容器的直接子系)。即使物件並非 parent 的後代,仍然可呼叫此方法。此方法的任何實作必須確認在此狀況下不會採取動作。

參數

parent:DisplayObjectContainer — 要移除的 flash.display.DisplayObject 物件
 
inlineGraphicElement:DisplayObject

相關 API 元素

removeSelectionContainer

()方法 
protected function removeSelectionContainer(selectionContainer:DisplayObjectContainer):void

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

移除包含選取範圍形狀 (例如,區塊選取反白標示、游標等等) 的 flash.display.DisplayObjectContainer 物件。此方法的預設實作 (可能被覆寫) 將物件從其父輩中移除 (若有父輩)。

參數

selectionContainer:DisplayObjectContainer — 要移除的 flash.display.DisplayObjectContainer 物件

相關 API 元素

removeTextLine

()方法 
protected function removeTextLine(textLine:flash.text.engine:TextLine):void

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

flash.text.engine.TextLine 物件從其父輩中移除。此方法的預設實作 (可能被覆寫) 將物件從 container 中移除 (如果物件為容器的直接子系)。即使物件並非 container 的後代,仍然可呼叫此方法。此方法的任何實作必須確認在此狀況下不會採取動作。

參數

textLine:flash.text.engine:TextLine — 要移除的 flash.text.engine.TextLine 物件

相關 API 元素

scrollToRange

()方法 
public function scrollToRange(activePosition:int, anchorPosition:int):void

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

捲動以讓文字範圍顯示在容器中。

參數

activePosition:int — 當您擴充選取範圍時變更的選取範圍結尾。它可以是選取範圍的開頭或結尾,以距離文字流排開頭算起的偏移量表示。
 
anchorPosition:int — 當您擴充選取範圍時的選取範圍固定結尾。它可以是選取範圍的開頭或結尾。

selectRange

()方法 
public function selectRange(anchorIndex:int, activeIndex:int):void

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0, Flash Player 10.0

在實作 ITextSupport 的組件中設定選取文字的範圍。如果任一引數超過邊緣,則選取範圍不應變更。希望支援內嵌 IME 的組件,應該呼叫此方法。

參數

anchorIndex:int — 選取範圍的錨點結尾中,最後一個字元的字元索引值 (從零開始)
 
activeIndex:int — 選取範圍的作用中結尾中,最後一個字元的字元索引值 (從零開始)

setCompositionSize

()方法 
public function setCompositionSize(w:Number, h:Number):void

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

設定容器中允許的文字寬度和高度。寬度和高度可以像素為單位來指定,或者可針對任一個值使用 NaNNaN 表示測量該值。這可用來尋找所有內容中最寬的行和 (或) 總高度。將 NaN 指定為寬度時,即會以 TextLine.MAX_LINE_WIDTH 的最大寬度來斷行。將 NaN 指定為高度時,即會假設容器的高度無任何限制。實際的測量值已準備好可傳回 getContentBounds。當 TextFlow 的計算 blockProgression 屬性為 BlockProgression.RL 時,便會交換寬度與高度的意義。

參數

w:Number — 容器中適用的文字寬度 (像素)。NaN 表示未指定寬度。
 
h:Number — 容器中適用的文字高度 (像素)。NaN 表示未指定高度。

相關 API 元素


範例  ( 如何使用本範例 )

這個範例會使用 setCompositionSize() 設定寬度和高度。
package flashx.textLayout.container.examples 
{
    import flash.display.Sprite;
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.elements.TextFlow;
    import flashx.textLayout.conversion.TextConverter;
    
    public class ContainerController_setCompositionSizeExample extends Sprite
    {
        public function ContainerController_setCompositionSizeExample()
        {
            // create container, text flow, composer, paragraph, and span
            var container:Sprite = new Sprite();
            var textFlow:TextFlow = new TextFlow();
            var paragraph:ParagraphElement = new ParagraphElement();
            var span:SpanElement = new SpanElement;
            // add container to the stage; create controller and add it to the text flow
            addChild(container);
            container.x = 100;
            container.y = 50;
            var controller:ContainerController = new ContainerController(container);
            textFlow.flowComposer.addController(controller);
            // set font size and add text to the span; add the span to the paragraph
            textFlow.fontSize = 12;
            controller.setCompositionSize(250, 200);
            span.text = "This example uses setCompositionSize() to set compositionWidth (";
            span.text += controller.compositionWidth; 
            span.text += ") and compositionHeight ("
            span.text += controller.compositionHeight;
            span.text += "), rather than setting them with:\nnew ContainerController()";
            paragraph.addChild(span);
            // add paragraph to text flow, and display text
            textFlow.addChild(paragraph);            
            textFlow.flowComposer.updateAllControllers();       
        }
    }
}

setStyle

()方法 
public function setStyle(styleProp:String, newValue:*):void

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

styleProp 參數指定的樣式值設定為 newValue 參數指定的值。

參數

styleProp:String — 您要設定其值的樣式屬性名稱。
 
newValue:* — 您想指定至樣式的值。

softKeyboardActivatingHandler

()方法 
public function softKeyboardActivatingHandler(event:Event):void

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10.2, AIR 1.5

當用戶端管理事件時,處理 SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATING 事件。

參數

event:Event — SoftKeyboardEvent 物件。

相關 API 元素

textInputHandler

()方法 
public function textInputHandler(event:flash.events:TextEvent):void

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

當用戶端管理事件時,處理 TextEvent.TEXT_INPUT 事件。

參數

event:flash.events:TextEvent — TextEvent 物件。

相關 API 元素


範例  ( 如何使用本範例 )

這個範例會擴充 ContainerController,以便將它的 textInputHandler() 方法置換成自訂 textInputHandler() 方法。這個範例需要一個可以觸發 textInputHandler() 方法的應用程式。
package flashx.textLayout.container.examples   
{
    import flash.events.TextEvent;
    import flash.display.Sprite;
    import flashx.textLayout.container.ContainerController;
 
    public class ContainerController_textInputHandlerExample extends ContainerController
    {
        public function ContainerController_textInputHandlerExample(container:Sprite, compositionWidth:Number=100, compositionHeight:Number=100)
         {
             super(container, compositionWidth, compositionHeight);
         }
        override public function textInputHandler(event:TextEvent):void
        {    
            // run the TLF handler for the textInput event
            super.textInputHandler(event);
            // and add your own code for the event - e.g. only allow alpha characters
            trace("You are in textInputHandler()");
            
        }
    }
}

updateGraphics

()方法 
tlf_internal function updateGraphics(updateStart:int):void

參數

updateStart:int

updateVisibleRectangle

()方法 
protected function updateVisibleRectangle():void

語言版本: ActionScript 3.0
執行階段版本: Flash Player 10, AIR 1.5

如果捲動,請將捲動矩形設定為容器矩形,如此畫面中任何未能全部顯示的行就會剪裁至可捲動區域。如果未捲動,請清除捲動矩形,就不會進行剪裁。

ContainerControllerExample1.as

這個範例會在一個屬於連結性容器中的兩個圓形中顯示文字方向,表示第一個容器溢出的文字會自動排入第二個容器中。請注意,目前兩個容器和控制器,不過只有一個文字方向。
package flashx.textLayout.container.examples 
{
    import flash.display.Sprite;
    import flashx.textLayout.compose.StandardFlowComposer;
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.conversion.TextConverter;
    import flashx.textLayout.elements.TextFlow;

    public class ContainerControllerExample1 extends Sprite
    {        
        private const textMarkup:String = "<flow:TextFlow xmlns:flow='http://ns.adobe.com/textLayout/2008' fontSize='8' " + 
                "textIndent='10' paragraphSpaceBefore='6' paddingTop='8' paddingLeft='8' paddingRight='8'>" +
            "<flow:p paragraphSpaceBefore='inherit'>" +
                "<flow:span>There are many </flow:span>" + 
                "<flow:span fontStyle='italic'>such</flow:span>" + 
                "<flow:span> lime-kilns in that tract of country, for the purpose of burning the white" + 
                    " marble which composes a large part of the substance of the hills. Some of them, built " + 
                    "years ago, and long deserted, with weeds growing in the vacant round of the interior, " + 
                    "which is open to the sky, and grass and wild-flowers rooting themselves into the chinks" + 
                    "of the stones, look already like relics of antiquity, and may yet be overspread with the" + 
                    " lichens of centuries to come. Others, where the lime-burner still feeds his daily and " + 
                    "nightlong fire, afford points of interest to the wanderer among the hills, who seats " + 
                    "himself on a log of wood or a fragment of marble, to hold a chat with the solitary man. " + 
                    "It is a lonesome, and, when the character is inclined to thought, may be an intensely " + 
                    "thoughtful occupation; as it proved in the case of Ethan Brand, who had mused to such " + 
                    "strange purpose, in days gone by, while the fire in this very kiln was burning.</flow:span>" +
            "</flow:p>" +
            "<flow:p paragraphSpaceBefore='inherit'>" +
                "<flow:span>" + 
                    "The man who now watched the fire was of a different order, and troubled himself with no " + 
                    "thoughts save the very few that were requisite to his business. At frequent intervals, " + 
                    "he flung back the clashing weight of the iron door, and, turning his face from the " + 
                    "insufferable glare, thrust in huge logs of oak, or stirred the immense brands with a " + 
                    "long pole. Within the furnace were seen the curling and riotous flames, and the burning " + 
                    "marble, almost molten with the intensity of heat; while without, the reflection of the " + 
                    "fire quivered on the dark intricacy of the surrounding forest, and showed in the " + 
                    "foreground a bright and ruddy little picture of the hut, the spring beside its door, the " + 
                    "athletic and coal-begrimed figure of the lime-burner, and the halffrightened child, " + 
                    "shrinking into the protection of his father's shadow. And when again the iron door was " + 
                    "closed, then reappeared the tender light of the half-full moon, which vainly strove to" + 
                    "trace out the indistinct shapes of the neighboring mountains; and, in the upper sky, " + 
                    "there was a flitting congregation of clouds, still faintly tinged with the rosy sunset, " + 
                    "though thus far down into the valley the sunshine had vanished long and long ago.</flow:span>" + 
            "</flow:p>" +
        "</flow:TextFlow>";
        public function ContainerControllerExample1()
        {
            // create the TextFlow, containers, and container controllers
            var textFlow:TextFlow;
            var container:Sprite = new Sprite();
            var container2:Sprite = new Sprite();
            var controllerOne:ContainerController = new ContainerController(container, 200, 210);
            var controllerTwo:ContainerController = new ContainerController(container2, 200, 220);
            // import the text flow from markup using TextConverter and assign a StandardFlowComposer
            textFlow = TextConverter.importToFlow(textMarkup, TextConverter.TEXT_LAYOUT_FORMAT);
            textFlow.flowComposer = new StandardFlowComposer();
            // draw the container circles, add them to the stage and position them
            container.graphics.beginFill(0xFFCC00);
            container.graphics.drawCircle(100, 100, 140);
            container.graphics.endFill();
            container2.graphics.beginFill(0xFF0000);
            container2.graphics.drawCircle(100, 100, 140);
            container2.graphics.endFill();            
            addChild(container);
            addChild(container2);
            container.x = 25;
            container.y = 100;
            container2.x = 280;
            container2.y = 100;    
            // add the controllers to the text flow and update them to display the text
            textFlow.flowComposer.addController(controllerOne);
            textFlow.flowComposer.addController(controllerTwo);
            textFlow.flowComposer.updateAllControllers();
        }    
    }
}

ContainerControllerExample2.as

這個範例會在兩個容器中顯示兩個文字方向、標題和內文。 這個範例會為內文建立直欄以及實作捲動。當舞臺的大小變更後,resizeHandler() 方法會調整容器的大小以及編輯文字方向。
package flashx.textLayout.container.examples 
{
    import flash.display.Sprite;
    import flash.display.StageAlign;
    import flash.events.Event;
    import flash.geom.Rectangle;
    
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.container.ScrollPolicy;
    import flashx.textLayout.conversion.TextConverter;
    import flashx.textLayout.edit.SelectionManager;
    import flashx.textLayout.elements.TextFlow;
    import flashx.textLayout.formats.TextLayoutFormat;

    public class ContainerControllerExample2 extends Sprite
    {    
        // these variables are accessible to both methods in the class
        private var headingFlow:TextFlow;
        private var bodyFlow:TextFlow;
        private var headController:ContainerController;
        private var bodyController:ContainerController;
        
        private const headingMarkup:String = "<flow:TextFlow xmlns:flow='http://ns.adobe.com/textLayout/2008'>" +
                "<flow:p textAlign='center'>" +
                    "<flow:span fontFamily='Georgia' fontSize='36'>Ethan Brand</flow:span><flow:br/>" +
                    "<flow:span fontSize='8' fontStyle='italic'>by </flow:span>" +
                    "<flow:span fontSize='12' fontStyle='italic'>Nathaniel Hawthorne</flow:span>" +    
                "</flow:p>" +
            "</flow:TextFlow>";
        private const bodyMarkup:String = "<flow:TextFlow xmlns:flow='http://ns.adobe.com/textLayout/2008' fontSize='8' " + 
                "textIndent='10' paragraphSpaceBefore='6' paddingTop='8' paddingBottom='8' paddingLeft='8' paddingRight='8'>" +
            "<flow:p paragraphSpaceBefore='inherit' >" +
                "<flow:span>There are many </flow:span>" + 
                "<flow:span fontStyle='italic'>such</flow:span>" + 
                "<flow:span> lime-kilns in that tract of country, for the purpose of burning the white" + 
                    " marble which composes a large part of the substance of the hills. Some of them, built " + 
                    "years ago, and long deserted, with weeds growing in the vacant round of the interior, " + 
                    "which is open to the sky, and grass and wild-flowers rooting themselves into the chinks " + 
                    "of the stones, look already like relics of antiquity, and may yet be overspread with the" + 
                    " lichens of centuries to come. Others, where the lime-burner still feeds his daily and " + 
                    "nightlong fire, afford points of interest to the wanderer among the hills, who seats " + 
                    "himself on a log of wood or a fragment of marble, to hold a chat with the solitary man. " + 
                    "It is a lonesome, and, when the character is inclined to thought, may be an intensely " + 
                    "thoughtful occupation; as it proved in the case of Ethan Brand, who had mused to such " + 
                    "strange purpose, in days gone by, while the fire in this very kiln was burning.</flow:span>" +
            "</flow:p>" +
            "<flow:p paragraphSpaceBefore='inherit'>" +
                "<flow:span>" + 
                    "The man who now watched the fire was of a different order, and troubled himself with no " + 
                    "thoughts save the very few that were requisite to his business. At frequent intervals, " + 
                    "he flung back the clashing weight of the iron door, and, turning his face from the " + 
                    "insufferable glare, thrust in huge logs of oak, or stirred the immense brands with a " + 
                    "long pole. Within the furnace were seen the curling and riotous flames, and the burning " + 
                    "marble, almost molten with the intensity of heat; while without, the reflection of the " + 
                    "fire quivered on the dark intricacy of the surrounding forest, and showed in the " + 
                    "foreground a bright and ruddy little picture of the hut, the spring beside its door, the " + 
                    "athletic and coal-begrimed figure of the lime-burner, and the halffrightened child, " + 
                    "shrinking into the protection of his father's shadow. And when again the iron door was " + 
                    "closed, then reappeared the tender light of the half-full moon, which vainly strove to " + 
                    "trace out the indistinct shapes of the neighboring mountains; and, in the upper sky, " + 
                    "there was a flitting congregation of clouds, still faintly tinged with the rosy sunset, " + 
                    "though thus far down into the valley the sunshine had vanished long and long ago.</flow:span>" + 
            "</flow:p>" +
        "</flow:TextFlow>";
        public function ContainerControllerExample2()
        {
            // align the stage and add a listener (resizeHandler) for RESIZE events
            stage.align = StageAlign.TOP_LEFT;
            stage.addEventListener(flash.events.Event.RESIZE, resizeHandler);
            // create heading text flow, import heading text, and assign composer
            headingFlow = new TextFlow();
            headingFlow = TextConverter.importToFlow(headingMarkup, TextConverter.TEXT_LAYOUT_FORMAT);
            // create body text flow, import body text, and assign flow composer
            bodyFlow = new TextFlow();
            bodyFlow = TextConverter.importToFlow(bodyMarkup, TextConverter.TEXT_LAYOUT_FORMAT);
            // create heading container, add controller, position container and add to stage
            var headContainer:Sprite = new Sprite();
            headController = new ContainerController(headContainer, 300, 50);
            headingFlow.flowComposer.addController(headController);    
            headContainer.x = 120;
            headContainer.y = 20;
            addChild(headContainer);
            // update controller to display heading text
            headingFlow.flowComposer.updateAllControllers();
            // create container for body text and position it
            var bodyContainer:Sprite = new Sprite();
            bodyController = new ContainerController(bodyContainer, 300, 200);
            bodyContainer.x = 125;
            bodyContainer.y = 85;
            // create container format to specify columns
            var bodyContainerFormat:TextLayoutFormat = new TextLayoutFormat();
            bodyContainerFormat.columnWidth = 120;
            bodyContainerFormat.columnGap = 15;
            bodyController.format = bodyContainerFormat;
            // enable scrolling
            bodyController.verticalScrollPolicy = ScrollPolicy.AUTO;
            bodyFlow.interactionManager = new SelectionManager();
            // add controller, add container to stage, and display body text
            bodyFlow.flowComposer.addController(bodyController);
            addChild(bodyContainer);
            bodyFlow.flowComposer.updateAllControllers();
        }
        
        private function resizeHandler(event:Event):void
        {
            const verticalGap:Number = 25;
            const stagePadding:Number = 16;
            var stageWidth:Number = stage.stageWidth - stagePadding;
            var stageHeight:Number = stage.stageHeight - stagePadding;
            var headlineWidth:Number = stageWidth;
            var headlineContainerHeight:Number = stageHeight;
            // Initial compose to get height of headline after resize
            headController.setCompositionSize(headlineWidth, headlineContainerHeight);
            headingFlow.flowComposer.compose();
            var rect:Rectangle = headController.getContentBounds();
            headlineContainerHeight = rect.height;
            // Resize and place headline text container
            // Call setCompositionSize() again with updated headline height
            headController.setCompositionSize(headlineWidth, headlineContainerHeight );
            headController.container.x = stagePadding / 2;
            headController.container.y = stagePadding / 2;
            headingFlow.flowComposer.updateAllControllers();
            // Resize and place body text container
            var bodyContainerHeight:Number = (stageHeight - verticalGap -
            headlineContainerHeight);
            bodyController.setCompositionSize(stageWidth, bodyContainerHeight );
            bodyController.container.x = (stagePadding/2);
            bodyController.container.y = (stagePadding/2) + headlineContainerHeight +
                verticalGap;
            bodyFlow.flowComposer.updateAllControllers();
        }
    }
}




[ X ]為什麼顯示英文?
「ActionScript 3.0 參考」的內容是以英文顯示

並非所有「ActionScript 3.0 參考」的內容都翻譯為所有語言。當語言元素未翻譯時,就會以英文顯示。例如,ga.controls.HelpBox 類別並沒有翻譯為任何語言。因此在參考的繁體中文版本中,ga.controls.HelpBox 類別就會以英文顯示。