StaticText - Adobe ActionScript® 3 (AS3 ) API 參考

套件	flash.text
類別	public final class StaticText
繼承	StaticText DisplayObject EventDispatcher Object

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

這個類別代表顯示清單中的 StaticText 物件。您不能使用 ActionScript 來建立 StaticText 物件，唯有編寫工具才能建立 StaticText 物件。若嘗試建立新的 StaticText 物件，便會產生 ArgumentError。

若要建立 ActionScript 3.0 中現有靜態文字欄位的參考，您可以重複執行顯示清單中的項目。例如，下列程式碼片段會檢查顯示清單是否包含靜態文字欄位，然後將該欄位指定給變數：

 var i:uint;
 for (i = 0; i < this.numChildren; i++) {
     var displayitem:DisplayObject = this.getChildAt(i);
     if (displayitem instanceof StaticText) {
         trace("a static text field is item " + i + " on the display list");
         var myFieldLabel:StaticText = StaticText(displayitem);
         trace("and contains the text: " + myFieldLabel.text);
     }
 }

公用屬性

隱藏繼承公用屬性

顯示繼承公用屬性

	屬性		定義自
		accessibilityProperties : AccessibilityProperties 此顯示物件的目前輔助功能選項。	DisplayObject
		alpha : Number 指出所指定物件的 Alpha 透明度值。	DisplayObject
		blendMode : String 來自 BlendMode 類別的值，會指定要使用何種混合模式。	DisplayObject
		blendShader : Shader [唯寫] 設定用來混合前景和背景的著色器。	DisplayObject
		cacheAsBitmap : Boolean 如果設定為 true，Flash 執行階段會快取顯示物件的內部點陣圖表示法。	DisplayObject
		cacheAsBitmapMatrix : Matrix 如果為非 null，當 cacheAsBitmap 設定為 true 時，這個 Matrix 物件會定義顯示物件的顯示方法。	DisplayObject
		constructor : Object 類別物件的參照或是特定物件實體的建構函數。	Object
		filters : Array 索引的陣列，其中包含目前和顯示物件相關的每個濾鏡物件。	DisplayObject
		height : Number 會指出顯示物件的高度，以像素為單位。	DisplayObject
		loaderInfo : LoaderInfo [唯讀] 會傳回 LoaderInfo 物件，其中包含關於載入此顯示物件所屬之檔案的資訊。	DisplayObject
		mask : DisplayObject 呼叫之顯示物件會以指定的 mask 物件遮蓋。	DisplayObject
		metaData : Object 如果中繼資料是透過 PlaceObject4 標籤與 SWF 檔案中的這個 DisplayObject 實體一同儲存，則會取得 DisplayObject 實體的中繼資料物件。	DisplayObject
		mouseX : Number [唯讀] 指出滑鼠或使用者輸入裝置位置的 x 座標，以像素為單位。	DisplayObject
		mouseY : Number [唯讀] 指出滑鼠或使用者輸入裝置位置的 y 座標，以像素為單位。	DisplayObject
		name : String 指出 DisplayObject 的實體名稱。	DisplayObject
		opaqueBackground : Object 會指定顯示物件是否不透明，並具有特定背景顏色。	DisplayObject
		parent : DisplayObjectContainer [唯讀] 指出包含此顯示物件的 DisplayObjectContainer 物件。	DisplayObject
		root : DisplayObject [唯讀] 對載入之 SWF 檔案的顯示物件而言，root 屬性就是該 SWF 檔案所呈現之顯示清單樹狀結構部分的最上層顯示物件。	DisplayObject
		rotation : Number 指出 DisplayObject 實體的旋轉度數 (從該物件原本方向算起)。	DisplayObject
		rotationX : Number 表示 DisplayObject 實體相對於 3D 父輩容器從原始方向旋轉的 x 軸旋轉 (以度數為單位)。	DisplayObject
		rotationY : Number 表示 DisplayObject 實體相對於 3D 父輩容器從原始方向旋轉的 y 軸旋轉 (以度數為單位)。	DisplayObject
		rotationZ : Number 表示 DisplayObject 實體相對於 3D 父輩容器從原始方向旋轉的 z 軸旋轉 (以度數為單位)。	DisplayObject
		scale9Grid : Rectangle 目前產生效用的縮放格線。	DisplayObject
		scaleX : Number 指出從註冊點套用的物件水平縮放 (百分比)。	DisplayObject
		scaleY : Number 指出從物件註冊點套用的物件垂直縮放 (百分比)。	DisplayObject
		scaleZ : Number 指出從物件註冊點套用的物件深度縮放 (百分比)。	DisplayObject
		scrollRect : Rectangle 顯示物件的捲動矩形範圍。	DisplayObject
		stage : Stage [唯讀] 顯示物件的「舞台」。	DisplayObject
		text : String [唯讀] 會傳回靜態文字欄位的目前文字。	StaticText
		transform : flash.geom:Transform 這是一個物件，具有和顯示物件的矩陣、顏色轉換和像素邊界有關的屬性。	DisplayObject
		visible : Boolean 不管是否看得見顯示物件。	DisplayObject
		width : Number 會指出顯示物件的寬度，以像素為單位。	DisplayObject
		x : Number 指出 DisplayObject 實體相對於父輩 DisplayObjectContainer 之區域座標的 x 座標。	DisplayObject
		y : Number 指出 DisplayObject 實體相對於父輩 DisplayObjectContainer 之區域座標的 y 座標。	DisplayObject
		z : Number 表示 DisplayObject 實體相對於 3D 父輩容器的 z 座標位置 (沿著 z 軸)。	DisplayObject

