| 套件 | flashx.textLayout.container |
| 類別 | public class ContainerController |
| 繼承 | ContainerController Object |
| 實作 | IInteractionEventHandler, ITextLayoutFormat, ISandboxSupport |
| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
相關 API 元素
flashx.textLayout.elements.TextFlow
flash.text.engine.TextLine
| 屬性 | 定義自 | ||
|---|---|---|---|
| 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 | ||
![]() | constructor : 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 | ||
傳回 styleProp 參數指定的樣式值。 | ContainerController | ||
![]() |
指出物件是否有已定義的指定屬性。 | Object | |
當用戶端管理事件時,處理 IMEEvent.IME_START_COMPOSITION 事件。 | ContainerController | ||
將此容器中的所有文字標示為需要撰寫。 | ContainerController | ||
判斷容器是否有需要撰寫的文字。 | ContainerController | ||
![]() |
指出 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 | ||
![]() |
指出指定的屬性是否存在,以及是否可列舉。 | Object | |
捲動以讓文字範圍顯示在容器中。 | ContainerController | ||
在實作 ITextSupport 的組件中設定選取文字的範圍。 | ContainerController | ||
設定容器中允許的文字寬度和高度。 | ContainerController | ||
![]() |
為迴圈作業設定動態屬性的可用性。 | Object | |
將 styleProp 參數指定的樣式值設定為 newValue 參數指定的值。 | ContainerController | ||
當用戶端管理事件時,處理 SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATING 事件。 | ContainerController | ||
當用戶端管理事件時,處理 TextEvent.TEXT_INPUT 事件。 | ContainerController | ||
![]() |
傳回代表此物件的字串,根據地區特定慣例進行格式化。 | Object | |
![]() |
會傳回指定之物件的字串形式。 | Object | |
![]() |
會傳回指定之物件的基本值。 | Object | |
| 方法 | 定義自 | ||
|---|---|---|---|
新增 flash.display.Shape 物件,可在其上繪製背景形狀 (例如,背景色彩)。 | ContainerController | ||
addInlineGraphicElement(parent:DisplayObjectContainer, inlineGraphicElement:DisplayObject, index:int):void
新增 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 = falseabsoluteStart | 屬性 |
alignmentBaseline | 屬性 |
alignmentBaseline:*| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:指定主基線對齊的基線。例如,如果設定 dominantBaseline 為 ASCENT,設定 alignmentBaseline 為 DESCENT 會使得文字上方對齊 DESCENT 基線,或在基線之下。通常是由字行中的最大元素決定基線。

有效值是 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 | 屬性 |
compositionWidth | 屬性 |
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 | 屬性 |
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):voidcoreStyles | 屬性 |
digitCase | 屬性 |
digitCase:*| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:用於此文字的數字大小寫類型。設定值為 DigitCase.OLD_STYLE 會使用不同的字母上緣和字母下緣模擬小寫字體。數字是等比例的間距。只有在選取的字樣中可使用此樣式,大部分是在補充或專業字體中。DigitCase.LINING 設定具有全部大寫字高度,而且通常在圖表中以固定間距排列。

有效值為 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.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.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。這些基線的選擇是由字體及字體大小的選擇所決定。

有效值為 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 對齊字行上緣與容器上方內移距。




有效字串值為 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 | 屬性 |
horizontalScrollPosition | 屬性 |
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.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_ASIAN 的 justificationRule 設定一起使用。FormatValue.AUTO 的預設值針對所有地區設定解析為 JustificationStyle.PUSH_IN_KINSOKU。JustificationStyle 類別定義的常數指定處理避頭尾字元 (不能在字行開頭或結尾出現的日文字元) 的選項。如果您要加寬文字,請指定 JustificationStyle.PUSH-OUT-ONLY。如果您想要讓行為的效果類似使用 JustificationRule.SPACE 的 justificationRule 的效果,請使用 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。
行距基礎:

行距方向:

有效值為 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 類別的值 - MINIMUM、COMMON、UNCOMMON 與 EXOTIC 所啟用的連字具有累增效果。每個值啟用一組新的連字,但也包括先前類型。
注意:使用阿拉伯文或斯拉夫文字體時,ligatureLevel 必須設為 MINIMUM 或更大值。

有效值為 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%。


