| 套件 | flash.text.engine |
| 類別 | public class ContentElement |
| 繼承 | ContentElement  Object |
| 子類別 | GraphicElement, GroupElement, TextElement |
| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5, Flash Lite 4 |
ContentElement 是抽象的基底類別，因此，您無法直接實體化 ContentElement。叫用 new ContentElement() 會擲回 ArgumentError 例外。
一個 ContentElement 元素只能指定給一個 GroupElement 或一個文字區塊的 content 屬性。
相關 API 元素
隱藏繼承公用屬性
顯示繼承公用屬性| 屬性 | 定義自 | ||
|---|---|---|---|
 | constructor : Object
類別物件的參照或是特定物件實體的建構函數。 | Object | |
| elementFormat : ElementFormat
用於此元素的 ElementFormat 物件。 | ContentElement | ||
| eventMirror : EventDispatcher
EventDispatcher 物件，此物件會接收傳送給有效文字行之每一個事件的副本 (這些文字行是根據這個內容元素所建立)。 | ContentElement | ||
| groupElement : GroupElement [唯讀]
包含此元素的 GroupElement 物件，如果它不在群組中則為 null。 | ContentElement | ||
| rawText : String [唯讀]
元素中的文字副本，包括任何 U+FDEF 字元。 | ContentElement | ||
| text : String [唯讀]
元素中的文字副本，不包括代表 String 中之圖像元素的任何 U+FDEF 字元。 | ContentElement | ||
| textBlock : flash.text.engine:TextBlock [唯讀]
此元素所屬的 TextBlock。 | ContentElement | ||
| textBlockBeginIndex : int [唯讀]
此元素之第一個字母的文字區塊內的索引。 | ContentElement | ||
| textRotation : String
將旋轉當成一個單位套用至元素。 | ContentElement | ||
| userData : *
提供了讓應用程式將任意資料與元素產生關聯的方法。 | ContentElement | ||
| 方法 | 定義自 | ||
|---|---|---|---|
ContentElement(elementFormat:ElementFormat = null, eventMirror:EventDispatcher = null, textRotation:String = "rotate0")
呼叫 new ContentElement() 建構函式會擲回 ArgumentError 例外。 | ContentElement | ||
|
指出物件是否有已定義的指定屬性。 | Object | |
|
指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。 | Object | |
|
指出指定的屬性是否存在，以及是否可列舉。 | Object | |
|
為迴圈作業設定動態屬性的可用性。 | Object | |
|
傳回代表此物件的字串，根據地區特定慣例進行格式化。 | Object | |
|
會傳回指定之物件的字串形式。 | Object | |
|
會傳回指定之物件的基本值。 | Object | |
| 常數 | 定義自 | ||
|---|---|---|---|
| GRAPHIC_ELEMENT : uint = 0xFDEF [靜態]
指出文字內有圖像元素存在。 | ContentElement | ||
elementFormat | 屬性 |
elementFormat:ElementFormat| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5, Flash Lite 4 |
用於此元素的 ElementFormat 物件。
預設值為 null。
設定 elementFormat 屬性時，就會鎖定所提供的 ElementFormat 物件：其 locked 屬性設定為 true。已鎖定的 ElementFormat 不得修改。
實作
public function get elementFormat():ElementFormat public function set elementFormat(value:ElementFormat):void相關 API 元素
eventMirror | 屬性 |
eventMirror:EventDispatcher| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5, Flash Lite 4 |
EventDispatcher 物件，此物件會接收傳送給有效文字行之每一個事件的副本 (這些文字行是根據這個內容元素所建立)。指定的物件可用來針對文字連結或其它互動式文字片段設定偵聽程式，因為在執行階段判斷字行的哪些部分是由特定內容元素所產生可能會很困難。偵聽程式也可用來套用裝飾 (如底線)，但是要等到文字配置好之後才可決定這些裝飾的度量。預設值為 null，這表示不會傳送任何鏡像事件。
在文字行中，事件映射會以 TextLineMirrorRegion 類別實體的方式顯示出來。依照雙向處理與斷行處理方式而定，有可能會產生一或多個映射區域。
預設值為 null。
實作
public function get eventMirror():EventDispatcher public function set eventMirror(value:EventDispatcher):void相關 API 元素
groupElement | 屬性 |
groupElement:GroupElement [唯讀] | 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5, Flash Lite 4 |
包含此元素的 GroupElement 物件，如果它不在群組中則為 null。
預設值為 null。
實作
public function get groupElement():GroupElement相關 API 元素
rawText | 屬性 |
text | 屬性 |
textBlock | 屬性 |
textBlock:flash.text.engine:TextBlock [唯讀] | 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5, Flash Lite 4 |
此元素所屬的 TextBlock。
預設值為 null。
實作
public function get textBlock():flash.text.engine:TextBlock相關 API 元素
textBlockBeginIndex | 屬性 |
textRotation | 屬性 |
textRotation:String| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5, Flash Lite 4 |
將旋轉當成一個單位套用至元素。請針對此屬性使用 TextRotation 常數。
預設值為 TextRotation.ROTATE_0。
任何字符的最終旋轉都是 ElementFormat.textRotation、ContentElement.textRotation 和 TextBlock.lineRotation 的總和。
ContentElement.textRotation 會用來建立簡短連續文字 (其旋轉與包含的字行不同)。日文文字中的連續 TCY 就是一個範例：TCY 代表「縱中橫」(Tate-Chu-Yoko)，是指某些垂直日文文字中的少數水平連續文字 (通常是數字)。若要建立包含連續 TCY 之垂直日文文字的段落，請執行以下動作：
- 設定
TextBlock.lineRotation=TextRotation.ROTATE_90。 - 將
TextBlock.content設定為 GroupElement，後者是由三個 TextElement 物件所組成。這些元素一開始是 TCY 連續文字之前的日文文字，接下來是 TCY 連續文字的拉丁文字，然後是 TCY 連續文字後面的日文文字。 - 將 TCY
TextElement的 textRotation 屬性設為TextRotation.ROTATE_270。TCY 文字元素會將自己當成一個單位來旋轉。它會從 90 度開始旋轉 (繼承自此行)。增加 270 度會讓它轉一圈到水平位置。
旋轉的內容元素無法形成巢狀結構。在內容元素的任何階層架構中，不論複雜性如何，只有一個內容元素可以設定它的 textRotation 屬性。下列方法和屬性 setter 將會在偵測到巢狀旋轉時擲回引數錯誤：
ContentElement.textRotationGroupElement.setElementsGroupElement.replaceElements
若要設定此屬性，請使用下列字串值：
| 字串值 | 說明 |
|---|---|
TextRotation.ROTATE_0 | 元素尚未旋轉。 |
TextRotation.ROTATE_90 | 元素以順時針方向旋轉 90 度。 |
TextRotation.ROTATE_180 | 元素旋轉 180 度。 |
TextRotation.ROTATE_270 | 元素以順時針方向旋轉 270 度。 |
TextRotation.AUTO | 不支援。 |
實作
public function get textRotation():String public function set textRotation(value:String):void擲回值
ArgumentError — 如果設為不屬於 TextRotation 成員的任何一個值。
| |
ArgumentError — 如果設定為 TextRotation.AUTO。
| |
ArgumentError — 如果此作業產生 GroupElement 內的巢狀旋轉。
|
相關 API 元素
userData | 屬性 |
public var userData:*| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5, Flash Lite 4 |
提供了讓應用程式將任意資料與元素產生關聯的方法。
預設值為 null。
ContentElement | () | 建構函式 |
public function ContentElement(elementFormat:ElementFormat = null, eventMirror:EventDispatcher = null, textRotation:String = "rotate0")| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5, Flash Lite 4 |
呼叫 new ContentElement() 建構函式會擲出 ArgumentError 例外。然而，您「可以」呼叫下列 ContentElement 子類別的建構函式：
new GraphicElement()new GroupElement()new TextElement()
elementFormat:ElementFormat (default = null)null。
| |
eventMirror:EventDispatcher (default = null)EventDispatcher 物件，此物件會接收傳送給有效文字行之每一個事件的副本 (這些文字行是根據這個內容元素所建立)。預設值為 null。
| |
textRotation:String (default = "rotate0")TextRotation 常數。預設值為 TextRotation.ROTATE_0。
|
GRAPHIC_ELEMENT | 常數 |
Tue Jun 12 2018, 03:47 PM Z