套件 | fl.controls |
類別 | public class TextArea |
繼承 | TextArea UIComponent Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
實作 | IFocusManagerComponent |
語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
相關 API 元素
屬性 | 定義自 | ||
---|---|---|---|
accessibilityImplementation : AccessibilityImplementation
對此 InteractiveObject 實體目前的輔助功能實作 (AccessibilityImplementation)。 | InteractiveObject | ||
accessibilityProperties : AccessibilityProperties
此顯示物件的目前輔助功能選項。 | DisplayObject | ||
alpha : Number
指出所指定物件的 Alpha 透明度值。 | DisplayObject | ||
alwaysShowSelection : Boolean
會取得或設定 Boolean 值,指出當文字欄位未成為焦點時,Flash Player 是否反白標示文字欄位中的選取範圍。 | TextArea | ||
blendMode : String
來自 BlendMode 類別的值,會指定要使用何種混合模式。 | DisplayObject | ||
blendShader : Shader [唯寫]
設定用來混合前景和背景的著色器。 | DisplayObject | ||
buttonMode : Boolean
可指定此 sprite 的按鈕模式。 | Sprite | ||
cacheAsBitmap : Boolean
如果設定為 true,Flash 執行階段會快取顯示物件的內部點陣圖表示法。 | DisplayObject | ||
cacheAsBitmapMatrix : Matrix
如果為非 null,當 cacheAsBitmap 設定為 true 時,這個 Matrix 物件會定義顯示物件的顯示方法。 | DisplayObject | ||
condenseWhite : Boolean
會取得或設定 Boolean 值,指出是否從含有 HTML 文字的 TextArea 組件移除額外的空白字元。 | TextArea | ||
constructor : Object
類別物件的參照或是特定物件實體的建構函數。 | Object | ||
contextMenu : NativeMenu
指定與此物件有關聯的快顯選單。 | InteractiveObject | ||
displayAsPassword : Boolean
會取得或設定 Boolean 值,指出 TextArea 組件實體是否為密碼的文字欄位。 | TextArea | ||
doubleClickEnabled : Boolean
會指定物件是否會收到 doubleClick 事件。 | InteractiveObject | ||
dropTarget : DisplayObject [唯讀]
指定要將 sprite 拖曳至或丟棄至哪個顯示物件上。 | Sprite | ||
editable : Boolean
會取得或設定 Boolean 值,指出是否使用者可以編輯組件中的文字。 | TextArea | ||
enabled : Boolean [覆寫]
會取得或設定值,指出組件是否可以接受使用者互動。 | TextArea | ||
filters : Array
索引的陣列,其中包含目前和顯示物件相關的每個濾鏡物件。 | DisplayObject | ||
focusEnabled : Boolean
會取得或設定 Boolean 值,指出組件是否可以在使用者按一下之後成為焦點。 | UIComponent | ||
focusManager : IFocusManager
會取得或設定控制此組件及其同輩之焦點的 FocusManager。 | UIComponent | ||
focusRect : Object
會指定這個物件是否會顯示焦點矩形。 | InteractiveObject | ||
graphics : Graphics [唯讀]
指定屬於此 sprite 物件的 Graphics 物件,其中可能會產生向量繪圖命令。 | Sprite | ||
height : Number [覆寫]
會取得或設定組件的高度,以像素為單位。 | UIComponent | ||
hitArea : Sprite
指定用來當作 sprite 作用區域的另一個 sprite。 | Sprite | ||
horizontalScrollBar : UIScrollBar [唯讀]
會取得水平捲軸的參考。 | TextArea | ||
horizontalScrollPolicy : String
會取得或設定水平捲軸的捲動原則。 | TextArea | ||
horizontalScrollPosition : Number
會取得或設定使用者水平捲動文字欄位之後,捲軸縮圖位置的變更 (以像素為單位)。 | TextArea | ||
htmlText : String
會取得或設定文字欄位所含字串的 HTML 表示形式。 | TextArea | ||
imeMode : String
會取得或設定輸入法編輯器 (IME) 的模式。 | TextArea | ||
length : Number [唯讀]
會取得 TextArea 組件包含的字元數目。 | TextArea | ||
loaderInfo : LoaderInfo [唯讀]
會傳回 LoaderInfo 物件,其中包含關於載入此顯示物件所屬之檔案的資訊。 | DisplayObject | ||
mask : DisplayObject
呼叫之顯示物件會以指定的 mask 物件遮蓋。 | DisplayObject | ||
maxChars : int
會取得或設定使用者最多可在文字欄位中輸入的字元數。 | TextArea | ||
maxHorizontalScrollPosition : int [唯讀]
會取得 horizontalScrollPosition 屬性的最大值。 | TextArea | ||
maxVerticalScrollPosition : int [唯讀]
會取得 verticalScrollPosition 屬性的最大值。 | TextArea | ||
metaData : Object
如果中繼資料是透過 PlaceObject4 標籤與 SWF 檔案中的這個 DisplayObject 實體一同儲存,則會取得 DisplayObject 實體的中繼資料物件。 | DisplayObject | ||
mouseChildren : Boolean
判斷物件的子系是否支援啟用滑鼠或使用者輸入裝置。 | DisplayObjectContainer | ||
mouseEnabled : Boolean
指定此物件是否接收滑鼠或其他使用者輸入及訊息。 | InteractiveObject | ||
mouseFocusEnabled : Boolean
會取得或設定值,指出組件是否可以在使用者按一下之後成為焦點。 | UIComponent | ||
mouseX : Number [唯讀]
指出滑鼠或使用者輸入裝置位置的 x 座標,以像素為單位。 | DisplayObject | ||
mouseY : Number [唯讀]
指出滑鼠或使用者輸入裝置位置的 y 座標,以像素為單位。 | DisplayObject | ||
name : String
指出 DisplayObject 的實體名稱。 | DisplayObject | ||
needsSoftKeyboard : Boolean
指定虛擬鍵盤 (螢幕上的軟體鍵盤) 是否應在此 InteractiveObject 實體接收到焦點時顯示。 | InteractiveObject | ||
numChildren : int [唯讀]
傳回此物件的子系數量。 | DisplayObjectContainer | ||
opaqueBackground : Object
會指定顯示物件是否不透明,並具有特定背景顏色。 | DisplayObject | ||
parent : DisplayObjectContainer [唯讀]
指出包含此顯示物件的 DisplayObjectContainer 物件。 | DisplayObject | ||
restrict : String
會取得或設定字串,指出文字欄位對使用者輸入所能接受的字元。 | TextArea | ||
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 [覆寫]
會將目前組件的寬度乘以縮放比例係數。 | UIComponent | ||
scaleY : Number [覆寫]
會將目前組件的高度乘以縮放比例係數。 | UIComponent | ||
scaleZ : Number
指出從物件註冊點套用的物件深度縮放 (百分比)。 | DisplayObject | ||
scrollRect : Rectangle
顯示物件的捲動矩形範圍。 | DisplayObject | ||
selectionBeginIndex : int [唯讀]
會取得在一個或多個字元的選取範圍中,第一個選取字元的索引位置。 | TextArea | ||
selectionEndIndex : int [唯讀]
會取得在一個或多個字元的選取範圍中,最後一個選取字元的索引位置。 | TextArea | ||
softKeyboard : String
控制軟體鍵盤的外觀。 | InteractiveObject | ||
softKeyboardInputAreaOfInterest : Rectangle
定義顯示軟體鍵盤時,應保留於螢幕上的區域 (iOS 未提供)。 | InteractiveObject | ||
soundTransform : flash.media:SoundTransform
控制此 Sprite 的聲音。 | Sprite | ||
stage : Stage [唯讀]
顯示物件的「舞台」。 | DisplayObject | ||
tabChildren : Boolean
判斷物件的子系是否支援啟用定位鍵。 | DisplayObjectContainer | ||
tabEnabled : Boolean
會指定這個物件是否在停駐點順序中。 | InteractiveObject | ||
tabIndex : int
會指定 SWF 檔中的物件停駐點順序。 | InteractiveObject | ||
text : String
會取得或設定字串,此字串包含目前在 TextInput 組件中的文字。 | TextArea | ||
textField : flash.text:TextField
TextArea 組件內部文字欄位的參考。 | TextArea | ||
textHeight : Number [唯讀]
會以像素為單位,取得文字的高度。 | TextArea | ||
textSnapshot : flash.text:TextSnapshot [唯讀]
傳回此 DisplayObjectContainer 實體的 TextSnapshot 物件。 | DisplayObjectContainer | ||
textWidth : Number [唯讀]
會以像素為單位,取得文字的寬度。 | TextArea | ||
transform : flash.geom:Transform
這是一個物件,具有和顯示物件的矩陣、顏色轉換和像素邊界有關的屬性。 | DisplayObject | ||
useHandCursor : Boolean
指示當指標滑入 Sprite,且其 buttonMode 屬性設為 true 時,是否要出現指示手掌 (手掌游標) 的 Boolean 值。 | Sprite | ||
verticalScrollBar : UIScrollBar [唯讀]
會取得垂直捲軸的參考。 | TextArea | ||
verticalScrollPolicy : String
會取得或設定垂直捲軸的捲動原則。 | TextArea | ||
verticalScrollPosition : Number
會取得或設定使用者垂直捲動文字欄位之後,捲軸縮圖位置的變更 (以像素為單位)。 | TextArea | ||
visible : Boolean [覆寫]
會取得或設定值,指出目前組件實體是否為可見。 | UIComponent | ||
width : Number [覆寫]
會取得或設定組件的寬度,以像素為單位。 | UIComponent | ||
wordWrap : Boolean
會取得或設定 Boolean 值,指出文字是否會在行的結尾換行。 | TextArea | ||
x : Number [覆寫]
會取得或設定 x 座標,代表組件在其父輩容器內的 x 軸位置。 | UIComponent | ||
y : Number [覆寫]
會取得或設定 y 座標,代表組件在其父輩容器內的 y 軸位置。 | UIComponent | ||
z : Number
表示 DisplayObject 實體相對於 3D 父輩容器的 z 座標位置 (沿著 z 軸)。 | DisplayObject |
方法 | 定義自 | ||
---|---|---|---|
TextArea()
建立新的 TextArea 組件實體。 | TextArea | ||
將 DisplayObject 子實體加入至此 DisplayObjectContainer 實體。 | DisplayObjectContainer | ||
將 DisplayObject 子實體加入至此 DisplayObjectContainer 實體。 | DisplayObjectContainer | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
會在 EventDispatcher 物件註冊事件偵聽程式,以便讓偵聽程式收到事件的通知。 | EventDispatcher | ||
在 TextArea 組件包含的最後一個字元之後附加指定字串。 | TextArea | ||
指出安全性限制是否會造成傳回的清單 (可用指定的 point 點呼叫 DisplayObjectContainer.getObjectsUnderPoint() 方法來取得) 省略任何顯示物件。 | DisplayObjectContainer | ||
從此組件實體刪除某種樣式屬性。 | UIComponent | ||
判斷指定的顯示物件是否為 DisplayObjectContainer 實體的子系,或為實體本身。 | DisplayObjectContainer | ||
會將事件傳送到事件流程。 | EventDispatcher | ||
[覆寫]
會顯示或隱藏此組件上的焦點指示器。 | TextArea | ||
會起始立即繪製作業,而不需像 invalidateNow 一樣使所有項目無效化。 | UIComponent | ||
傳回可定義顯示物件區域 (相對於 targetCoordinateSpace 物件的座標系統) 的矩形。 | DisplayObject | ||
傳回存在於指定索引位置的子顯示物件實體。 | DisplayObjectContainer | ||
傳回具有指定名稱的子顯示物件。 | DisplayObjectContainer | ||
傳回 child DisplayObject 實體的索引位置。 | DisplayObjectContainer | ||
會擷取目前成為焦點的物件。 | UIComponent | ||
會擷取指定之文字行的相關資訊。 | TextArea | ||
傳回位於指定點底下,且屬於此 DisplayObjectContainer 實體之子系 (或孫系,以下類推) 的物件陣列。 | DisplayObjectContainer | ||
根據 targetCoordinateSpace 參數所定義的座標系統,並排除形狀上的任何筆畫,傳回可定義顯示物件邊界的矩形。 | DisplayObject | ||
會擷取在組件樣式查閱鏈中設定的樣式屬性。 | UIComponent | ||
[靜態]
會擷取目前組件的預設樣式對應。 | TextArea | ||
將 point 物件從「舞台」(全域) 座標轉換成顯示物件的 (區域) 座標。 | DisplayObject | ||
將二維點從「舞台」(全域) 座標轉換為三維顯示物件的 (區域) 座標。 | DisplayObject | ||
會檢查 EventDispatcher 物件是否有對特定的事件類型註冊偵聽程式。 | EventDispatcher | ||
指出物件是否有已定義的指定屬性。 | Object | ||
評估顯示物件的範圍框,看它是否與 obj 顯示物件的範圍框重疊或相交。 | DisplayObject | ||
評估顯示物件,看它是否與 x 和 y 參數所指定的點重疊或相交。 | DisplayObject | ||
會將屬性標示為無效,除非另有指定,否則會在下一個影格上重繪組件。 | UIComponent | ||
指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。 | Object | ||
將三維顯示物件的 (區域) 座標的三維點轉換為「舞台」(全域) 座標中的二維點。 | DisplayObject | ||
將 point 物件從顯示物件的 (區域) 座標轉換成「舞台」(全域) 座標。 | DisplayObject | ||
[靜態]
會將多種類別中的樣式合併為一個物件。 | UIComponent | ||
將組件移至其父輩內指定的位置。 | UIComponent | ||
指出指定的屬性是否存在,以及是否可列舉。 | Object | ||
將指定的 child DisplayObject 實體從 DisplayObjectContainer 實體的子清單中移除。 | DisplayObjectContainer | ||
從 DisplayObjectContainer 子清單中的指定索引位置移除子 DisplayObject。 | DisplayObjectContainer | ||
將所有 child DisplayObject 實體從 DisplayObjectContainer 實體的子清單中移除。 | DisplayObjectContainer | ||
會從 EventDispatcher 物件移除偵聽程式。 | EventDispatcher | ||
升起顯示虛擬鍵盤。 | InteractiveObject | ||
變更顯示物件容器中現有子系的位置。 | DisplayObjectContainer | ||
將焦點設定到此組件。 | UIComponent | ||
為迴圈作業設定動態屬性的可用性。 | Object | ||
會設定在成為焦點之文字區域內所選取的範圍。 | TextArea | ||
會將組件設定為指定的寬度和高度。 | UIComponent | ||
針對此組件實體設定樣式屬性。 | UIComponent | ||
讓使用者拖曳指定的 sprite。 | Sprite | ||
讓使用者將指定的 Sprite 拖曳至觸控裝置上。 | Sprite | ||
遞迴停止執行所有 MovieClips 的時間軸根源於此物件。 | DisplayObjectContainer | ||
結束 startDrag() 方法。 | Sprite | ||
結束觸控裝置使用的 startTouchDrag() 方法。 | Sprite | ||
替換兩個指定子物件的 z 順序 (深度階層,由前至後順序)。 | DisplayObjectContainer | ||
在子清單的兩個指定索引位置,替換子物件的 z 順序 (深度階層,由前至後順序)。 | DisplayObjectContainer | ||
傳回代表此物件的字串,根據地區特定慣例進行格式化。 | Object | ||
會傳回指定之物件的字串形式。 | Object | ||
會確認此物件之屬性和版面的有效性並加以更新,並在必要時重繪此物件。 | UIComponent | ||
會傳回指定之物件的基本值。 | Object | ||
檢查此 EventDispatcher 物件是否已註冊事件偵聽程式,或者此物件的任何祖系已為特定事件類型註冊事件偵聽程式。 | EventDispatcher |
事件 | 摘要 | 定義自 | ||
---|---|---|---|---|
[廣播事件] 當 Flash Player 或 AIR 應用程式取得作業系統焦點並成為作用中時傳送。 | EventDispatcher | |||
當顯示物件加入顯示清單中時傳送。 | DisplayObject | |||
會在顯示物件加入舞台上的顯示清單時,以直接或是透過加入包含該顯示物件之子樹狀結構的方式傳送。 | DisplayObject | |||
當透過使用者互動變更 TextArea 組件中的文字時傳送。 | TextArea | |||
當使用者從文字快顯選單中選取「清除」(或「刪除」) 時傳送。 | InteractiveObject | |||
會當使用者在相同的 InteractiveObject 上方按下並放開使用者的指向裝置主按鈕時傳送。 | InteractiveObject | |||
當使用者手勢在 AIR 應用程式中觸發與此互動式物件相關聯的快顯選單時傳送。 | InteractiveObject | |||
當使用者針對複製作業啟動平台特有的快速鍵組合或從文字快顯選單中選取「複製」時傳送。 | InteractiveObject | |||
當使用者針對剪下作業啟動平台特有的快速鍵組合或從文字快顯選單中選取「剪下」時傳送。 | InteractiveObject | |||
[廣播事件] 當 Flash Player 或 AIR 應用程式失去作業系統焦點並成為非作用中時傳送。 | EventDispatcher | |||
在 InteractiveObject 物件的 doubleClickEnabled 旗標設為 true 的情況下,當使用者在相同的物件上方連續兩次快速按下並放開指標裝置主要按鈕時傳送。 | InteractiveObject | |||
當使用者在組件內按下 Enter 鍵時傳送。 | TextArea | |||
[廣播事件] 當播放磁頭進入新影格時傳送。 | DisplayObject | |||
[廣播事件] 當播放磁頭結束目前影格時傳送。 | DisplayObject | |||
當顯示物件取得焦點之後傳送。 | InteractiveObject | |||
當顯示物件失去焦點時傳送。 | InteractiveObject | |||
[廣播事件] 在影格顯示物件的建構函式執行之後,且影格指令碼執行之前傳送。 | DisplayObject | |||
當使用者沿著觸控面與 InteractiveObject 實體建立接觸點 (例如沿著 Apple TV 的 Siri Remote 觸控面點選),某些裝置可能也會將此接觸解譯為數個觸控事件的組合。 | InteractiveObject | |||
當使用在觸控裝置上的同一個 InteractiveObject 實體上按下兩個接觸點後送出 (例如在行動電話或平板電腦觸控螢幕的顯示物件上方,以兩支手指按下後鬆開)。 | InteractiveObject | |||
當使用者在觸控裝置上,將接觸點移動到 InteractiveObject 實體上方後傳送 (例如,在行動電話或平板電腦觸控螢幕的顯示物件上,由左向右移動手指)。 | InteractiveObject | |||
當使用者在 InteractiveObject 實體的接觸點上做出旋轉手勢後傳送 (例如兩指觸摸行動電話或平板電腦的觸控螢幕,然後手指在顯示物件上旋轉)。 | InteractiveObject | |||
當使用者在與 InteractiveObject 實體的某個接觸點上做出揮動手勢後傳送 (例如,三指併在一起觸碰行動電話或平板電腦的觸控螢幕,然後在顯示物件上快速平行移動手指)。 | InteractiveObject | |||
當使用者與 InteractiveObject 實體建立接觸點,然後在觸控裝置上點一下後送出 (例如,將多根手指放到行動電話或平板電腦觸控螢幕的顯示物件上以開啟選單,然後其中一根手點一下,選取選單項目)。 | InteractiveObject | |||
當使用者在 InteractiveObject 實體的某個接觸點上做出放大縮小手勢後傳送 (例如兩指併在一起觸摸行動電話或平板電腦的觸控螢幕,然後手指在顯示物件上快速張開)。 | InteractiveObject | |||
在組件的可見性從可見變更為隱藏之後傳送。 | UIComponent | |||
這個事件會送出至任何支援 IME 內嵌輸入的用戶端應用程式。 | InteractiveObject | |||
會當使用者按下按鍵時傳送。 | InteractiveObject | |||
當使用者嘗試使用鍵盤瀏覽變更焦點時傳送。 | InteractiveObject | |||
會當使用者放開按鍵時傳送。 | InteractiveObject | |||
當使用者在相同的 InteractiveObject 上方按下並放開使用者的指向裝置中間按鈕時傳送。 | InteractiveObject | |||
當使用者將指向裝置的中間按鈕移至 InteractiveObject 實體上方按下時傳送。 | InteractiveObject | |||
當使用者將指向裝置按鈕移至 InteractiveObject 實體上方放開時傳送。 | InteractiveObject | |||
當使用者將指向裝置按鈕移至 InteractiveObject 實體上方按下時傳送。 | InteractiveObject | |||
會當使用者嘗試使用指向裝置變更焦點時傳送。 | InteractiveObject | |||
會當指向裝置停在 InteractiveObject 上方的情況下使用者將其移動時傳送。 | InteractiveObject | |||
會當使用者將指向裝置移開 InteractiveObject 實體時傳送。 | InteractiveObject | |||
會當使用者將指向裝置移至 InteractiveObject 實體上方時傳送。 | InteractiveObject | |||
當使用者將指向裝置按鈕移至 InteractiveObject 實體上方放開時傳送。 | InteractiveObject | |||
當滑鼠滾輪在 InteractiveObject 實體上方轉動時傳送。 | InteractiveObject | |||
在移動組件之後傳送。 | UIComponent | |||
當使用者釋放手勢時,由拖曳初始程式 InteractiveObject 傳送。 | InteractiveObject | |||
已在目標 InteractiveObject 上放下拖曳的物件,而且已呼叫 DragManager.acceptDragDrop() 接受該放開的資料時,由此目標 InteractiveObject 傳送。 | InteractiveObject | |||
當手勢進入 InteractiveObject 的邊界時,由此 InteractiveObject 傳送。 | InteractiveObject | |||
當手勢離開 InteractiveObject 的邊界時,由此 InteractiveObject 傳送。 | InteractiveObject | |||
當拖曳手勢還留在 InteractiveObject 的邊界內,由此 InteractiveObject 持續傳送。 | InteractiveObject | |||
在呼叫 DragManager.doDrag() 進行拖曳作業初期,由指定做為拖曳初始程式的 InteractiveObject 傳送。 | InteractiveObject | |||
在呼叫 DragManager.doDrag() 進行拖曳作業期間,由指定做為拖曳初始程式的 InteractiveObject 傳送。 | InteractiveObject | |||
當使用者針對貼上作業啟動平台特有的快速鍵組合或從文字快顯選單中選取「貼上」時傳送。 | InteractiveObject | |||
在使用者將作用中觸控筆往下移至超過螢幕鄰近偵測邊框時傳送。 | InteractiveObject | |||
在使用者將作用中觸控筆提到螢幕鄰近偵測邊框時傳送。 | InteractiveObject | |||
在使用者將作用中觸控筆移到螢幕上方,而其餘仍在鄰近偵測邊框內時傳送。 | InteractiveObject | |||
在使用者將作用中觸控筆移出這個 InteractiveObject 之外,而其餘仍在螢幕的鄰近偵測邊框內時傳送。 | InteractiveObject | |||
在使用者直接將作用中觸控筆移到這個 InteractiveObject 上方,而其餘仍在螢幕的鄰近偵測邊框內時傳送。 | InteractiveObject | |||
在使用者將作用中觸控筆移出這個 InteractiveObject 及其任一子系之外,而其餘仍在螢幕的鄰近偵測邊框內時傳送。 | InteractiveObject | |||
在使用者透過這個 InteractiveObject,從顯示清單中後代的物件樹狀結構之外移動作用中觸控筆時傳送 (而其餘仍在螢幕的鄰近偵測邊框內)。 | InteractiveObject | |||
當使用者第一次按下 InteractiveObject 實體上方的按鈕,然後將指向裝置滑出 InteractiveObject 實體之後即放開指向裝置上的按鈕時傳送。 | InteractiveObject | |||
會當顯示物件將要從顯示清單移除時傳送。 | DisplayObject | |||
會在顯示物件即將從顯示清單移除時,以直接或是透過移除包含該顯示物件之子樹狀結構的方式傳送。 | DisplayObject | |||
[廣播事件] 當顯示清單將要更新和顯示時傳送。 | DisplayObject | |||
在調整組件大小之後傳送。 | UIComponent | |||
當使用者在相同的 InteractiveObject 上方按下並放開使用者的指向裝置右邊按鈕時傳送。 | InteractiveObject | |||
當使用者將指向裝置按鈕移至 InteractiveObject 實體上方按下時傳送。 | InteractiveObject | |||
當使用者將指向裝置按鈕移至 InteractiveObject 實體上方放開時傳送。 | InteractiveObject | |||
會當使用者將指向裝置移開 InteractiveObject 實體時傳送。 | InteractiveObject | |||
會當使用者將指向裝置移至 InteractiveObject 實體上方時傳送。 | InteractiveObject | |||
當捲動內容時傳送。 | TextArea | |||
當使用者針對全選作業啟動平台特有的快速鍵組合或從文字快顯選單中選取「全選」時傳送。 | InteractiveObject | |||
在組件的可見性從隱藏變更為可見之後傳送。 | UIComponent | |||
升起顯示軟體鍵盤之後立即傳送。 | InteractiveObject | |||
升起顯示軟體鍵盤前立即傳送。 | InteractiveObject | |||
降下隱藏軟體鍵盤之後立即傳送。 | InteractiveObject | |||
在物件的 tabChildren 旗標值變更時傳送。 | InteractiveObject | |||
在物件的 tabEnabled 旗標變更時傳送。 | InteractiveObject | |||
在物件的 tabIndex 屬性值變更時傳送。 | InteractiveObject | |||
當使用者輸入、刪除或將文字貼入組件時傳送。 | TextArea | |||
當使用者在第一次接觸觸控裝置後傳送 (例如手指觸摸行動電話或平板電腦的觸控螢幕)。 | InteractiveObject | |||
當使用者在觸控裝置上移除接觸點後傳送 (例如在行動電話或平板電腦觸控螢幕上移開手指)。 | InteractiveObject | |||
當使用者觸控裝置時傳送,並且連續不斷地傳送,直到接觸點移除為止。 | InteractiveObject | |||
當使用者在觸控裝置中,將接觸點移出 InteractiveObject 實體後送出 (例如在行動電話或平板電腦的觸控螢幕上,將手指從顯示物件移至另一個顯示物件)。 | InteractiveObject | |||
當使用者在觸控裝置中將接觸點移至 InteractiveObject 實體上方後送出 (例如在行動電話或平板電腦的觸控螢幕上,將手指從顯示物件外面的某一點,往顯示物件上方拖曳)。 | InteractiveObject | |||
當使用者在觸控裝置上,將接觸點從 InteractiveObject 實體移出後送出 (例如,在行動電話或平板電腦的觸控螢幕上,將手指從顯示物件上方拖曳到顯示物件以外)。 | InteractiveObject | |||
當使用者在觸控裝置中將接觸點移至 InteractiveObject 實體上方後送出 (例如在行動電話或平板電腦的觸控螢幕上,將手指從顯示物件外面的某一點,往顯示物件上方拖曳)。 | InteractiveObject | |||
當使用者在觸控裝置的同一個 InteractiveObject 實體上,在原先開始接觸點放開後送出 (例如在行動電話或平板電腦觸控螢幕上的顯示物件上方,以手指按下某個點後又鬆開)。 | InteractiveObject |
樣式可分為一般樣式及與特定主題關聯的樣式兩種。如果是一般樣式,可以與任何主題搭配使用。如果是與特定主題關聯的樣式,只有在您的應用程式使用特定主題時才能使用該樣式。
樣式 | 說明 | 定義自 | ||
---|---|---|---|---|
disabledSkin | 類型: Class 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 當 TextArea 組件的 enabled 屬性是設為 false 時,用於提供此組件背景的類別。
預設值為 TextArea_disabledSkin 。 | TextArea | ||
類型: flash.text.TextFormat 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 當按鈕停用時用來繪製組件標籤的 TextFormat 物件. | UIComponent | |||
embedFonts | 類型: Boolean 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 指出是否要使用內嵌的字體外框來呈現文字欄位。 如果這個值為 true ,Flash Player 會使用內嵌的字體外框來呈現文字欄位。 如果這個值為 false ,Flash Player 會使用預設字體來呈現文字欄位。
如果您將文字欄位的 false 。 | TextArea | ||
類型: Number 格式: Length 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 分開組件外邊框與焦點指示器的外邊緣的邊框 (以像素計). | UIComponent | |||
類型: Class 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 用來顯示焦點指示器的外觀元素. | UIComponent | |||
類型: flash.text.TextFormat 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 用來繪製組件標籤的 TextFormat 物件. | UIComponent | |||
textPadding | 類型: Number 格式: Length 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 用於讓組件邊框和文字保持一段距離的邊框距離,以像素為單位。 預設值為 3 。 | TextArea | ||
upSkin | 類型: Class 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 用於提供 TextArea 組件背景的類別。 預設值為 TextArea_upSkin 。 | TextArea |
alwaysShowSelection | 屬性 |
alwaysShowSelection:Boolean
語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會取得或設定 Boolean 值,指出當文字欄位未成為焦點時,Flash Player 是否反白標示文字欄位中的選取範圍。 如果這個值設定為 true
,而且文字欄位並非焦點,則 Flash Player 會將選取範圍反白標示為灰色。 如果這個值設定為 false
,而且文字欄位並非焦點,則 Flash Player 不會反白標示選取範圍。
預設值為 false。
實作
public function get alwaysShowSelection():Boolean
public function set alwaysShowSelection(value:Boolean):void
相關 API 元素
condenseWhite | 屬性 |
condenseWhite:Boolean
語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會取得或設定 Boolean 值,指出是否從含有 HTML 文字的 TextArea 組件移除額外的空白字元。 組件中額外空白字元的範例包括空白和斷行符號。 值為 true
表示移除額外的空白字元;值為 false
則表示不移除額外的空白字元。
此屬性只會影響使用 htmlText
屬性設定的文字;而不會影響使用 text
屬性設定的文字。 如果您使用 text
屬性來設定文字,則 condenseWhite
屬性會遭到忽略。
如果將 condenseWhite
設定為 true
,則必須使用標準的 HTML 命令 (如 <br> 和 <p>),才能將斷行符號放置在文字欄位中。
預設值為 false。
實作
public function get condenseWhite():Boolean
public function set condenseWhite(value:Boolean):void
相關 API 元素
範例 ( 如何使用本範例 )
condenseWhite
屬性:
import fl.controls.CheckBox; import fl.controls.ScrollPolicy; import fl.controls.TextArea; var str:String; var plainTextArea:TextArea = new TextArea(); plainTextArea.verticalScrollPolicy = ScrollPolicy.ON; plainTextArea.setSize(260, 360); plainTextArea.move(10, 10); addChild(plainTextArea); var htmlTextArea:TextArea = new TextArea(); htmlTextArea.verticalScrollPolicy = ScrollPolicy.ON; htmlTextArea.condenseWhite = true; htmlTextArea.setSize(260, 360); htmlTextArea.move(280, 10); addChild(htmlTextArea); var condenseCheckBox:CheckBox = new CheckBox(); condenseCheckBox.textField.autoSize = TextFieldAutoSize.LEFT; condenseCheckBox.label = "condenseWhite:"; condenseCheckBox.selected = htmlTextArea.condenseWhite; condenseCheckBox.move(htmlTextArea.x, htmlTextArea.y + htmlTextArea.height); condenseCheckBox.addEventListener(MouseEvent.CLICK, clickHandler); addChild(condenseCheckBox); var urlLdr:URLLoader = new URLLoader(); urlLdr.addEventListener(Event.COMPLETE, completeHandler); urlLdr.dataFormat = URLLoaderDataFormat.TEXT; urlLdr.load(new URLRequest("http://www.helpexamples.com/flash/lorem.html")); function completeHandler(event:Event):void { str = event.target.data as String; plainTextArea.text = str; htmlTextArea.htmlText = str; } function clickHandler(event:MouseEvent):void { var sel:Boolean = event.currentTarget.selected; htmlTextArea.condenseWhite = sel; htmlTextArea.htmlText = str; }
displayAsPassword | 屬性 |
displayAsPassword:Boolean
語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會取得或設定 Boolean 值,指出 TextArea 組件實體是否為密碼的文字欄位。 值為 true
表示目前實體為了包含密碼而建立的;值為 false
則不是。
如果此屬性的值為 true
,則無法看到使用者在文字區域中輸入的字元, 而是顯示星號以取代使用者輸入的每一個字元。 此外,還會停用「剪下」和「複製」命令及其鍵盤快速鍵,以防止他人在電腦無人看管的情況下取得密碼。
預設值為 false。
實作
public function get displayAsPassword():Boolean
public function set displayAsPassword(value:Boolean):void
editable | 屬性 |
enabled | 屬性 |
enabled:Boolean
[覆寫] 語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會取得或設定值,指出組件是否可以接受使用者互動。 值為 true
表示組件可以接受使用者互動;值為 false
則表示不可以。
如果將 enabled
屬性設定為 false
,則容器的顏色會變成灰色,而且使用者無法輸入 (但 Label 和 ProgressBar 組件除外)。
實作
override public function get enabled():Boolean
override public function set enabled(value:Boolean):void
horizontalScrollBar | 屬性 |
horizontalScrollBar:UIScrollBar
[唯讀] 語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會取得水平捲軸的參考。
實作
public function get horizontalScrollBar():UIScrollBar
相關 API 元素
horizontalScrollPolicy | 屬性 |
horizontalScrollPolicy:String
語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會取得或設定水平捲軸的捲動原則。 這可以是下列其中一個值:
- ScrollPolicy.ON:永遠啟用捲軸。
- ScrollPolicy.OFF:永遠關閉捲軸。
- ScrollPolicy.AUTO:在需要時啟用捲軸。
預設值為 ScrollPolicy.AUTO。
實作
public function get horizontalScrollPolicy():String
public function set horizontalScrollPolicy(value:String):void
相關 API 元素
範例 ( 如何使用本範例 )
horizontalScrollPolicy
屬性設定為 ScrollPolicy.ON
,因此不論文字區域目前有多少內容,水平捲軸將永遠為可見:
import fl.controls.TextArea; import fl.controls.ScrollPolicy; var myTextArea:TextArea = new TextArea(); myTextArea.wordWrap = false; myTextArea.horizontalScrollPolicy = ScrollPolicy.ON; myTextArea.text = "The quick brown fox jumped over the lazy dog."; myTextArea.setSize(320, 120); myTextArea.move(10, 10); addChild(myTextArea);
horizontalScrollPosition | 屬性 |
horizontalScrollPosition:Number
語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會取得或設定使用者水平捲動文字欄位之後,捲軸縮圖位置的變更 (以像素為單位)。 如果這個值是 0,表示並未水平捲動文字欄位。
預設值為 0。
實作
public function get horizontalScrollPosition():Number
public function set horizontalScrollPosition(value:Number):void
相關 API 元素
htmlText | 屬性 |
htmlText:String
語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會取得或設定文字欄位所含字串的 HTML 表示形式。
預設值為 ""。
實作
public function get htmlText():String
public function set htmlText(value:String):void
相關 API 元素
範例 ( 如何使用本範例 )
import fl.controls.TextArea; var myText:String = ""; myText += "<p>You can use the <b> tag to create <b>bold</b> text.</p>"; myText += "<p>You can use the <i> tag to create <i>italic</i> text.</p>"; myText += "<p>You can use the <u> tag to create <u>underlined</a> text.</p>"; myText += "<p>You can use the <a> tag to create <a href='http://www.adobe.com'>links to other sites</a>.</p>"; myText += "<p>You can use the <br> tag to create<br>new lines of text<br>whenever you want.</p>"; myText += "<p>You can use the <font> tag to specificy different font <font color='#FF0000'>colors</font>, <font size='16'>sizes</font>, or <font face='Times New Roman'>faces</font>.</p>"; myText += "<p>You can use the <img> tag to load images or SWF files:<br><img src='http://www.helpexamples.com/flash/images/logo.png'>.</p>"; var myTextArea:TextArea = new TextArea(); myTextArea.htmlText = myText; myTextArea.setSize(320, 240); myTextArea.move(10, 10); addChild(myTextArea);
import fl.controls.TextArea; var str:String = "<p>Check out the following links:</p>"; str += "<li><a href=\"event:flash\"><u>Flash</u></a></li>"; str += "<li><a href=\"event:flex\"><u>Flex</u></a></li>"; str += "<li><a href=\"event:devnet\"><u>Developer Center</u></a></li>"; var myTextArea:TextArea = new TextArea(); myTextArea.htmlText += str; myTextArea.setSize(320, 120); myTextArea.move(10, 10); myTextArea.addEventListener(TextEvent.LINK, linkHandler); addChild(myTextArea); function linkHandler(event:TextEvent):void { var url:String = "http://www.adobe.com/go/" + event.text; var urlReq:URLRequest = new URLRequest(url); navigateToURL(urlReq); }
imeMode | 屬性 |
imeMode:String
語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會取得或設定輸入法編輯器 (IME) 的模式。 IME 可讓使用者使用 QWERTY 鍵盤,輸入中文、日文及韓文字元集中的字元。
Flash 會在組件成為焦點時,將 IME 設定為指定的模式,並在組件失去焦點之後,再將其還原為原始值。
flash.system.IMEConversionMode 類別會定義常數,做為此屬性的有效值。 您可以將此屬性設定為 null
,以避免搭配組件使用 IME。
實作
public function get imeMode():String
public function set imeMode(value:String):void
相關 API 元素
length | 屬性 |
maxChars | 屬性 |
maxChars:int
語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會取得或設定使用者最多可在文字欄位中輸入的字元數。
預設值為 0。
實作
public function get maxChars():int
public function set maxChars(value:int):void
相關 API 元素
範例 ( 如何使用本範例 )
maxChars
屬性以限制可在文字區域中輸入的文字數量:
import fl.controls.Label; import fl.controls.TextArea; var myTextArea:TextArea = new TextArea(); myTextArea.maxChars = 500; myTextArea.setSize(320, 240); myTextArea.move(10, 10); myTextArea.addEventListener(TextEvent.TEXT_INPUT, textInputHandler); addChild(myTextArea); var charCountLabel:Label = new Label(); charCountLabel.autoSize = TextFieldAutoSize.LEFT; charCountLabel.move(myTextArea.x, myTextArea.y + myTextArea.height); addChild(charCountLabel); charCountLabel.text = myTextArea.length + " of " + myTextArea.maxChars; function textInputHandler(event:TextEvent):void { updateCount(); } function updateCount():void { charCountLabel.text = myTextArea.length + " of " + myTextArea.maxChars; }
maxHorizontalScrollPosition | 屬性 |
maxVerticalScrollPosition | 屬性 |
restrict | 屬性 |
restrict:String
語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會取得或設定字串,指出文字欄位對使用者輸入所能接受的字元。
請注意,如果是以程式設計的方式輸入字元,即使這些字元不在此字串中,文字欄位也會接受。
字串中字元的讀取順序是由左至右。 您可以使用連字符號 (-) 字元指定字元範圍。
如果此屬性的值為 null
,則文字欄位會接受所有字元。 如果將此屬性設定為空字串 (""),則文字欄位便不接受任何字元。
如果字串以跳脫字元 (^) 開始,在初始時便會接受所有的字元,字串中的後續字元則會排除在接受的字元組之外。 如果該字串不是以跳脫字元 (^) 開始,在初始時便不會接受任何字元,並且字串中的後續字元都會包含在接受的字元組內。
預設值為 null。
實作
public function get restrict():String
public function set restrict(value:String):void
相關 API 元素
selectionBeginIndex | 屬性 |
selectionEndIndex | 屬性 |
text | 屬性 |
textField | 屬性 |
public var textField:flash.text:TextField
語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
TextArea 組件內部文字欄位的參考。
textHeight | 屬性 |
textHeight:Number
[唯讀] 語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會以像素為單位,取得文字的高度。
預設值為 0。
實作
public function get textHeight():Number
相關 API 元素
範例 ( 如何使用本範例 )
change
事件時,顯示 textWidth
和 textHeight
屬性:
import fl.controls.Label; import fl.controls.TextArea; var myTextArea:TextArea = new TextArea() myTextArea.setSize(320, 240); myTextArea.move(10, 10); myTextArea.addEventListener(Event.CHANGE, changeHandler); addChild(myTextArea); var widthLabel:Label = new Label(); widthLabel.autoSize = TextFieldAutoSize.LEFT; widthLabel.text = "textWidth: " + myTextArea.textWidth; widthLabel.move(340, 10); addChild(widthLabel); var heightLabel:Label = new Label(); heightLabel.autoSize = TextFieldAutoSize.LEFT; heightLabel.text = "textHeight: " + myTextArea.textHeight; heightLabel.move(340, 30); addChild(heightLabel); function changeHandler(event:Event):void { widthLabel.text = "textWidth: " + myTextArea.textWidth; heightLabel.text = "textHeight: " + myTextArea.textHeight; }
textWidth | 屬性 |
textWidth:Number
[唯讀] 語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會以像素為單位,取得文字的寬度。
預設值為 0。
實作
public function get textWidth():Number
相關 API 元素
範例 ( 如何使用本範例 )
change
事件時,顯示 textWidth
和 textHeight
屬性:
import fl.controls.Label; import fl.controls.TextArea; var myTextArea:TextArea = new TextArea() myTextArea.setSize(320, 240); myTextArea.move(10, 10); myTextArea.addEventListener(Event.CHANGE, changeHandler); addChild(myTextArea); var widthLabel:Label = new Label(); widthLabel.autoSize = TextFieldAutoSize.LEFT; widthLabel.text = "textWidth: " + myTextArea.textWidth; widthLabel.move(340, 10); addChild(widthLabel); var heightLabel:Label = new Label(); heightLabel.autoSize = TextFieldAutoSize.LEFT; heightLabel.text = "textHeight: " + myTextArea.textHeight; heightLabel.move(340, 30); addChild(heightLabel); function changeHandler(event:Event):void { widthLabel.text = "textWidth: " + myTextArea.textWidth; heightLabel.text = "textHeight: " + myTextArea.textHeight; }
verticalScrollBar | 屬性 |
verticalScrollBar:UIScrollBar
[唯讀] 語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會取得垂直捲軸的參考。
實作
public function get verticalScrollBar():UIScrollBar
相關 API 元素
範例 ( 如何使用本範例 )
pageSize
屬性:
import fl.controls.TextArea; import fl.events.ScrollEvent; var myTextArea:TextArea = new TextArea(); myTextArea.setSize(160, 120); myTextArea.move(10, 10); myTextArea.verticalScrollBar.pageSize = 1; myTextArea.addEventListener(ScrollEvent.SCROLL, scrollHandler); addChild(myTextArea); var myURLLoader:URLLoader = new URLLoader(); myURLLoader.addEventListener(Event.COMPLETE, completeHandler); myURLLoader.load(new URLRequest("http://www.helpexamples.com/flash/lorem.txt")); function scrollHandler(event:ScrollEvent):void { trace("scroll: " + myTextArea.verticalScrollPosition + " of " + myTextArea.maxVerticalScrollPosition); } function completeHandler(event:Event):void { var txt:String = URLLoader(event.currentTarget).data as String; myTextArea.text = txt; }
verticalScrollPolicy | 屬性 |
verticalScrollPolicy:String
語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會取得或設定垂直捲軸的捲動原則。 這可以是下列其中一個值:
- ScrollPolicy.ON:永遠啟用捲軸。
- ScrollPolicy.OFF:永遠關閉捲軸。
- ScrollPolicy.AUTO:在需要時啟用捲軸。
預設值為 ScrollPolicy.AUTO。
實作
public function get verticalScrollPolicy():String
public function set verticalScrollPolicy(value:String):void
相關 API 元素
範例 ( 如何使用本範例 )
verticalScrollPolicy
屬性設定為 ScrollPolicy.ON
,因此不論文字區域目前有多少內容,垂直捲軸將永遠為可見:
import fl.controls.TextArea; import fl.controls.ScrollPolicy; var myTextArea:TextArea = new TextArea(); myTextArea.verticalScrollPolicy = ScrollPolicy.ON; myTextArea.text = "The quick brown fox jumped over the lazy dog."; myTextArea.setSize(160, 120); myTextArea.move(10, 10); addChild(myTextArea);
verticalScrollPosition | 屬性 |
verticalScrollPosition:Number
語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會取得或設定使用者垂直捲動文字欄位之後,捲軸縮圖位置的變更 (以像素為單位)。 如果這個值是 1,表示並未垂直捲動文字欄位。
預設值為 1。
實作
public function get verticalScrollPosition():Number
public function set verticalScrollPosition(value:Number):void
相關 API 元素
範例 ( 如何使用本範例 )
import fl.controls.ScrollPolicy; import fl.controls.Slider; import fl.controls.SliderDirection import fl.controls.TextArea; import fl.events.ScrollEvent; import fl.events.SliderEvent; var myTextArea:TextArea = new TextArea(); myTextArea.horizontalScrollPolicy = ScrollPolicy.OFF; myTextArea.verticalScrollPolicy = ScrollPolicy.OFF; myTextArea.setSize(320, 240); myTextArea.move(10, 10); myTextArea.addEventListener(ScrollEvent.SCROLL, scrollHandler); addChild(myTextArea) var mySlider:Slider = new Slider(); mySlider.liveDragging = true; mySlider.snapInterval = 1; mySlider.tickInterval = 1; mySlider.width = myTextArea.width; mySlider.move(myTextArea.x, myTextArea.y + myTextArea.height + 10); var urlLdr:URLLoader = new URLLoader(); urlLdr.addEventListener(Event.COMPLETE, completeHandler); urlLdr.dataFormat = URLLoaderDataFormat.TEXT; urlLdr.load(new URLRequest("http://www.helpexamples.com/flash/text/lorem.txt")); function completeHandler(event:Event):void { var txt:String = event.target.data as String; myTextArea.text = txt; myTextArea.drawNow(); mySlider.minimum = myTextArea.verticalScrollPosition; mySlider.maximum = myTextArea.maxVerticalScrollPosition; mySlider.addEventListener(SliderEvent.CHANGE, changeHandler); addChild(mySlider); } function scrollHandler(event:ScrollEvent):void { trace("scrolled:"); mySlider.value = event.position; } function changeHandler(event:SliderEvent):void { trace("changed:"); myTextArea.verticalScrollPosition = event.value; }
wordWrap | 屬性 |
TextArea | () | 建構函式 |
public function TextArea()
語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
建立新的 TextArea 組件實體。
appendText | () | 方法 |
drawFocus | () | 方法 |
getLineMetrics | () | 方法 |
public function getLineMetrics(lineIndex:int):flash.text:TextLineMetrics
語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會擷取指定之文字行的相關資訊。
參數
lineIndex:int — 要擷取其資訊的行號。
|
flash.text:TextLineMetrics |
getStyleDefinition | () | 方法 |
public static function getStyleDefinition():Object
語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會擷取目前組件的預設樣式對應。 視組件使用的樣式而定,樣式對應會包含適用於組件的類型。 例如,disabledTextFormat
樣式會包含 null
值或 TextFormat 物件。 您可以使用這些樣式,並針對目前的組件呼叫 setStyle()
。 下列程式碼會覆寫指定組件上預設的 disabledTextFormat
樣式:
componentInstance.setStyle("disabledTextFormat", new TextFormat());
Object — 預設的樣式物件。
|
相關 API 元素
範例 ( 如何使用本範例 )
import fl.controls.*; import fl.containers.*; import fl.controls.listClasses.*; import fl.controls.dataGridClasses.*; import fl.controls.progressBarClasses.*; import fl.core.UIComponent; import fl.data.DataProvider; var dp:DataProvider = new DataProvider(); dp.addItem( { label: "BaseScrollPane", data:BaseScrollPane } ); dp.addItem( { label: "Button", data:Button } ); dp.addItem( { label: "CellRenderer", data:CellRenderer } ); dp.addItem( { label: "CheckBox", data:CheckBox } ); dp.addItem( { label: "ColorPicker", data:ColorPicker } ); dp.addItem( { label: "ComboBox", data:ComboBox } ); dp.addItem( { label: "DataGrid", data:DataGrid } ); dp.addItem( { label: "HeaderRenderer", data:HeaderRenderer } ); dp.addItem( { label: "ImageCell", data:ImageCell } ); dp.addItem( { label: "IndeterminateBar",data:IndeterminateBar } ); dp.addItem( { label: "Label", data:Label } ); dp.addItem( { label: "List", data:List } ); dp.addItem( { label: "NumericStepper", data:NumericStepper } ); dp.addItem( { label: "ProgressBar", data:ProgressBar } ); dp.addItem( { label: "RadioButton", data:RadioButton } ); dp.addItem( { label: "ScrollPane", data:ScrollPane } ); dp.addItem( { label: "Slider", data:Slider } ); dp.addItem( { label: "TextArea", data:TextArea } ); dp.addItem( { label: "TextInput", data:TextInput } ); dp.addItem( { label: "TileList", data:TileList } ); dp.addItem( { label: "UILoader", data:UILoader } ); dp.addItem( { label: "UIComponent", data:UIComponent } ); var cb:ComboBox = new ComboBox(); cb.move(10,10); cb.setSize(300,25); cb.prompt = "Select a component to view its styles"; cb.rowCount = 12; cb.dataProvider = dp; cb.addEventListener(Event.CHANGE, showStyleDefinition); addChild(cb); var dg:DataGrid = new DataGrid(); dg.setSize(425,300); dg.move(10,50); dg.columns = [ new DataGridColumn("StyleName"), new DataGridColumn("DefaultValue") ]; addChild(dg); function showStyleDefinition(e:Event):void { var componentClass:Class = e.target.selectedItem.data as Class; var styles:Object = componentClass["getStyleDefinition"].call(this); trace(styles.toString()); var styleData:DataProvider = new DataProvider(); for(var i:* in styles) { trace(i + " : " + styles[i]); styleData.addItem( { StyleName:i, DefaultValue:styles[i] } ); } styleData.sortOn("StyleName"); dg.dataProvider = styleData; }
setSelection | () | 方法 |
public function setSelection(setSelection:int, endIndex:int):void
語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會設定在成為焦點之文字區域內所選取的範圍。 選取範圍是從 start 參數指定的索引起始,而在 end 參數指定的索引結束。 選取的文字視同從零開始的字元字串,其中的第一個選取字元位於索引 0、第二字元位於索引 1,依此類推。
如果文字欄位未成為焦點,此方法即無效果。
參數
setSelection:int — 選取範圍中第一個字元的索引位置。
| |
endIndex:int — 選取範圍中最後一個字元的索引位置。
|
change | 事件 |
flash.events.Event
屬性 Event.type =
flash.events.Event.CHANGE
語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
當透過使用者互動變更 TextArea 組件中的文字時傳送。當 ActionScript 程式碼變更組件時,不會傳送此事件。
Event.CHANGE
常數會定義 change
事件物件的 type
屬性值。
這個事件具有下列屬性:
屬性 | 值 |
---|---|
bubbles | true |
cancelable | false ;沒有要取消的預設行為指令。 |
currentTarget | 正主動使用事件偵聽程式處理 Event 物件的物件。 |
target | 其值遭到修改的物件。 target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。 |
enter | 事件 |
fl.events.ComponentEvent
屬性 ComponentEvent.type =
fl.events.ComponentEvent.ENTER
語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
當使用者在組件內按下 Enter 鍵時傳送。
會定義enter
事件物件的 type
屬性值。
這個事件具有下列屬性:
屬性 | 值 |
---|---|
bubbles | false |
cancelable | false ;沒有要取消的預設行為指令。 |
currentTarget | 正主動使用事件偵聽程式處理 Event 物件的物件。 |
target | 已經傳送該事件的物件。 此目標不一定是偵聽該事件的物件。 您可以使用 currentTarget 屬性,存取目前正在偵聽該事件的物件。 |
scroll | 事件 |
fl.events.ScrollEvent
屬性 ScrollEvent.type =
fl.events.ScrollEvent.SCROLL
語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
當捲動內容時傳送。
定義scroll
事件物件的 type
屬性值。
這個事件具有下列屬性:
屬性 | 值 |
---|---|
bubbles | false |
cancelable | false ;沒有要取消的預設行為指令。 |
currentTarget | 正主動使用事件偵聽程式處理 Event 物件的物件。 |
delta | 1 ,指出捲動了多少距離的值。
|
direction | vertical ,ScrollBar 的方向。 |
position | 0 ,捲軸縮圖移動後所在的位置。 |
target | 已經傳送該事件的物件。 此目標不一定是偵聽該事件的物件。 您可以使用 currentTarget 屬性,存取目前正在偵聽該事件的物件。 |
範例 ( 如何使用本範例 )
import fl.controls.ScrollBarDirection; import fl.controls.TextArea; import fl.events.ScrollEvent; var myTextArea:TextArea = new TextArea(); myTextArea.setSize(320, 240); myTextArea.move(10, 10); myTextArea.addEventListener(ScrollEvent.SCROLL, scrollHandler); addChild(myTextArea); var urlLdr:URLLoader = new URLLoader(); urlLdr.addEventListener(Event.COMPLETE, completeHandler); urlLdr.dataFormat = URLLoaderDataFormat.TEXT; urlLdr.load(new URLRequest("http://www.helpexamples.com/flash/text/lorem.txt")); function completeHandler(event:Event):void { var txt:String = event.target.data as String; myTextArea.text = txt; } function scrollHandler(event:ScrollEvent):void { var myTA:TextArea = event.currentTarget as TextArea; var pos:Number = event.position; var maxPos:Number; if (event.direction == ScrollBarDirection.VERTICAL) { maxPos = myTA.maxVerticalScrollPosition; } else { maxPos = myTA.maxHorizontalScrollPosition; } trace("scroll: " + event.direction + " (" + pos.toFixed(2) + " of " + maxPos + ")"); }
textInput | 事件 |
flash.events.TextEvent
屬性 TextEvent.type =
flash.events.TextEvent.TEXT_INPUT
語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
當使用者輸入、刪除或將文字貼入組件時傳送。
定義textInput
事件物件的 type
屬性值。
注意:Delete 或 Backspace 鍵不會傳送這個事件。
這個事件具有下列屬性:
屬性 | 值 |
---|---|
bubbles | true |
cancelable | true ;呼叫 preventDefault() 方法來取消預設行為指令。 |
currentTarget | 正主動使用事件偵聽程式處理 Event 物件的物件。 |
target | 正在其中輸入字元的文字欄位。 這個 target 並非永遠都是註冊事件偵聽程式之顯示清單中的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。 |
text | 由使用者所輸入的字元或字元序列。 |
- 將 TextArea 組件拖曳至舞台,並將它命名為
ta1
。 - 將 TextArea 組件拖曳至舞台,並將它命名為
ta2
。 - 將這個程式碼儲存成 TextAreaExample.as,並與您的 FLA 存放在相同的目錄中。
- 將 FLA 中的 DocumentClass 設定為 TextAreaExample。
package { import flash.display.Sprite; import flash.events.Event; import flash.events.TextEvent; import flash.text.TextField; import fl.events.ComponentEvent; import fl.controls.TextArea; public class TextAreaExample extends Sprite { private var testString:String = 'Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Vivamus quis nisl vel tortor nonummy vulputate. Quisque sit amet eros sed purus euismod tempor. Morbi tempor. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos hymenaeos. Curabitur diam. Suspendisse at purus in ipsum volutpat viverra. Nulla pellentesque libero id libero. Proin pretium suscipit lectus. Donec in sapien vel nulla egestas semper. Mauris massa. In aliquet sem ac libero. In eget orci. Sed feugiat. Vestibulum vel felis in lectus imperdiet scelerisque. Vestibulum vestibulum neque at est. Etiam purus quam, laoreet quis, accumsan sed, porttitor ut, erat. Proin volutpat. In facilisis dolor gravida felis. Curabitur nisi lacus, euismod non, pharetra et, mollis a, tellus. Donec lectus orci, viverra at, luctus ac, sodales id, quam. Phasellus faucibus lacus ut est. Curabitur id diam eu massa bibendum lobortis. Vivamus quis elit. Donec mi justo, dictum vitae, cursus sit amet, lacinia consectetuer, d ut, vulputate sed, molestie et, arcu. Nullam mi.'; private var testStringHTML:String = 'This is <font color="#FF0000">HTML text</font> in a <b>TextArea control</b>. Use the <u>htmlText property</u> of the <font color="#008800">TextArea control</font> to include basic HTML markup in your text.'; public function TextAreaExample() { ta1.text = testString; ta2.htmlText = testStringHTML; configureListeners(ta1); configureListeners(ta2); } private function configureListeners(ta:TextArea):void { ta.addEventListener(TextEvent.TEXT_INPUT,announceEvent); ta.addEventListener(Event.CHANGE,announceEvent); ta.addEventListener(ComponentEvent.ENTER,announceEvent); ta.addEventListener(Event.SCROLL,announceEvent); } private function announceEvent(e:Event):void { trace(e.toString()); } } }
Tue Jun 12 2018, 03:47 PM Z