| 套件 | 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
隱藏繼承公用屬性
顯示繼承公用屬性