有效值是從 -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:定義正常狀態下的連結格式化特質。這個值會貫穿整個階層而且會套用至任何為後代的連結。接受 inherit、ITextLayoutFormat 或將具有索引鍵及值做為成員的物件陣列轉換為 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:定義滑鼠位於連結範圍 (滑入) 時,停留狀態連結的格式化特質。這個值會貫穿整個階層而且會套用至任何為後代的連結。接受 inherit、ITextLayoutFormat 或將具有索引鍵及值做為成員的物件陣列轉換為 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:定義正常狀態下的連結格式化特質。這個值會貫穿整個階層而且會套用至任何為後代的連結。接受 inherit、ITextLayoutFormat 或將具有索引鍵及值做為成員的物件陣列轉換為 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:定義格式化特質清單標記。這個值會貫穿整個階層而且會套用至任何為後代的連結。接受 inherit、IListMarkerFormat 或將具有索引鍵及值做為成員的物件陣列轉換為 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 | 屬性 |
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.JUSTIFY,textAlignLast 會指定最後一行 (或唯一的一行,如果這是一個單行區塊時) 的對齊方式。值類似於 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 物件。可能是 textFlow 和 rootElement 值相同,或此為根元素的 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.SPACE 的 justificationRule 值一併使用。
有效值為 TextJustify.INTER_WORD、TextJustify.DISTRIBUTE、FormatValue.INHERIT。
若未定義預設值,則表示未設定。
如果重疊顯示時未定義此屬性,則此屬性將繼承祖系的值。如果沒有祖系設定此屬性,則值將為 TextJustify.INTER_WORD。
實作
public function get textJustify():* public function set textJustify(value:any):void擲回值
RangeError — 設定時值不在此屬性的範圍內
|
相關 API 元素
textLength | 屬性 |
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:用於此文字的印刷大小寫類型。下面是一些範例:

有效值是 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 | 屬性 |
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 | 屬性 |
verticalScrollPosition | 屬性 |
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 有一個預設的 compositionWidth 和 compositionHeight,如果您未指定其寬度和高度,部分文字就會顯示在容器中。
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 元素
範例 ( 如何使用本範例 )
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 | () | 方法 |
beginMouseCapture | () | 方法 |
public function beginMouseCapture():void| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
呼叫時要求用戶端從安全執行程序之外開始轉送 mouseup 與 mousemove 事件。
clearStyle | () | 方法 |
createContextMenu | () | 方法 |
protected function createContextMenu():ContextMenu| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
為 ContainerController 建立內容選單。使用 ContextMenu 類別的方法,將項目新增至選單。
您可以覆寫此方法來定義自訂的內容選單。
傳回值ContextMenu |
相關 API 元素
deactivateHandler | () | 方法 |
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 元素
範例 ( 如何使用本範例 )
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_CHANGE 與 FocusEvent.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 元素
範例 ( 如何使用本範例 )
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 | () | 方法 |
getScrollDelta | () | 方法 |
getStyle | () | 方法 |
imeStartCompositionHandler | () | 方法 |
invalidateContents | () | 方法 |
public function invalidateContents():void| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
將此容器中的所有文字標示為需要撰寫。
範例 ( 如何使用本範例 )
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 元素
範例 ( 如何使用本範例 )
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 元素
範例 ( 如何使用本範例 )
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 元素
範例 ( 如何使用本範例 )
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 | () | 方法 |
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 元素
範例 ( 如何使用本範例 )
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 | () | 方法 |
mouseWheelHandler | () | 方法 |
public function mouseWheelHandler(event:MouseEvent):void| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
當用戶端管理事件時,處理 MouseEvent.MOUSE_WHEEL 事件。
參數
event:MouseEvent — MouseEvent 物件。
|
相關 API 元素
removeBackgroundShape | () | 方法 |
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 | () | 方法 |
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 |
設定容器中允許的文字寬度和高度。寬度和高度可以像素為單位來指定,或者可針對任一個值使用 NaN。NaN 表示測量該值。這可用來尋找所有內容中最寬的行和 (或) 總高度。將 NaN 指定為寬度時,即會以 TextLine.MAX_LINE_WIDTH 的最大寬度來斷行。將 NaN 指定為高度時,即會假設容器的高度無任何限制。實際的測量值已準備好可傳回 getContentBounds。當 TextFlow 的計算 blockProgression 屬性為 BlockProgression.RL 時,便會交換寬度與高度的意義。
參數
w:Number — 容器中適用的文字寬度 (像素)。NaN 表示未指定寬度。
| |
h:Number — 容器中適用的文字高度 (像素)。NaN 表示未指定高度。
|
相關 API 元素
flashx.textLayout.formats.BlockProgression
getContentBounds()
範例 ( 如何使用本範例 )
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 | () | 方法 |
softKeyboardActivatingHandler | () | 方法 |
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 元素
範例 ( 如何使用本範例 )
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 | () | 方法 |
updateVisibleRectangle | () | 方法 |
protected function updateVisibleRectangle():void| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
如果捲動,請將捲動矩形設定為容器矩形,如此畫面中任何未能全部顯示的行就會剪裁至可捲動區域。如果未捲動,請清除捲動矩形,就不會進行剪裁。
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();
}
}
}
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();
}
}
}
Tue Jun 12 2018, 03:47 PM Z
隱藏繼承公用屬性
顯示繼承公用屬性