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

TextFlowLine  - AS3

套件flashx.textLayout.compose
類別public final class TextFlowLine
繼承TextFlowLine Inheritance Object
實作 IVerticalJustificationLine

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

TextFlowLine 類別代表文字流排中的單一文字行。

使用此類別可存取如何撰寫文字行的資訊:其位置、高度、寬度等。修改文字流排 (TextFlow) 時,因為需要重新撰寫修改處的文字行或緊接在它前面的文字行,所以會將這些行標記為無效。修改處後面的文字行可能不會立即損壞,但它們可能會在撰寫文字之後重新產生。您可以存取已損壞的 TextFlowLine,但是任何存取的值反映的都會是 TextFlow 的舊狀態。重新撰寫 TextFlow 時,會產生新的行,您可以呼叫 TextFlow.flowComposer.findLineAtPosition() 來取得指定位置的新文字行。



公用屬性
 屬性定義自
  absoluteStart : int
[唯讀] 行的位置 (為 TextFlow 物件中的絕對字元位置)。
TextFlowLine
  ascent : Number
[唯讀] 指定此行中從基線開始到最高字元的上方,之間距離多少像素。
TextFlowLine
  columnIndex : int
[唯讀] 放置此行的欄號 (第一欄是 0)。
TextFlowLine
 Inheritedconstructor : Object
類別物件的參照或是特定物件實體的建構函數。
Object
  controller : ContainerController
[唯讀] 在其中放入文字行之容器的控制器 (ContainerController 物件)。
TextFlowLine
  descent : Number
[唯讀] 指定此行中從基線開始到最低字元的下方,之間距離多少像素。
TextFlowLine
  height : Number
[唯讀] 行的高度,以像素為單位。
TextFlowLine
  lineOffset : Number
[唯讀] 對齊段落中的文字行之前,從適當的容器內移距 (由段落方向及容器區塊級別指定) 開始算起的行偏移量 (像素)。
TextFlowLine
  location : int
[唯讀] TextFlowLineLocation 的其中一個值,用以指定行在段落內的位置。
TextFlowLine
  paragraph : ParagraphElement
[唯讀] 此行所在的段落 (ParagraphElement)。
TextFlowLine
  spaceAfter : Number
[唯讀] 文字行後面保留的空格數。
TextFlowLine
  spaceBefore : Number
[唯讀] 文字行前面保留的空格數。
TextFlowLine
  textHeight : Number
[唯讀] 文字行的高度,等於 ascent 加上 descent。
TextFlowLine
  textLength : int
[唯讀] 與下一行之間的字元數 (包含結尾空格)。
TextFlowLine
  textLineExists : Boolean
[唯讀] 指出此 TextFlowLine 的 flash.text.engine.TextLine 物件是否存在。
TextFlowLine
  unjustifiedTextWidth : Number
[唯讀] 字行未對齊時的寬度。
TextFlowLine
  validity : String
[唯讀] 行的有效性。
TextFlowLine
  x : Number
文字行相對於所屬容器的水平位置,以像素為單位從容器左側的偏移量來表示。
TextFlowLine
  y : Number
文字行相對於所屬容器的垂直位置,以像素為單位從容器上方的偏移量來表示。
TextFlowLine
公用方法
 方法定義自
  
TextFlowLine(textLine:flash.text.engine:TextLine, paragraph:ParagraphElement, outerTargetWidth:Number = 0, lineOffset:Number = 0, absoluteStart:int = 0, numChars:int = 0)
建構函式 - 建立新的 TextFlowLine 實體。
TextFlowLine
  
將行的邊界傳回為矩形。
TextFlowLine
  
傳回此行的 flash.text.engine.TextLine 物件,而如果此行因記憶體回收而不存在,則可能會予以重建。
TextFlowLine
 Inherited
指出物件是否有已定義的指定屬性。
Object
 Inherited
指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。
Object
 Inherited
指出指定的屬性是否存在,以及是否可列舉。
Object
 Inherited
為迴圈作業設定動態屬性的可用性。
Object
 Inherited
傳回代表此物件的字串,根據地區特定慣例進行格式化。
Object
 Inherited
會傳回指定之物件的字串形式。
Object
 Inherited
會傳回指定之物件的基本值。
Object
屬性詳細資訊

absoluteStart

屬性
absoluteStart:int  [唯讀]

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

行的位置 (為 TextFlow 物件中的絕對字元位置)。



實作
    public function get absoluteStart():int

相關 API 元素

ascent

屬性 
ascent:Number  [唯讀]

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

指定此行中從基線開始到最高字元的上方,之間距離多少像素。在只包含圖像元素的 TextLine 中,會將 ascent 設為 0。



實作
    public function get ascent():Number

columnIndex

屬性 
columnIndex:int  [唯讀]

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

放置此行的欄號 (第一欄是 0)。



實作
    public function get columnIndex():int

controller

屬性 
controller:ContainerController  [唯讀]

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

在其中放入文字行之容器的控制器 (ContainerController 物件)。



實作
    public function get controller():ContainerController

相關 API 元素

descent

屬性 
descent:Number  [唯讀]

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

指定此行中從基線開始到最低字元的下方,之間距離多少像素。在只包含圖像元素的 TextLine 中,會將 descent 設為 0。



實作
    public function get descent():Number

height

屬性 
height:Number  [唯讀]

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

行的高度,以像素為單位。



實作
    public function get height():Number

lineOffset

屬性 
lineOffset:Number  [唯讀]

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

對齊段落中的文字行之前,從適當的容器內移距 (由段落方向及容器區塊級別指定) 開始算起的行偏移量 (像素)。



實作
    public function get lineOffset():Number

location

屬性 
location:int  [唯讀]

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

