套件 | flash.text.engine |
類別 | public final class GraphicElement |
繼承 | GraphicElement ContentElement Object |
語言版本: | ActionScript 3.0 |
執行階段版本: | Flash Player 10, AIR 1.5, Flash Lite 4 |
content
屬性,以便使用 TextBlock.createTextLine()
來顯示圖像或影像。將其指定給 GroupElement 物件,以便和其他圖像與文字元素結合。
相關 API 元素
公用屬性
屬性 | 定義自 | ||
---|---|---|---|
constructor : Object
類別物件的參照或是特定物件實體的建構函數。 | Object | ||
elementFormat : ElementFormat
用於此元素的 ElementFormat 物件。 | ContentElement | ||
elementHeight : Number
要保留給此行之圖像的高度 (以像素為單位)。 | GraphicElement | ||
elementWidth : Number
要保留給此行之圖像的寬度 (以像素為單位)。 | GraphicElement | ||
eventMirror : EventDispatcher
EventDispatcher 物件,此物件會接收傳送給有效文字行之每一個事件的副本 (這些文字行是根據這個內容元素所建立)。 | ContentElement | ||
graphic : DisplayObject
要當做 GraphicElement 之圖像使用的 DisplayObject。 | GraphicElement | ||
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 |
公用方法
方法 | 定義自 | ||
---|---|---|---|
GraphicElement(graphic:DisplayObject = null, elementWidth:Number = 15.0, elementHeight:Number = 15.0, elementFormat:ElementFormat = null, eventMirror:EventDispatcher = null, textRotation:String = "rotate0")
建立新的 GraphicElement 實體。 | GraphicElement | ||
指出物件是否有已定義的指定屬性。 | Object | ||
指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。 | Object | ||
指出指定的屬性是否存在,以及是否可列舉。 | Object | ||
為迴圈作業設定動態屬性的可用性。 | Object | ||
傳回代表此物件的字串,根據地區特定慣例進行格式化。 | Object | ||
會傳回指定之物件的字串形式。 | Object | ||
會傳回指定之物件的基本值。 | Object |
屬性詳細資訊
elementHeight | 屬性 |
elementWidth | 屬性 |
graphic | 屬性 |
graphic:DisplayObject
語言版本: | ActionScript 3.0 |
執行階段版本: | Flash Player 10, AIR 1.5, Flash Lite 4 |
要當做 GraphicElement 之圖像使用的 DisplayObject。
預設值為 null
。
當 GraphicElement 成為文字行的一部分時,圖像就會當成文字行的子系加入。設定圖像會將舊的圖像從字行中移除,然後加入新的圖像。
實作
public function get graphic():DisplayObject
public function set graphic(value:DisplayObject):void
建構函式詳細資料
GraphicElement | () | 建構函式 |
public function GraphicElement(graphic:DisplayObject = null, elementWidth:Number = 15.0, elementHeight:Number = 15.0, elementFormat:ElementFormat = null, eventMirror:EventDispatcher = null, textRotation:String = "rotate0")
語言版本: | ActionScript 3.0 |
執行階段版本: | Flash Player 10, AIR 1.5, Flash Lite 4 |
建立新的 GraphicElement 實體。
圖像的註冊點會與區域的左上角對齊,而此區域是由 elementHeight
、elementWidth
和 elementFormat.baselineShift
所定義。圖像不會縮放以符合區域的大小。如果 GraphicElement 有 eventMirror
,便由 elementWidth
和 elementHeight
屬性 (而非圖形) 決定產生的鏡像區域大小和位置。如果使用載入器,圖形可能不會在建立文字行和鏡像區域時載入。
graphic:DisplayObject (default = null ) — 要填入 GraphicElement 的 DisplayObject。預設值為 null 。
| |
elementWidth:Number (default = 15.0 ) — 保留給元素的區域寬度 (以像素為單位)。預設值為 15。
| |
elementHeight:Number (default = 15.0 ) — 保留給元素的區域高度 (以像素為單位)。預設值為 15。
| |
elementFormat:ElementFormat (default = null ) — 元素的元素格式。預設值為 null 。
| |
eventMirror:EventDispatcher (default = null ) — EventDispatcher 物件,此物件將會接收傳送給文字行之每一個事件的副本 (這些文字行是根據這個內容元素所建立)。預設值為 null 。
| |
textRotation:String (default = "rotate0 ") — 旋轉會將元素當做一個單位進行套用。針對此屬性使用 flash.text.engine.TextRotation 常數。預設值為 flash.text.engine.TextRotation.ROTATE_0 。
|
相關 API 元素
範例 如何使用本範例
GraphicElementExample.as
以下範例使用 GraphicElement (紅色方塊) 來建立 TextBlock 並加以顯示,接著將第二個 TextBlock 加入其下 (內含註解)。
package { import flash.display.Sprite; import flash.display.MovieClip; import flash.text.engine.TextBlock; import flash.text.engine.TextElement; import flash.text.engine.GraphicElement; import flash.text.engine.TextLine; import flash.text.engine.ElementFormat; import flash.text.engine.FontDescription; public class GraphicElementExample extends Sprite { public function GraphicElementExample():void { var format:ElementFormat = new ElementFormat(); format.fontSize = 14; var redBox:MovieClip = new MovieClip(); redBox.graphics.beginFill(0xCC0000, 1.0); redBox.graphics.drawRect(0,0, 200, 200); redBox.graphics.endFill(); var graphicElement:GraphicElement = new GraphicElement(redBox,redBox.width,redBox.height, format); var textBlock:TextBlock = new TextBlock(); textBlock.content = graphicElement; var textLine1:TextLine = textBlock.createTextLine(null,redBox.width); addChild(textLine1); textLine1.x = 15 textLine1.y = 215 var str:String = "Your picture here ..."; var textElement:TextElement = new TextElement(str, format); textBlock = new TextBlock(); textBlock.content = textElement; var textLine2 = textBlock.createTextLine(null, 300); addChild(textLine2); textLine2.x = textLine1.x; textLine2.y += textLine1.y + format.fontSize; } } }
Tue Jun 12 2018, 03:47 PM Z