公用方法

隱藏繼承公用方法

顯示繼承公用方法

	方法		定義自
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 會在 EventDispatcher 物件註冊事件偵聽程式，以便讓偵聽程式收到事件的通知。	EventDispatcher
		dispatchEvent(event:Event):Boolean 會將事件傳送到事件流程。	EventDispatcher
		getBounds(targetCoordinateSpace:DisplayObject):Rectangle 傳回可定義顯示物件區域 (相對於 targetCoordinateSpace 物件的座標系統) 的矩形。	DisplayObject
		getRect(targetCoordinateSpace:DisplayObject):Rectangle 根據 targetCoordinateSpace 參數所定義的座標系統，並排除形狀上的任何筆畫，傳回可定義顯示物件邊界的矩形。	DisplayObject
		globalToLocal(point:Point):Point 將 point 物件從「舞台」(全域) 座標轉換成顯示物件的 (區域) 座標。	DisplayObject
		globalToLocal3D(point:Point):Vector3D 將二維點從「舞台」(全域) 座標轉換為三維顯示物件的 (區域) 座標。	DisplayObject
		hasEventListener(type:String):Boolean 會檢查 EventDispatcher 物件是否有對特定的事件類型註冊偵聽程式。	EventDispatcher
		hasOwnProperty(name:String):Boolean 指出物件是否有已定義的指定屬性。	Object
		hitTestObject(obj:DisplayObject):Boolean 評估顯示物件的範圍框，看它是否與 obj 顯示物件的範圍框重疊或相交。	DisplayObject
		hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean 評估顯示物件，看它是否與 x 和 y 參數所指定的點重疊或相交。	DisplayObject
		isPrototypeOf(theClass:Object):Boolean 指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。	Object
		local3DToGlobal(point3d:Vector3D):Point 將三維顯示物件的 (區域) 座標的三維點轉換為「舞台」(全域) 座標中的二維點。	DisplayObject
		localToGlobal(point:Point):Point 將 point 物件從顯示物件的 (區域) 座標轉換成「舞台」(全域) 座標。	DisplayObject
		propertyIsEnumerable(name:String):Boolean 指出指定的屬性是否存在，以及是否可列舉。	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 會從 EventDispatcher 物件移除偵聽程式。	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 為迴圈作業設定動態屬性的可用性。	Object
		toLocaleString():String 傳回代表此物件的字串，根據地區特定慣例進行格式化。	Object
		toString():String 會傳回指定之物件的字串形式。	Object
		valueOf():Object 會傳回指定之物件的基本值。	Object
		willTrigger(type:String):Boolean 檢查此 EventDispatcher 物件是否已註冊事件偵聽程式，或者此物件的任何祖系已為特定事件類型註冊事件偵聽程式。	EventDispatcher

事件

按一下以瞭解事件的詳細資訊

隱藏繼承事件

顯示繼承事件

	摘要	定義自
activate	[廣播事件] 當 Flash Player 或 AIR 應用程式取得作業系統焦點並成為作用中時傳送。	EventDispatcher
added	當顯示物件加入顯示清單中時傳送。	DisplayObject
addedToStage	會在顯示物件加入舞台上的顯示清單時，以直接或是透過加入包含該顯示物件之子樹狀結構的方式傳送。	DisplayObject
deactivate	[廣播事件] 當 Flash Player 或 AIR 應用程式失去作業系統焦點並成為非作用中時傳送。	EventDispatcher
enterFrame	[廣播事件] 當播放磁頭進入新影格時傳送。	DisplayObject
exitFrame	[廣播事件] 當播放磁頭結束目前影格時傳送。	DisplayObject
frameConstructed	[廣播事件] 在影格顯示物件的建構函式執行之後，且影格指令碼執行之前傳送。	DisplayObject
removed	會當顯示物件將要從顯示清單移除時傳送。	DisplayObject
removedFromStage	會在顯示物件即將從顯示清單移除時，以直接或是透過移除包含該顯示物件之子樹狀結構的方式傳送。	DisplayObject
render	[廣播事件] 當顯示清單將要更新和顯示時傳送。	DisplayObject

屬性詳細資訊

text

屬性

text:String [唯讀]

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

會傳回靜態文字欄位的目前文字。編寫工具可以匯出組成完整文字的多個文字欄位物件。例如對於垂直文字，編寫工具會對每個字元建立一個文字欄位。

實作
public function get text():String

法律聲明 | 線上隱私權政策

StaticText - AS3

套件x

語言元素

附錄

套件 flash.text

text