| 套件 | 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)null。
| |
elementWidth:Number (default = 15.0) | |
elementHeight:Number (default = 15.0) | |
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