TextFlowLineLocation 的其中一個值,用以指定行在段落內的位置。



實作
    public function get location():int

相關 API 元素

paragraph

屬性 
paragraph:ParagraphElement  [唯讀]

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

此行所在的段落 (ParagraphElement)。



實作
    public function get paragraph():ParagraphElement

相關 API 元素

spaceAfter

屬性 
spaceAfter:Number  [唯讀]

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

文字行後面保留的空格數。

如果此行是套用 space-after 之段落的最後一行,則此行會有 spaceAfter 值。如果文字行位在欄的底端,則會忽略 spaceAfter。否則,在欄中此行後面會接著另一行,而下一行必須垂直放置,以確保此段落的這個最後一行與下一段的第一行之間至少保有這個值的空格。



實作
    public function get spaceAfter():Number

相關 API 元素

spaceBefore

屬性 
spaceBefore:Number  [唯讀]

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

文字行前面保留的空格數。

如果此行是套用 space-before 之段落的第一行,則此行會有 spaceBefore 值。如果文字行位在欄的頂端,則會忽略 spaceBefore。否則,在欄中此行前面會有另一行,而該行會垂直放置,以確保此段落與上一段的最後一行之間至少保有這個值的空格。



實作
    public function get spaceBefore():Number

相關 API 元素

textHeight

屬性 
textHeight:Number  [唯讀]

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

文字行的高度,等於 ascent 加上 descent。此值是根據基線之間的差異計算而來,而基線是行的邊界 (可以是表意字的頂端及底端或上下緣,視 y=0 的基線是否為表意字 (例如,TextBaseline.IDEOGRAPHIC_TOP) 而定)。



實作
    public function get textHeight():Number

相關 API 元素

textLength

屬性 
textLength:int  [唯讀]

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

與下一行之間的字元數 (包含結尾空格)。



實作
    public function get textLength():int

textLineExists

屬性 
textLineExists:Boolean  [唯讀]

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

指出此 TextFlowLine 的 flash.text.engine.TextLine 物件是否存在。如果 TextLine 物件進行記憶體回收,則此值為 true,如果已進行,則為 false



實作
    public function get textLineExists():Boolean

相關 API 元素

unjustifiedTextWidth

屬性 
unjustifiedTextWidth:Number  [唯讀]

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

字行未對齊時的寬度。如果是未對齊的文字,則此值與 textLength 相同。如果是對齊的文字,則此值為未對齊時的長度,而且 textLength 代表實際的文字行寬度。例如,當對齊下列 String 並指定寬度 500 時,它的實際寬度為 500,但未對齊的寬度為 268.9921875。



實作
    public function get unjustifiedTextWidth():Number

validity

屬性 
validity:String  [唯讀]

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

行的有效性。

如果文字 (已套用特質) 或控制器設定已在建立行之後變更,則行可能會無效。仍然會顯示無效的行,而且您可以使用它,但是使用的值會是建立時的值。getTextLine() 傳回的行也將會處於無效的狀態。



實作
    public function get validity():String

相關 API 元素

x

屬性 
x:Number

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

文字行相對於所屬容器的水平位置,以像素為單位從容器左側的偏移量來表示。

注意:雖然此屬性技術上是 read-write,請將之視為 read-only。setter 存在只是為了滿足 IVerticalJustificationLine 介面的需求,此介面為此屬性定義了 getter 與 setter。雖然仍可使用 setter,但可能導致無法預期的結果。



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

相關 API 元素

y

屬性 
y:Number

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

文字行相對於所屬容器的垂直位置,以像素為單位從容器上方的偏移量來表示。

注意:雖然此屬性技術上是 read-write,請將之視為 read-only。setter 存在只是為了滿足 IVerticalJustificationLine 介面的需求,此介面為此屬性定義了 getter 與 setter。雖然仍可使用 setter,但可能導致無法預期的結果。



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

相關 API 元素

建構函式詳細資料

TextFlowLine

()建構函式
public function TextFlowLine(textLine:flash.text.engine:TextLine, paragraph:ParagraphElement, outerTargetWidth:Number = 0, lineOffset:Number = 0, absoluteStart:int = 0, numChars:int = 0)

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

建構函式 - 建立新的 TextFlowLine 實體。

注意:用戶端不應該呼叫此項目。顯示此項目是要讓您撰寫專屬的撰寫器。

參數
textLine:flash.text.engine:TextLine — 要用於此行的 TextLine 顯示物件。
 
paragraph:ParagraphElement — 要放置行的段落 (ParagraphElement)。
 
outerTargetWidth:Number (default = 0) — 要撰寫的目標行寬度 (不含縮排)。
 
lineOffset:Number (default = 0) — 對齊段落中的文字行之前,從適當的容器內移距 (由段落方向及容器區塊級別指定) 開始算起的行偏移量 (像素)。
 
absoluteStart:int (default = 0) — 文字流排中行的起始字元位置。
 
numChars:int (default = 0) — 字行中的字元數。

相關 API 元素

方法詳細資訊

getBounds

()方法
public function getBounds():Rectangle

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

將行的邊界傳回為矩形。

傳回值
Rectangle — 代表行邊界的矩形。

getTextLine

()方法 
public function getTextLine(forceValid:Boolean = false):flash.text.engine:TextLine

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

傳回此行的 flash.text.engine.TextLine 物件,而如果此行因記憶體回收而不存在,則可能會予以重建。將 forceValid 設為 true 以重新產生 TextLine。如果無法重建 TextLine,則傳回 null。

參數

forceValid:Boolean (default = false) — 如果是 true,則會重新產生 TextLine (如果存在但無效)。

傳回值
flash.text.engine:TextLine — 此行的物件,或如果無法重建 TextLine 物件,則為 null

相關 API 元素





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

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