套件 | flash.text |
類別 | public final class StageText |
繼承 | StageText EventDispatcher Object |
語言版本: | ActionScript 3.0 |
執行階段版本: | AIR 3 |
這個類別可讓行動應用程式收集行動裝置上使用原生文字輸入控制項的使用者輸入。行動裝置上的輸入控制項通常具有廣泛的使用者介面,以及桌上型電腦所沒有的支援行為。例如,許多行動裝置都支援如下的文字輸入功能:
- 自動完成
- 自動更正
- 觸碰式文字選取
- 可自訂的軟體鍵盤
基本的作業系統 (或作業系統隨附的組件庫) 會繪製原生文字輸入欄位。原生文字輸入欄位可為任何曾經在相同裝置上使用其他應用程式的人員,提供類似的體驗。不過,因為作業系統會繪製文字輸入欄位,而非播放程式,所以,「您無法使用內嵌的字體」。
AIR 描述檔支援:iOS 和 Android 平台支援此項功能。StageText 會在 Android 和 iOS 行動裝置上使用原生文字輸入欄位。在其他平台上,StageText 則使用 Flash Runtime TextField。
使用原生輸入時,StageText 物件不是顯示物件,無法加入 Flash 顯示清單中。您必須改為使用 stage
屬性,將 StageText 物件直接附加至舞台來顯示。附加至舞台的 StageText 實體將顯示在任何 Flash 顯示物件的上方。您可以使用 viewPort
屬性,控制顯示區域的大小與位置。您無法控制不同 StageText 物件的深度順序。不建議重疊兩個實體。
當 StageText 物件有焦點時,會有第一個機會來處理鍵盤輸入。附加 StageText 物件的舞台不會傳送任何鍵盤輸入事件。
由於 StageText 類別會包覆每個平台上的不同原生控制項,其功能的受支援程度也取決於每個平台。功能受到支援的話,在平台之間的行為會有所不同。嘗試在特定平台使用特定功能時,最好先測試行為。只有在未使用原生控制項的桌面平台上,StageText 行為才會類似於 Flash Runtime 文字行為。
Apple TV 上的 StageText 預設會取得焦點。若要在應用程式中管理不同物件之間的焦點,請記得下列要點:
- 若要覆寫來自 StageText 的預設焦點,或若要指派焦點到任何其他顯示物件,請使用 stage.focus
- 若要指派焦點到 StageText,請使用 stageText.assignFocus()
屬性 | 定義自 | ||
---|---|---|---|
autoCapitalize : String
控制裝置如何將自動大寫套用到使用者輸入。 | StageText | ||
autoCorrect : Boolean
指出裝置是否自動更正拼字或標點符號錯誤的使用者輸入。 | StageText | ||
clearButtonMode : String [唯寫]
目前 StageText 物件的 clearButton 模式。 | StageText | ||
color : uint
指定文字顏色。 | StageText | ||
constructor : Object
類別物件的參照或是特定物件實體的建構函數。 | Object | ||
displayAsPassword : Boolean
指出文字欄位是否為密碼文字欄位。 | StageText | ||
editable : Boolean
指出使用者是否可以編輯文字欄位。 | StageText | ||
fontFamily : String
指出目前字體系列的名稱。 | StageText | ||
fontPosture : String
使用 FontPosture 類別中定義的常數指定字體型態。 | StageText | ||
fontSize : int
目前字體系列的大小,以像素為單位。 | StageText | ||
fontWeight : String
使用 FontWeight 類別中定義的常數指定字體粗細。 | StageText | ||
locale : String
指出文字的地區設定。 | StageText | ||
maxChars : int
指出使用者能夠輸入文字欄位中的字元上限。 | StageText | ||
multiline : Boolean [唯讀]
指出 StageText 物件是否可以顯示一行以上的文字。 | StageText | ||
restrict : String
限制使用者能夠輸入文字欄位中的字元組。 | StageText | ||
returnKeyLabel : String
指出以軟體鍵盤為特色的裝置 Return 鍵上的標籤 | StageText | ||
selectionActiveIndex : int [唯讀]
目前選取範圍中,最後一個字元的字元索引值 (從零開始)。 | StageText | ||
selectionAnchorIndex : int [唯讀]
目前選取範圍中,第一個字元的字元索引值 (從零開始)。 | StageText | ||
softKeyboardType : String
控制軟體鍵盤的外觀。 | StageText | ||
stage : Stage
顯示此 StageText 物件所在的舞台。 | StageText | ||
text : String
文字欄位中的目前文字。 | StageText | ||
textAlign : String
指出段落對齊方式。 | StageText | ||
viewPort : Rectangle
顯示此 StageText 物件所在舞台上的區域。 | StageText | ||
visible : Boolean
指出 StageText 物件是否為可見。 | StageText |
方法 | 定義自 | ||
---|---|---|---|
建立 StageText 物件。 | StageText | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
會在 EventDispatcher 物件註冊事件偵聽程式,以便讓偵聽程式收到事件的通知。 | EventDispatcher | ||
將焦點指定給 StageText 物件。 | StageText | ||
會將事件傳送到事件流程。 | EventDispatcher | ||
釋放 StageText 物件。 | StageText | ||
繪製 StageText 檢視連接埠的點陣圖。 | StageText | ||
會檢查 EventDispatcher 物件是否有對特定的事件類型註冊偵聽程式。 | EventDispatcher | ||
指出物件是否有已定義的指定屬性。 | Object | ||
指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。 | Object | ||
指出指定的屬性是否存在,以及是否可列舉。 | Object | ||
會從 EventDispatcher 物件移除偵聽程式。 | EventDispatcher | ||
選取由第一個和最後一個字元的索引值所指定的文字。 | StageText | ||
為迴圈作業設定動態屬性的可用性。 | Object | ||
傳回代表此物件的字串,根據地區特定慣例進行格式化。 | Object | ||
會傳回指定之物件的字串形式。 | Object | ||
會傳回指定之物件的基本值。 | Object | ||
檢查此 EventDispatcher 物件是否已註冊事件偵聽程式,或者此物件的任何祖系已為特定事件類型註冊事件偵聽程式。 | EventDispatcher |
事件 | 摘要 | 定義自 | ||
---|---|---|---|---|
[廣播事件] 當 Flash Player 或 AIR 應用程式取得作業系統焦點並成為作用中時傳送。 | EventDispatcher | |||
在文字內容變更之後傳送。 | StageText | |||
在設定非 null 舞台及非空白檢視區域之後傳送。 | StageText | |||
[廣播事件] 當 Flash Player 或 AIR 應用程式失去作業系統焦點並成為非作用中時傳送。 | EventDispatcher | |||
在使用者正在編輯文字,控制項具有鍵盤焦點時傳送。 | StageText | |||
在使用者不再編輯文字,控制項不再具有鍵盤焦點時傳送。 | StageText | |||
會當使用者按下按鍵時傳送。 | StageText | |||
會當使用者放開按鍵時傳送。 | StageText | |||
在 StageText 物件取得焦點而啟用軟體鍵盤之後傳送。 | StageText | |||
在 StageText 物件取得焦點而啟用軟體鍵盤之前傳送。 | StageText | |||
在 StageText 物件失去焦點而停用軟體鍵盤之後傳送。 | StageText |
autoCapitalize | 屬性 |
autoCapitalize:String
語言版本: | ActionScript 3.0 |
執行階段版本: | AIR 3 |
控制裝置如何將自動大寫套用到使用者輸入。有效值定義為 AutoCapitalize 類別的常數:
- "none"
- "word"
- "sentence"
- "all"
這個屬性只是基本平台的提示,因為並非所有的裝置和作業系統都支援此項功能。
注意:若您在編輯文字或者文字在焦點中時啟用 autoCapitalize
,則要等到焦點釋放並重新建立之後才會套用更新的行為。
預設值為 AutoCapitalize.NONE。
實作
public function get autoCapitalize():String
public function set autoCapitalize(value:String):void
擲回值
ArgumentError — 如果設為不屬於 AutoCapitalize 成員的任何一個值
|
相關 API 元素
autoCorrect | 屬性 |
clearButtonMode | 屬性 |
clearButtonMode:String
[唯寫] 語言版本: | ActionScript 3.0 |
執行階段版本: | AIR 23 |
目前 StageText 物件的 clearButton 模式。這個屬性有四個相關聯的模式:
-
編輯時顯示 clearButton:
StageTextClearButtonMode.WHILE_EDITING
-
絕不顯示 clearButton:
StageTextClearButtonMode.NEVER
-
永遠顯示 clearButton:
StageTextClearButtonMode.ALWAYS
-
編輯時不顯示 clearButton:
StageTextClearButtonMode.UNLESS_EDITING
clearButtonMode
屬性設定為 StageTextClearButtonMode.WHILE_EDITING
。
注意:只有 iOS 支援這個屬性。
實作
public function set clearButtonMode(value:String):void
color | 屬性 |
displayAsPassword | 屬性 |
displayAsPassword:Boolean
語言版本: | ActionScript 3.0 |
執行階段版本: | AIR 3 |
指出文字欄位是否為密碼文字欄位。如果為 true
,則文字欄位會隱藏使用替代字元 (例如星號) 的輸入字元。
注意:若您在編輯文字或者文字在焦點中時啟用 displayAsPassword
,則要等到焦點釋放並重新建立之後才會套用更新的行為。
重要:在 iOS 上,當此屬性的值為 true
時,多行舞台文字物件不會顯示替代字元。
預設值為 false。
實作
public function get displayAsPassword():Boolean
public function set displayAsPassword(value:Boolean):void
editable | 屬性 |
fontFamily | 屬性 |
fontPosture | 屬性 |
fontPosture:String
語言版本: | ActionScript 3.0 |
執行階段版本: | AIR 3 |
使用 FontPosture 類別中定義的常數指定字體型態。
預設值為 FontPosture.NORMAL。
實作
public function get fontPosture():String
public function set fontPosture(value:String):void
擲回值
ArgumentError — 如果設為不屬於 FontPosture 成員的任何一個值
|
相關 API 元素
fontSize | 屬性 |
fontWeight | 屬性 |
fontWeight:String
語言版本: | ActionScript 3.0 |
執行階段版本: | AIR 3 |
使用 FontWeight 類別中定義的常數指定字體粗細。
預設值為 FontWeight.NORMAL。
實作
public function get fontWeight():String
public function set fontWeight(value:String):void
擲回值
ArgumentError — 如果設為不屬於 FontWeight 成員的任何一個值
|
相關 API 元素
locale | 屬性 |
locale:String
語言版本: | ActionScript 3.0 |
執行階段版本: | AIR 3 |
指出文字的地區設定。StageText 會使用標準地區設定識別碼例如,「en」、「en_US」和「en-US」都是代表英文,而「ja」則是日文。請參閱 iso639-2 code list 取得地區代碼清單。
預設值為 en。
實作
public function get locale():String
public function set locale(value:String):void
maxChars | 屬性 |
multiline | 屬性 |
restrict | 屬性 |
restrict:String
語言版本: | ActionScript 3.0 |
執行階段版本: | AIR 3 |
限制使用者能夠輸入文字欄位中的字元組。系統會從左至右掃描 restrict
字串。
restrict
的值會指定下列文字輸入限制規則:
- 如果值為
null
,使用者可以輸入任何字元。 - 如果值是空白字串,使用者便無法輸入任何字元。
- 如果值是字元字串,使用者只能輸入字串中的字元。
- 如果值包含跳脫字元 (^),使用者無法輸入接在跳脫字元後面的任何字元。
- 透過使用連字符號 (-) 字元,值可以指定可允許的輸入字元範圍。
- 值可以使用
\u
逸出序列建構restrict
字串。
特殊字元:
使用反斜線可以逐字輸入跳脫字元 (^) 或虛線 (-) 字元。接受的反斜線序列為 \-、\^ 和 \\。反斜線必須是字串中的實際字元。當您在 ActionScript 指定反斜線時,請使用雙反斜線。
restrict
屬性設定範例:
下列範例可讓使用者只輸入虛線 (-) 和跳脫 (^) 字元:
my_txt.restrict = "\\-\\^";
下列範例可讓使用者只輸入大寫字元、空格和數字:
my_txt.restrict = "A-Z 0-9";
下列範例可只排除小寫字母:
my_txt.restrict = "^a-z";
下列範例可讓使用者只輸入大寫字母,但排除小寫字母 Q:
my_txt.restrict = "A-Z^Q";
下列範例可讓使用者只輸入從 ASCII 32 (空格) 到 ASCII 126 ("~" 符號) 的字元。
my_txt.restrict = "\u0020-\u007E";
注意:限制僅適用於使用者輸入;掃描可以將任何字元插入文字欄位。
預設值為 null。
實作
public function get restrict():String
public function set restrict(value:String):void
returnKeyLabel | 屬性 |
returnKeyLabel:String
語言版本: | ActionScript 3.0 |
執行階段版本: | AIR 3 |
指出以軟體鍵盤為特色的裝置 Return 鍵上的標籤可用的值包括 ReturnKeyLabel
類別中定義的常數:
- "default"
- "done"
- "go"
- "next"
- "search"
這個屬性只是基本平台的提示,因為並非所有的裝置和作業系統都支援這些值。這個屬性在沒有軟體鍵盤的裝置上不會發揮作用。
預設值為 ReturnKeyLabel.DEFAULT。
實作
public function get returnKeyLabel():String
public function set returnKeyLabel(value:String):void
擲回值
ArgumentError — 如果設為不屬於 ReturnKeyLabel 成員的任何一個值
|
相關 API 元素
selectionActiveIndex | 屬性 |
selectionAnchorIndex | 屬性 |
softKeyboardType | 屬性 |
softKeyboardType:String
語言版本: | ActionScript 3.0 |
執行階段版本: | AIR 3 |
控制軟體鍵盤的外觀。
具備軟體鍵盤的裝置可以自訂鍵盤按鍵,以符合所需的輸入類型。例如,如果需要數值輸入,裝置可以使用 SoftKeyboardType.NUMBER
,只顯示軟體鍵盤上的數字。有效值定義為 SoftKeyboardType 類別的常數:
- "default"
- "punctuation"
- "url"
- "number"
- "contact"
- "email"
- "phone"
- "decimalpad"
這些值都是提示,可協助裝置顯示目前操作適用的最佳鍵盤。
預設值為 SoftKeyboardType.DEFAULT。
實作
public function get softKeyboardType():String
public function set softKeyboardType(value:String):void
擲回值
ArgumentError — 如果設為不屬於 SoftKeyboardType 成員的任何一個值
|
相關 API 元素
stage | 屬性 |
text | 屬性 |
textAlign | 屬性 |
textAlign:String
語言版本: | ActionScript 3.0 |
執行階段版本: | AIR 3 |
指出段落對齊方式。有效值定義為 TextFormatAlign 類別的常數。
- "left"
- "center"
- "right"
- "justify"
- "start"
- "end"
並非所有平台都支援每個 textAlign
值。對於不支援的 textAlign
值,平台會使用預設值 (TextFormatAlign.START
)。
預設值為 TextFormatAlign.START。
實作
public function get textAlign():String
public function set textAlign(value:String):void
擲回值
ArgumentError — 如果設為不屬於 TextFormatAlign 成員的任何一個值
|
相關 API 元素
viewPort | 屬性 |
viewPort:Rectangle
語言版本: | ActionScript 3.0 |
執行階段版本: | AIR 3 |
顯示此 StageText 物件所在舞台上的區域。預設為零矩形。
實作
public function get viewPort():Rectangle
public function set viewPort(value:Rectangle):void
擲回值
RangeError — Rectangle 值無效。
|
visible | 屬性 |
StageText | () | 建構函式 |
public function StageText(initOptions:flash.text:StageTextInitOptions = null)
語言版本: | ActionScript 3.0 |
執行階段版本: | AIR 3 |
建立 StageText 物件。
StageText 物件將維持隱藏,直到它附加至舞台並設定 viewPort
屬性為止。
initOptions:flash.text:StageTextInitOptions (default = null )
|
assignFocus | () | 方法 |
public function assignFocus():void
語言版本: | ActionScript 3.0 |
執行階段版本: | AIR 3 |
將焦點指定給 StageText 物件。若是不可編輯的物件,assignFocus()
則不會有何作用。
dispose | () | 方法 |
public function dispose():void
語言版本: | ActionScript 3.0 |
執行階段版本: | AIR 3 |
釋放 StageText 物件。
呼叫 dispose()
為選擇性動作。若不要保留此 StageText 實體的參照,它會進入記憶體回收作業。呼叫 dispose()
會使得記憶體回收更快發生 ,或是在更適合的時間發生。
drawViewPortToBitmapData | () | 方法 |
public function drawViewPortToBitmapData(bitmap:BitmapData):void
語言版本: | ActionScript 3.0 |
執行階段版本: | AIR 3.0 |
繪製 StageText 檢視連接埠的點陣圖。
擷取點陣圖並將舞台設為 null
,以便在 StageText 物件上方顯示內容。
點陣圖的寬度和高度通常與檢視區域相同。從 AIR 15.0 開始,當播放程式在 HiDPI 顯示器顯示時,可以選擇性地將點陣圖的寬度和高度設定為檢視區域寬度和高度的 contentsScaleFactor
倍。例如,在 Mac Retina 顯示器上,由於舞台的像素解析度會加倍,所以 contentsScaleFactor
是 2,因此,點陣圖會是對應於檢視區域大小的兩倍。
如果您在 Event.COMPLETE
事件之前呼叫這個方法,方法可能會錯誤地繪製檢視區域。
參數
bitmap:BitmapData — 繪製 StageText 檢視連接埠可見部分的 BitmapData 物件。
|
擲回值
ArgumentError — 點陣圖的寛度或高度不同於檢視區域的寛度或高度。
| |
Error — 點陣圖為 null。
|
selectRange | () | 方法 |
public function selectRange(anchorIndex:int, activeIndex:int):void
語言版本: | ActionScript 3.0 |
執行階段版本: | AIR 3 |
選取由第一個和最後一個字元的索引值所指定的文字。請利用 anchorIndex
和 activeIndex
參數,指定選取範圍的第一個和最後一個字元。如果兩個參數值都相同,這個方法會設定插入點。
在 iOS 上,這個函數不受非多行 StageText 物件支援,因此永遠都會傳回 -1。如果您呼叫這個方法來選取完整文字字串,就會看到選取範圍。不過,如果您呼叫這個方法來選取文字字串的子集,則不會看到選取範圍。
對於某些裝置或作業系統,只有在 StageText 物件具有焦點時才看得見選取範圍。
參數
anchorIndex:int — 選取範圍中第一個字元的索引值 (從零開始,第一個字元的索引值為 0)。
| |
activeIndex:int — 選取範圍中最後一個字元的索引值 (從零開始)。
|
相關 API 元素
change | 事件 |
flash.events.Event
屬性 Event.type =
flash.events.Event.CHANGE
語言版本: | ActionScript 3.0 |
執行階段版本: | AIR 3 |
在文字內容變更之後傳送。這個事件可以根據每次的變更傳送,也可以在一組變更完成之前都不傳送。
Event.CHANGE
常數會定義 change
事件物件的 type
屬性值。
這個事件具有下列屬性:
屬性 | 值 |
---|---|
bubbles | true |
cancelable | false ;沒有要取消的預設行為指令。 |
currentTarget | 正主動使用事件偵聽程式處理 Event 物件的物件。 |
target | 其值遭到修改的物件。 target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。 |
complete | 事件 |
flash.events.Event
屬性 Event.type =
flash.events.Event.COMPLETE
語言版本: | ActionScript 3.0 |
執行階段版本: | AIR 3 |
在設定非 null 舞台及非空白檢視區域之後傳送。指出實作已在 StageText 物件上完成配置,您現在可以呼叫 drawViewPortToBitmapData
方法。視平台而定,這個事件可能會以同步方式傳送,或者在設定 stage
、viewPort
或兩者之後以非同步方式傳送。
Event.COMPLETE
常數會定義 complete
事件物件的 type
屬性值。
這個事件具有下列屬性:
屬性 | 值 |
---|---|
bubbles | false |
cancelable | false ;沒有要取消的預設行為指令。 |
currentTarget | 正主動使用事件偵聽程式處理 Event 物件的物件。 |
target | 已完成載入的網路物件。 |
focusIn | 事件 |
flash.events.FocusEvent
屬性 FocusEvent.type =
flash.events.FocusEvent.FOCUS_IN
語言版本: | ActionScript 3.0 |
執行階段版本: | AIR 3 |
在使用者正在編輯文字,控制項具有鍵盤焦點時傳送。
定義focusIn
事件物件的 type
屬性值。
這個事件具有下列屬性:
屬性 | 值 |
---|---|
bubbles | true |
cancelable | false ;沒有要取消的預設行為指令。 |
currentTarget | 正主動使用事件偵聽程式處理 Event 物件的物件。 |
keyCode | 0;僅套用至 keyFocusChange 事件。 |
relatedObject | 受到焦點變更影響的互補 InteractiveObject 實體。 |
shiftKey | false ;僅適用於 keyFocusChange 事件。 |
target | 剛成為焦點的 InteractiveObject 實體。 target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。
|
direction | 焦點的指派來源方向。此屬性會報告舞台之 assignFocus() 方法的 direction 參數值。如果是透過其他方式變更焦點,此值將固定為 FocusDirection.NONE 。僅適用於 focusIn 事件。對於其他所有焦點事件,此值將固定為 FocusDirection.NONE 。 |
focusOut | 事件 |
flash.events.FocusEvent
屬性 FocusEvent.type =
flash.events.FocusEvent.FOCUS_OUT
語言版本: | ActionScript 3.0 |
執行階段版本: | AIR 3 |
在使用者不再編輯文字,控制項不再具有鍵盤焦點時傳送。
定義focusOut
事件物件的 type
屬性值。
這個事件具有下列屬性:
屬性 | 值 |
---|---|
bubbles | true |
cancelable | false ;沒有要取消的預設行為指令。 |
currentTarget | 正主動使用事件偵聽程式處理 Event 物件的物件。 |
keyCode | 0;僅套用至 keyFocusChange 事件。 |
relatedObject | 受到焦點變更影響的互補 InteractiveObject 實體。 |
shiftKey | false ;僅適用於 keyFocusChange 事件。 |
target | 剛失去焦點的 InteractiveObject 實體。 target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。
|
keyDown | 事件 |
flash.events.KeyboardEvent
屬性 KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_DOWN
語言版本: | ActionScript 3.0 |
執行階段版本: | AIR 3 |
會當使用者按下按鍵時傳送。
按鍵與特殊字元之間的對應會依裝置與作業系統的不同而改變。 此事件類型會在發生此類對應後,但在輸入法編輯器 (IME) 處理階段前產生。 由於標準的 QWERTY 鍵盤在按鍵配置上不利於輸入 (例如,中文表意文字),人們便使用 IME 來克服這項限制。
此事件會在 keyUp
事件之前發生。
所有按鍵都不會傳送這個事件。是否傳送造成這個事件的按鍵,會依平台而有所不同。
在 AIR 中,取消此事件會禁止在文字欄位中輸入字元。
KeyboardEvent.KEY_DOWN
常數會定義 keyDown
事件物件的 type
屬性值。
這個事件具有下列屬性:
屬性 | 值 |
---|---|
bubbles | true |
cancelable | 在 AIR 中為 true ,在 Flash Player 中為 false ;在 AIR 中,取消這個事件可以阻止字元被輸入到文字欄位。 |
charCode | 按下或放開之按鍵的字元碼值。 |
commandKey | 在 Mac 中,如果 Command 鍵為作用中,則為 true ;否則為 false |
controlKey | 在 Windows 和 Linux 中,如果 Ctrl 鍵為作用中,則為 true ;在 Mac 中,如果 Control 鍵為作用中,則為 true ;否則為 false |
ctrlKey | 在 Windows 和 Linux 中,如果 Ctrl 鍵為作用中,則為 true ;在 Mac 中,如果 Ctrl 鍵或 Command 鍵為作用中,則為 true ;否則為 false 。 |
currentTarget | 正主動使用事件偵聽程式處理 Event 物件的物件。 |
keyCode | 按下或放開之按鍵的按鍵碼值。 |
keyLocation | 鍵盤上的按鍵位置。 |
shiftKey | 如果 Shift 鍵為作用中,則為 true ;若已停用,則為 false 。 |
target | 成為焦點的 InteractiveObject 實體。 target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。 |
keyUp | 事件 |
flash.events.KeyboardEvent
屬性 KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_UP
語言版本: | ActionScript 3.0 |
執行階段版本: | AIR 3 |
會當使用者放開按鍵時傳送。
按鍵與特殊字元之間的對應會依裝置與作業系統的不同而改變。 此事件類型會在發生此類對應後,但在輸入法編輯器 (IME) 處理階段前產生。 由於標準的 QWERTY 鍵盤在按鍵配置上不利於輸入 (例如,中文表意文字),人們便使用 IME 來克服這項限制。
這個事件會在 keyDown
事件之後發生。
所有按鍵都不會傳送這個事件。是否傳送造成這個事件的按鍵,會依平台而有所不同。
KeyboardEvent.KEY_UP
常數會定義 keyUp
事件物件的 type
屬性值。
這個事件具有下列屬性:
屬性 | 值 |
---|---|
bubbles | true |
cancelable | false ;沒有要取消的預設行為指令。 |
charCode | 包含按下或放開之按鍵的字元碼值。 |
commandKey | 在 Mac 中,如果 Command 鍵為作用中,則為 true ;否則為 false |
controlKey | 在 Windows 和 Linux 中,如果 Ctrl 鍵為作用中,則為 true ;在 Mac 中,如果 Control 鍵為作用中,則為 true ;否則為 false |
ctrlKey | 在 Windows 中,如果 Ctrl 鍵為作用中,則為 true ;在 Mac 中,如果 Ctrl 鍵或 Command 鍵為作用中,則為 true ;否則為 false 。 |
currentTarget | 正主動使用事件偵聽程式處理 Event 物件的物件。 |
keyCode | 按下或放開之按鍵的按鍵碼值。 |
keyLocation | 鍵盤上的按鍵位置。 |
shiftKey | 如果 Shift 鍵為作用中,則為 true ;若已停用,則為 false 。 |
target | 成為焦點的 InteractiveObject 實體。 target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。 |
softKeyboardActivate | 事件 |
flash.events.SoftKeyboardEvent
屬性 SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATE
語言版本: | ActionScript 3.0 |
執行階段版本: | AIR 3 |
在 StageText 物件取得焦點而啟用軟體鍵盤之後傳送。
SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATE
常數會在顯示軟體鍵盤時,定義 type
屬性 SoftKeyboardEvent 物件的值。在此事件中,cancellable = false
。
這個事件具有下列屬性:
屬性 | 值 |
---|---|
type | SOFT_KEYBOARD_ACTIVATE |
bubbles | true |
cancelable | false ;沒有要取消的預設行為指令。 |
relatedObjectVal | 與事件相關的顯示清單物件的參照。 |
triggerTypeVal | 指出 keyboard 事件由應用程式或使用者觸發。 |
currentTarget | 正主動使用事件偵聽程式處理 Event 物件的物件。 |
softKeyboardActivating | 事件 |
flash.events.SoftKeyboardEvent
屬性 SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATING
語言版本: | ActionScript 3.0 |
執行階段版本: | AIR 3 |
在 StageText 物件取得焦點而啟用軟體鍵盤之前傳送。
SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATING
常數會在顯示軟體鍵盤之前,定義 type
屬性 SoftKeyboardEvent 物件的值。在此事件中,cancellable = true
。
這個事件具有下列屬性:
屬性 | 值 |
---|---|
type | SOFT_KEYBOARD_ACTIVATING |
bubbles | true |
cancelable | true ,除非事件是由 StageText 物件所傳送。若是 StageText 物件,則事件是不可以取消的。 |
relatedObjectVal | 與事件相關的顯示清單物件的參照。 |
triggerTypeVal | 指出 keyboard 事件由應用程式或使用者觸發。 |
currentTarget | 正主動使用事件偵聽程式處理 Event 物件的物件。 |
softKeyboardDeactivate | 事件 |
flash.events.SoftKeyboardEvent
屬性 SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_DEACTIVATE
語言版本: | ActionScript 3.0 |
執行階段版本: | AIR 3 |
在 StageText 物件失去焦點而停用軟體鍵盤之後傳送。
SoftKeyboardEvent.SOFT_KEYBOARD_DEACTIVATE
常數會在降下隱藏或隱藏軟體鍵盤時,定義 type
屬性 SoftKeyboardEvent 物件的值。在此事件中,cancellable = false
。
這個事件具有下列屬性:
屬性 | 值 |
---|---|
type | SOFT_KEYBOARD_DEACTIVATE |
bubbles | true |
cancelable | false ;沒有要取消的預設行為指令。 |
relatedObjectVal | 與事件相關的顯示清單物件的參照。 |
triggerTypeVal | 指出 keyboard 事件由應用程式或使用者觸發。 |
currentTarget | 正主動使用事件偵聽程式處理 Event 物件的物件。 |
Tue Jun 12 2018, 03:47 PM Z