套件 | fl.controls |
類別 | public class TextInput |
繼承 | TextInput UIComponent Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
實作 | IFocusManagerComponent |
子類別 | DataGridCellEditor |
語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
您可以在應用程式中啟用或停用 TextInput 組件。 停用 TextInput 組件時,它無法接收來自滑鼠或鍵盤的輸入。 啟用的 TextInput 組件像 ActionScript TextField 物件一樣,可以實作焦點、選取和導覽。
您可以使用樣式來自訂 TextInput 組件。例如,變更它在停用時的外觀。 某些可套用至此組件的其他自訂方式,也包括利用 HTML 加以格式化,或是將它設定為必須隱藏文字的密碼欄位。
相關 API 元素
屬性 | 定義自 | ||
---|---|---|---|
accessibilityImplementation : AccessibilityImplementation
對此 InteractiveObject 實體目前的輔助功能實作 (AccessibilityImplementation)。 | InteractiveObject | ||
accessibilityProperties : AccessibilityProperties
此顯示物件的目前輔助功能選項。 | DisplayObject | ||
alpha : Number
指出所指定物件的 Alpha 透明度值。 | DisplayObject | ||
alwaysShowSelection : Boolean
會取得或設定 Boolean 值,指出當文字欄位未成為焦點時,顯示選取範圍的方式。 | TextInput | ||
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 文字的 TextInput 組件移除額外的空白字元。 | TextInput | ||
constructor : Object
類別物件的參照或是特定物件實體的建構函數。 | Object | ||
contextMenu : NativeMenu
指定與此物件有關聯的快顯選單。 | InteractiveObject | ||
displayAsPassword : Boolean
會取得或設定 Boolean 值,指出目前 TextInput 組件實體是為了包含密碼,或為了包含文字而建立。 | TextInput | ||
doubleClickEnabled : Boolean
會指定物件是否會收到 doubleClick 事件。 | InteractiveObject | ||
dropTarget : DisplayObject [唯讀]
指定要將 sprite 拖曳至或丟棄至哪個顯示物件上。 | Sprite | ||
editable : Boolean
會取得或設定 Boolean 值,指出文字欄位是否可由使用者編輯。 | TextInput | ||
enabled : Boolean [覆寫]
會取得或設定值,指出組件是否可以接受使用者互動。 | TextInput | ||
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 | ||
horizontalScrollPosition : int
會取得或設定水平捲軸的縮圖位置。 | TextInput | ||
htmlText : String
會包括文字欄位所含字串的 HTML 表示形式。 | TextInput | ||
imeMode : String
會取得或設定輸入法編輯器 (IME) 的模式。 | TextInput | ||
length : int [唯讀]
會取得 TextInput 組件中的字元數。 | TextInput | ||
loaderInfo : LoaderInfo [唯讀]
會傳回 LoaderInfo 物件,其中包含關於載入此顯示物件所屬之檔案的資訊。 | DisplayObject | ||
mask : DisplayObject
呼叫之顯示物件會以指定的 mask 物件遮蓋。 | DisplayObject | ||
maxChars : int
會取得或設定使用者最多可在文字欄位中輸入的字元數。 | TextInput | ||
maxHorizontalScrollPosition : int [唯讀]
會取得值,說明在文字欄位中向右捲動最遠可達到的位置。 | TextInput | ||
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
會取得或設定字串,指出文字欄位對使用者輸入所能接受的字元。 | TextInput | ||
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 [唯讀]
會取得在一個或多個字元的選取範圍中,第一個選取字元的索引值。 | TextInput | ||
selectionEndIndex : int [唯讀]
會取得在一個或多個字元的選取範圍中,最後一個選取字元的索引位置。 | TextInput | ||
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 組件中的文字。 | TextInput | ||
textField : flash.text:TextField
TextInput 組件內部文字欄位的參考。 | TextInput | ||
textHeight : Number [唯讀]
文字的高度,以像素為單位。 | TextInput | ||
textSnapshot : flash.text:TextSnapshot [唯讀]
傳回此 DisplayObjectContainer 實體的 TextSnapshot 物件。 | DisplayObjectContainer | ||
textWidth : Number [唯讀]
文字的寬度,以像素為單位。 | TextInput | ||
transform : flash.geom:Transform
這是一個物件,具有和顯示物件的矩陣、顏色轉換和像素邊界有關的屬性。 | DisplayObject | ||
useHandCursor : Boolean
指示當指標滑入 Sprite,且其 buttonMode 屬性設為 true 時,是否要出現指示手掌 (手掌游標) 的 Boolean 值。 | Sprite | ||
visible : Boolean [覆寫]
會取得或設定值,指出目前組件實體是否為可見。 | UIComponent | ||
width : Number [覆寫]
會取得或設定組件的寬度,以像素為單位。 | UIComponent | ||
x : Number [覆寫]
會取得或設定 x 座標,代表組件在其父輩容器內的 x 軸位置。 | UIComponent | ||
y : Number [覆寫]
會取得或設定 y 座標,代表組件在其父輩容器內的 y 軸位置。 | UIComponent | ||
z : Number
表示 DisplayObject 實體相對於 3D 父輩容器的 z 座標位置 (沿著 z 軸)。 | DisplayObject |
方法 | 定義自 | ||
---|---|---|---|
建立新的 TextInput 組件實體。 | TextInput | ||
將 DisplayObject 子實體加入至此 DisplayObjectContainer 實體。 | DisplayObjectContainer | ||
將 DisplayObject 子實體加入至此 DisplayObjectContainer 實體。 | DisplayObjectContainer | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
會在 EventDispatcher 物件註冊事件偵聽程式,以便讓偵聽程式收到事件的通知。 | EventDispatcher | ||
在 TextArea 包含的最後一個字元之後附加指定字串。 | TextInput | ||
指出安全性限制是否會造成傳回的清單 (可用指定的 point 點呼叫 DisplayObjectContainer.getObjectsUnderPoint() 方法來取得) 省略任何顯示物件。 | DisplayObjectContainer | ||
從此組件實體刪除某種樣式屬性。 | UIComponent | ||
判斷指定的顯示物件是否為 DisplayObjectContainer 實體的子系,或為實體本身。 | DisplayObjectContainer | ||
會將事件傳送到事件流程。 | EventDispatcher | ||
[覆寫]
會顯示或隱藏此組件上的焦點指示器。 | TextInput | ||
會起始立即繪製作業,而不需像 invalidateNow 一樣使所有項目無效化。 | UIComponent | ||
傳回可定義顯示物件區域 (相對於 targetCoordinateSpace 物件的座標系統) 的矩形。 | DisplayObject | ||
傳回存在於指定索引位置的子顯示物件實體。 | DisplayObjectContainer | ||
傳回具有指定名稱的子顯示物件。 | DisplayObjectContainer | ||
傳回 child DisplayObject 實體的索引位置。 | DisplayObjectContainer | ||
會擷取目前成為焦點的物件。 | UIComponent | ||
會擷取指定之文字行的相關資訊。 | TextInput | ||
傳回位於指定點底下,且屬於此 DisplayObjectContainer 實體之子系 (或孫系,以下類推) 的物件陣列。 | DisplayObjectContainer | ||
根據 targetCoordinateSpace 參數所定義的座標系統,並排除形狀上的任何筆畫,傳回可定義顯示物件邊界的矩形。 | DisplayObject | ||
會擷取在組件樣式查閱鏈中設定的樣式屬性。 | UIComponent | ||
[靜態]
會擷取目前組件的預設樣式對應。 | TextInput | ||
將 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 | ||
會設定在成為焦點之文字區域內所選取的範圍。 | TextInput | ||
會將組件設定為指定的寬度和高度。 | 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 | |||
當使用者輸入變更 TextInput 組件中的文字時傳送。 | TextInput | |||
當使用者從文字快顯選單中選取「清除」(或「刪除」) 時傳送。 | InteractiveObject | |||
會當使用者在相同的 InteractiveObject 上方按下並放開使用者的指向裝置主按鈕時傳送。 | InteractiveObject | |||
當使用者手勢在 AIR 應用程式中觸發與此互動式物件相關聯的快顯選單時傳送。 | InteractiveObject | |||
當使用者針對複製作業啟動平台特有的快速鍵組合或從文字快顯選單中選取「複製」時傳送。 | InteractiveObject | |||
當使用者針對剪下作業啟動平台特有的快速鍵組合或從文字快顯選單中選取「剪下」時傳送。 | InteractiveObject | |||
[廣播事件] 當 Flash Player 或 AIR 應用程式失去作業系統焦點並成為非作用中時傳送。 | EventDispatcher | |||
在 InteractiveObject 物件的 doubleClickEnabled 旗標設為 true 的情況下,當使用者在相同的物件上方連續兩次快速按下並放開指標裝置主要按鈕時傳送。 | InteractiveObject | |||
當使用者按下 Enter 鍵時傳送。 | TextInput | |||
[廣播事件] 當播放磁頭進入新影格時傳送。 | 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 | |||
當使用者針對全選作業啟動平台特有的快速鍵組合或從文字快顯選單中選取「全選」時傳送。 | InteractiveObject | |||
在組件的可見性從隱藏變更為可見之後傳送。 | UIComponent | |||
升起顯示軟體鍵盤之後立即傳送。 | InteractiveObject | |||
升起顯示軟體鍵盤前立即傳送。 | InteractiveObject | |||
降下隱藏軟體鍵盤之後立即傳送。 | InteractiveObject | |||
在物件的 tabChildren 旗標值變更時傳送。 | InteractiveObject | |||
在物件的 tabEnabled 旗標變更時傳送。 | InteractiveObject | |||
在物件的 tabIndex 屬性值變更時傳送。 | InteractiveObject | |||
當使用者輸入文字時傳送。 | TextInput | |||
當使用者在第一次接觸觸控裝置後傳送 (例如手指觸摸行動電話或平板電腦的觸控螢幕)。 | 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 當 TextInput 組件的 enabled 屬性是設為 false 時,用來作為此組件背景的類別名稱。
預設值為 TextInput_disabledSkin 。 | TextInput | ||
類型: 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 。 | TextInput | ||
類型: 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 用於讓組件邊框和文字保持一段距離的邊框距離,以像素為單位。 預設值為 0 。 | TextInput | ||
upSkin | 類型: Class 語言版本: ActionScript 3.0 產品版本: Flash CS3 執行階段版本: Flash9.0.28.0, AIR 1.0 用來作為 TextInput 組件背景的類別名稱。 預設值為 TextInput_upSkin 。 | TextInput |
alwaysShowSelection | 屬性 |
alwaysShowSelection:Boolean
語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會取得或設定 Boolean 值,指出當文字欄位未成為焦點時,顯示選取範圍的方式。
當這個值設定為 true
而且文字欄位並非焦點時,Flash Player 會將文字欄位中的選取範圍反白標示為灰色。 當這個值設定為 false
而且文字欄位並非焦點時,Flash Player 便會反白標示文字欄位中的選取範圍。
預設值為 false。
實作
public function get alwaysShowSelection():Boolean
public function set alwaysShowSelection(value:Boolean):void
範例 ( 如何使用本範例 )
setSelection()
方法選取一些文字:
import fl.controls.TextInput; var myTextInput:TextInput = new TextInput(); myTextInput.text = "The quick brown fox jumped over the lazy dog."; myTextInput.alwaysShowSelection = true; myTextInput.setSelection(16, 19); myTextInput.move(10, 10); addChild(myTextInput);
condenseWhite | 屬性 |
condenseWhite:Boolean
語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會取得或設定 Boolean 值,指出是否從含有 HTML 文字的 TextInput 組件移除額外的空白字元。 組件中額外空白字元的範例包括空白和斷行符號。 值為 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 元素
displayAsPassword | 屬性 |
displayAsPassword:Boolean
語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會取得或設定 Boolean 值,指出目前 TextInput 組件實體是為了包含密碼,或為了包含文字而建立。 值為 true
表示組件實體是密碼文字欄位;值為 false
則表示組件實體是一般文字欄位。
當此屬性設定為 true
時,TextInput 組件實體會將使用者輸入文字欄位中的每一個字元顯示為星號。 此外,還會停用「剪下」和「複製」命令及其鍵盤快速鍵。 這些措施可以防止他人在電腦無人看管的情況下取得密碼。
預設值為 false。
實作
public function get displayAsPassword():Boolean
public function set displayAsPassword(value:Boolean):void
相關 API 元素
範例 ( 如何使用本範例 )
displayAsPassword
屬性設為 true
,另一個則設為 false
:
import fl.controls.Label; import fl.controls.TextInput; var usernameLabel:Label = new Label(); usernameLabel.text = "User name:"; usernameLabel.move(10, 10); addChild(usernameLabel); var usernameTextInput:TextInput = new TextInput(); usernameTextInput.move(90, 10); addChild(usernameTextInput); var passwordLabel:Label = new Label(); passwordLabel.text = "Password:"; passwordLabel.move(10, 40); addChild(passwordLabel); var passwordTextInput:TextInput = new TextInput(); passwordTextInput.displayAsPassword = true; passwordTextInput.move(90, 40); addChild(passwordTextInput);
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
horizontalScrollPosition | 屬性 |
horizontalScrollPosition:int
語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會取得或設定水平捲軸的縮圖位置。
預設值為 0。
實作
public function get horizontalScrollPosition():int
public function set horizontalScrollPosition(value:int):void
相關 API 元素
範例 ( 如何使用本範例 )
horizontalScrollPosition
和 maxHorizontalScrollPosition
屬性目前的值:
import fl.controls.Label; import fl.controls.Slider; import fl.controls.TextInput; import fl.events.SliderEvent; var myTextInput:TextInput = new TextInput(); myTextInput.text = "The quick brown fox jumped over the lazy dog."; myTextInput.width = 120; myTextInput.move(10, 10); myTextInput.addEventListener(Event.CHANGE, textInputChangeHandler); myTextInput.textField.addEventListener(Event.SCROLL, scrollHandler); addChild(myTextInput); var mySlider:Slider = new Slider(); mySlider.snapInterval = 1; mySlider.tickInterval = 10; mySlider.minimum = 0; mySlider.maximum = myTextInput.maxHorizontalScrollPosition; mySlider.value = myTextInput.horizontalScrollPosition; mySlider.liveDragging = true; mySlider.addEventListener(SliderEvent.CHANGE, sliderChangeHandler); mySlider.width = 120; mySlider.move(10, 40); addChild(mySlider); var myLabel:Label = new Label(); myLabel.autoSize = TextFieldAutoSize.LEFT; myLabel.text = ""; myLabel.move(10, 50); addChild(myLabel); getScrollPosition(); function getScrollPosition():void { myTextInput.drawNow(); var scrollPos:uint = myTextInput.horizontalScrollPosition; var maxScrollPos:uint = myTextInput.maxHorizontalScrollPosition; myLabel.text = "scrollPosition: " + scrollPos + " of " + maxScrollPos; mySlider.value = scrollPos; mySlider.maximum = maxScrollPos; } function scrollHandler(event:Event):void { getScrollPosition(); } function sliderChangeHandler(event:SliderEvent):void { myTextInput.horizontalScrollPosition = event.value; getScrollPosition(); } function textInputChangeHandler(event:Event):void { getScrollPosition(); }
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 元素
範例 ( 如何使用本範例 )
htmlText
屬性以套用 HTML 格式至文字欄位的文字:
import fl.controls.TextInput; var myTextInput:TextInput = new TextInput(); myTextInput.editable = false; myTextInput.enabled = false; myTextInput.htmlText = "(<i>auto assigned</i>)"; myTextInput.move(10, 10); addChild(myTextInput);
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
length | 屬性 |
length:int
[唯讀] 語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會取得 TextInput 組件中的字元數。
預設值為 0。
實作
public function get length():int
相關 API 元素
範例 ( 如何使用本範例 )
maxChars
和 restrict
屬性以限制可輸入的字元:
import fl.controls.Label; import fl.controls.TextInput; var myTextInput:TextInput = new TextInput(); myTextInput.restrict = "0-9A-F"; myTextInput.maxChars = 6; myTextInput.move(10, 10); myTextInput.addEventListener(Event.CHANGE, changeHandler); addChild(myTextInput); var myLabel:Label = new Label(); myLabel.autoSize = TextFieldAutoSize.LEFT; myLabel.text = myTextInput.length + " of " + myTextInput.maxChars; myLabel.move(10, 30); addChild(myLabel); function changeHandler(event:Event):void { myLabel.text = myTextInput.length + " of " + myTextInput.maxChars; }
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
和 restrict
屬性以限制可輸入的字元:
import fl.controls.Label; import fl.controls.TextInput; var myTextInput:TextInput = new TextInput(); myTextInput.restrict = "0-9A-F"; myTextInput.maxChars = 6; myTextInput.move(10, 10); myTextInput.addEventListener(Event.CHANGE, changeHandler); addChild(myTextInput); var myLabel:Label = new Label(); myLabel.autoSize = TextFieldAutoSize.LEFT; myLabel.text = myTextInput.length + " of " + myTextInput.maxChars; myLabel.move(10, 30); addChild(myLabel); function changeHandler(event:Event):void { myLabel.text = myTextInput.length + " of " + myTextInput.maxChars; }
maxHorizontalScrollPosition | 屬性 |
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 | 屬性 |
selectionBeginIndex:int
[唯讀] 語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會取得在一個或多個字元的選取範圍中,第一個選取字元的索引值。
所選取字元的索引位置是自文字區域中出現的第一個字元起,從零開始計算。 如果沒有選取範圍,這個值會設定為跳脫字元的位置。
預設值為 0。
實作
public function get selectionBeginIndex():int
相關 API 元素
範例 ( 如何使用本範例 )
selectionBeginIndex
和 selectionEndIndex
屬性。 此範例也會建立兩個 Slider 組件實體,它們可以使用 setSelection()
方法以程式設計方式設定選取範圍開始索引和結束索引:
import fl.controls.Label; import fl.controls.Slider; import fl.controls.TextInput; import fl.events.SliderEvent; var myTextInput:TextInput = new TextInput(); myTextInput.alwaysShowSelection = true; myTextInput.text = "The quick brown fox jumped over the lazy dog."; myTextInput.width = 120; myTextInput.move(10, 10); myTextInput.addEventListener(Event.CHANGE, changeHandler); myTextInput.addEventListener(FocusEvent.FOCUS_IN, focusInHandler); myTextInput.addEventListener(FocusEvent.FOCUS_OUT, focusOutHandler); addChild(myTextInput); var myLabel:Label = new Label(); myLabel.autoSize = TextFieldAutoSize.LEFT; myLabel.text = ""; myLabel.move(10, 30); addChild(myLabel); var beginSlider:Slider = new Slider(); beginSlider.maximum = myTextInput.length; beginSlider.snapInterval = 1; beginSlider.liveDragging = true; beginSlider.width = 120; beginSlider.move(10, 65); beginSlider.addEventListener(SliderEvent.CHANGE, beginChangeHandler); addChild(beginSlider); var endSlider:Slider = new Slider(); endSlider.maximum = myTextInput.length; endSlider.snapInterval = 1; endSlider.liveDragging = true; endSlider.width = 120; endSlider.move(10, 85); endSlider.addEventListener(SliderEvent.CHANGE, endChangeHandler); addChild(endSlider); var t:Timer = new Timer(50); t.addEventListener(TimerEvent.TIMER, timerHandler); function changeHandler(event:Event):void { beginSlider.maximum = myTextInput.length; endSlider.maximum = myTextInput.length; updateUI(); } function focusInHandler(event:FocusEvent):void { t.start(); } function focusOutHandler(event:FocusEvent):void { t.stop(); } function beginChangeHandler(event:SliderEvent):void { myTextInput.setSelection(event.value, myTextInput.selectionEndIndex); updateUI(); } function endChangeHandler(event:SliderEvent):void { myTextInput.setSelection(myTextInput.selectionBeginIndex, event.value); updateUI(); } function timerHandler(event:TimerEvent):void { updateUI(); } function updateUI():void { myLabel.text = "selectionBeginIndex:" + myTextInput.selectionBeginIndex + "\n"; myLabel.text += "selectionEndIndex:" + myTextInput.selectionEndIndex; beginSlider.value = myTextInput.selectionBeginIndex; endSlider.value = myTextInput.selectionEndIndex; }
selectionEndIndex | 屬性 |
text | 屬性 |
textField | 屬性 |
public var textField:flash.text:TextField
語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
TextInput 組件內部文字欄位的參考。
範例 ( 如何使用本範例 )
textField
屬性存取基本的原生 ActionScript TextField 物件,和呼叫其 replaceText()
方法:
import fl.controls.TextInput; var myTextInput:TextInput = new TextInput(); myTextInput.text = "The quick brown fox jumped over the lazy dog."; myTextInput.textField.replaceText(41, 44, "fox"); myTextInput.textField.replaceText(16, 19, "dog"); addChild(myTextInput);
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 元素
範例 ( 如何使用本範例 )
textWidth
和 textHeight
屬性:
import fl.controls.TextInput; var myTextInput:TextInput = new TextInput(); myTextInput.move(10, 10); myTextInput.addEventListener(Event.CHANGE, changeHandler); addChild(myTextInput); function changeHandler(event:Event):void { trace("textWidth:" + myTextInput.textWidth + ", textHeight:" + myTextInput.textHeight); }
TextInput | () | 建構函式 |
public function TextInput()
語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
建立新的 TextInput 組件實體。
appendText | () | 方法 |
drawFocus | () | 方法 |
getLineMetrics | () | 方法 |
public function getLineMetrics(index:int):flash.text:TextLineMetrics
語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會擷取指定之文字行的相關資訊。
參數
index:int — 要擷取其資訊的行號。
|
flash.text:TextLineMetrics |
範例 ( 如何使用本範例 )
var format:TextFormat = new TextFormat(); format.size = 72; format.font = "Georgia"; import fl.controls.TextInput; var ti:TextInput = new TextInput(); addChild(ti); ti.setSize(393,82); ti.move(10,10); ti.setStyle("textFormat",format); ti.text = "Hello World"; ti.drawNow(); var metrics:TextLineMetrics = ti.getLineMetrics(0); var ascenderColoring:Shape = new Shape(); var descenderColoring:Shape = new Shape(); ti.addChild(ascenderColoring); ti.addChild(descenderColoring); ascenderColoring.graphics.clear(); ascenderColoring.graphics.beginFill(0xFF0000,0.2); ascenderColoring.graphics.drawRect(0, 0, metrics.width, metrics.ascent); descenderColoring.graphics.clear(); descenderColoring.graphics.beginFill(0x0000FF,0.2); descenderColoring.graphics.drawRect(0, metrics.ascent + 2, metrics.width, metrics.descent);
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(beginIndex:int, endIndex:int):void
語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
會設定在成為焦點之文字區域內所選取的範圍。 選取範圍是從 start 參數指定的索引起始,而在 end 參數指定的索引結束。 如果指定選取範圍的參數值相同,此方法便會以與 caretIndex
屬性相同的方式,設定文字插入點。
選取的文字視同從零開始的字元字串,其中的第一個選取字元位於索引 0、第二字元位於索引 1,依此類推。
如果文字欄位未成為焦點,此方法即無效果。
參數
beginIndex:int — 選取範圍中第一個字元的索引位置。
| |
endIndex:int — 選取範圍中最後一個字元的索引位置。
|
相關 API 元素
範例 ( 如何使用本範例 )
import fl.controls.TextInput; var ti:TextInput = new TextInput(); addChild(ti); ti.text = "Hello World"; ti.setFocus(); ti.setSelection(6, 11);
setSelection()
方法選取一些文字:
import fl.controls.TextInput; var myTextInput:TextInput = new TextInput(); myTextInput.text = "The quick brown fox jumped over the lazy dog."; myTextInput.alwaysShowSelection = true; myTextInput.setSelection(16, 19); myTextInput.move(10, 10); addChild(myTextInput);
change | 事件 |
flash.events.Event
屬性 Event.type =
flash.events.Event.CHANGE
語言版本: | ActionScript 3.0 |
產品版本: | Flash CS3 |
執行階段版本: | Flash Player 9.0.28.0, AIR 1.0 |
當使用者輸入變更 TextInput 組件中的文字時傳送。
注意:如果是使用 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 屬性,存取目前正在偵聽該事件的物件。 |
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 | 由使用者所輸入的字元或字元序列。 |
- 將 TextInput、Label 和 Button 組件加入元件庫。
- 將這個程式碼儲存成 TextInputExample.as,並與您的 FLA 存放在相同的目錄中。
- 將 FLA 中的 DocumentClass 設定為 TextInputExample。
package { import flash.display.Sprite; import flash.events.MouseEvent; import flash.events.Event; import fl.controls.TextInput; import fl.controls.Label; import fl.controls.Button; public class TextInputExample extends Sprite { private var ti1:TextInput; private var ti2:TextInput; private var label1:Label; private var label2:Label; private var submitBtn:Button; public function TextInputExample() { setupLabels(); setupInputFields(); setupButton(); } private function setupInputFields():void { ti1 = new TextInput(); ti2 = new TextInput(); ti1.move(50,10); ti2.move(50,40); ti2.displayAsPassword = true; ti1.addEventListener(Event.CHANGE, textEntered); ti2.addEventListener(Event.CHANGE, textEntered); addChild(ti1); addChild(ti2); } private function setupLabels():void { label1 = new Label(); label2 = new Label(); label1.move(10,10); label2.move(10,40); label1.text = "User:"; label2.text = "Pass:" addChild(label1); addChild(label2); } private function setupButton():void { submitBtn = new Button(); submitBtn.move(150,70); submitBtn.label = "Go"; submitBtn.enabled = false; submitBtn.setSize(50,20); submitBtn.addEventListener(MouseEvent.CLICK, submitLogin); addChild(submitBtn); } private function textEntered(e:Event):void { if(ti1.text != "" && ti2.text != "") { submitBtn.enabled = true; } else { submitBtn.enabled = false; } } private function submitLogin(e:MouseEvent):void { var submitLabel:Label = new Label(); submitLabel.move(10,70); submitLabel.autoSize = "left"; submitLabel.text = "Login has been submitted." addChild(submitLabel); submitBtn.removeEventListener(MouseEvent.CLICK, submitLogin); } } }
Tue Jun 12 2018, 03:47 PM Z